Miss any of our Open RFC calls?Watch the recordings here! »

random-generator-cli

2.4.2 • Public • Published

Random Generator CLI

version Test Master Status Test Dev Status weekly downloads license

Generates and prints a secure random string (and other types) to terminal.

We use a cryptographically secure pseudo random number generator (CSPRNG, using crypto) for all the randomization and not Math.random.

Install

Install the package globally to be able to use it in the terminal.

npm i -g random-generator-cli

Examples

$ random string
LQQF5iTLVEawRGKqs4BN

$ random array
3 7 10 1 2 4 6 8 5 9

$ random number 1 10
9

$ random float
0.24374674185057454423031231272034347057342529296875

$ random boolean
true

$ random pick a b c d e
d

$ random shuffle a b c d e
b d a e c

Usage

After installation, use random <command>, you can use random <command> -h to show help message related to that command, or use random -h to list all the available commands and options.

Commands

Available commands are [string, array, number, float, boolean, pick, shuffle], each of theses commands will be explained next.

string

Prints a random string with given length and type, also has the alias str.

String options:

Option Alias Type Default Description
length l Number 20 String length
type t Number ascii String type (see table below)

And the supported types are:

Type Description Example
ascii (default) Uppercase letters, lowercase letters, and numbers 8AlB9IUu7ptWqkp3tbeQ
letters Uppercase letters and lowercase letters pPOzEvraFpVFJgCXPdXR
numbers Numbers (each character from 0 to 9) 71110932458602457566
extended Same as ascii plus the characters +-_$#/@! fX#InRyripY@+f!Q7o7R
base64 Base 64 string XU0tg2OW43GJCh5IrrX=
hex Hex number (with uppercase and lowercase characters) 7bCCB51BEb9bDd61f6af

Examples

$ random string -c 2
vDboPtnabvsuEztusNAl
YMasHVICXbbQxCLVMMuF

$ random string -l 15 -c 3 -t numbers
366208018712690
991841686515201
575580372097167

$ random str -t extendedarray 15 --pad
14 11 12 15 13 03 08 07 05 06 02 01 09 04 10
zrk+MQP$_j5pWUWxBV!m

array [length]

Prints a shuffled array that starts at 1 by default, also accepts optional length argument that defaults to 10, and has the alias arr.

Note: the flag -0 can be used to indicate that the array should start at 0.

Array options:

Option Alias Type Default Description
start s Number 1 Array starting position, overrides -0 if both are provided
end e Number - Array ending, overrides length
delimiter d String ' ' The delimiter that is printed between array numbers

Array flags:

Flag Alias Default Description
startAtZero 0 false Array elements start at 0, equivalent to -s 0
pad - false Add zero-padding to small number, so all number have the same length

Examples:

$ random array
3 9 2 6 4 1 10 7 8 5

$ random array 5
4 1 5 3 2

$ random array 5 -0
2 0 4 1 3

$ random arr 5 -s 5
5 6 8 9 7

$ random arr -s 5 -e 10
5 9 6 10 7 8

$ random arr 5 -d ', '
4, 2, 5, 3, 1

$ random array 15 --pad
14 11 12 15 13 03 08 07 05 06 02 01 09 04 10

$ random array 5 --pad
1 2 5 4 3

number <min> <max>

Prints a random number between min and max, also has the aliases: [num, integer, int].

Example

$ random number 1 20
17

$ random num 0 5
3

$ random int 100 1000
240

float

Prints a float number between 0 (inclusive) and 1 (exclusive).

Float options:

Option Alias Type Default Description
precision p Number 10 The desired precision of the floating point number

Example

$ random float
0.24374674185057454423031231272034347057342529296875

$ random float -p 5
0.62194

boolean

Prints a random boolean, has the alias bool.

Boolean options:

Option Alias Type Default Description
type t String true-false Boolean type, types are listed in the table below

Boolean types:

Type Possible values Example
true-false (default) [true, false] true
yes-no [yes, no] no
numeric [1, 0] 1

Example

$ random boolean
false

$ random boolean
true

pick <items..>

Prints a random item(s) from the given items

Boolean options:

Option Alias Type Default Description
number n Number 1 The number of items to chose, without repetition
delimiter d String ' ' Delimiter that separates the chosen items

Example

$ random pick a1 a2 a3 a4
a3

$ random pick a1 a2 a3 a4 -n 2
a4 a2

$ random pick a1 a2 a3 a4 -n 2 -d ', '
a2, a3

shuffle <items..>

Shuffles the given array of items

Boolean options:

Option Alias Type Default Description
delimiter d String ' ' Delimiter that separates the shuffled items

Example

$ random shuffle a1 a2 a3 a4
a2 a3 a4 a1

$ random shuffle a1 a2 a3 a4 -d '|'
a1|a4|a3|a2

Global Options

Option Alias Type Default Description
help h - - Show help message
version v - - Show package version
count c Number 1 Number of generated strings

Feature requests and bug reports

If you have a bug or have a goode idea for a new feature, please open an issue.

Install

npm i random-generator-cli

DownloadsWeekly Downloads

6

Version

2.4.2

License

MIT

Unpacked Size

42.9 kB

Total Files

49

Last publish

Collaborators

  • avatar