nushell/docs/commands/random.md
2020-12-09 06:43:46 +13:00

4.8 KiB

random

Use random to generate random values

bool

  • random bool: Generate a random boolean value

bool Flags

  • -b, --bias <number>: Adjusts the probability of a "true" outcome

bool Examples

> random bool
false
> random bool --bias 0.75
true

dice

  • random dice: Generate a random dice roll

dice Flags

  • d, --dice <integer>: The amount of dice being rolled
  • s, --sides <integer>: The amount of sides a die has

dice Examples

> random dice
4
> random dice -d 10 -s 12
───┬────
 011
 111
 211
 311
 45
 53
 610
 77
 83
 91
───┴────
> random dice --dice 1024 --sides 16 | histogram | sort-by occurrences
────┬───────┬─────────────┬────────────┬──────────────────────────────────────────────────────────────────────────────────────────────────────
 #  │ value │ occurrences │ percentage │ frequency
────┼───────┼─────────────┼────────────┼──────────────────────────────────────────────────────────────────────────────────────────────────────
  0657 │ 75.00%     │ ***************************************************************************
  11259 │ 77.63%     │ *****************************************************************************
  2359 │ 77.63%     │ *****************************************************************************
  31660 │ 78.95%     │ ******************************************************************************
  41361 │ 80.26%     │ ********************************************************************************
  51162 │ 81.58%     │ *********************************************************************************
  6562 │ 81.58%     │ *********************************************************************************
  7962 │ 81.58%     │ *********************************************************************************
  8463 │ 82.89%     │ **********************************************************************************
  9864 │ 84.21%     │ ************************************************************************************
 101065 │ 85.53%     │ *************************************************************************************
 111566 │ 86.84%     │ **************************************************************************************
 121467 │ 88.16%     │ ****************************************************************************************
 13769 │ 90.79%     │ ******************************************************************************************
 14172 │ 94.74%     │ **********************************************************************************************
 15276 │ 100.00%    │ ****************************************************************************************************
────┴───────┴─────────────┴────────────┴──────────────────────────────────────────────────────────────────────────────────────────────────────

uuid

  • random uuid: Generate a random uuid4 string

uuid Examples

> random uuid
8af4de39-acbc-42f0-94d1-7cfad6c01f8b

integer

  • random integer: Generate a random integer

integer Flags

  • m, --min <integer>: The minimum value to generate
  • x, --max <integer>: The maximum value to generate

integer Examples

> random integer
42
> random integer 5000..
8700890823
> random integer ..100
73
> random integer 100000..200000
173400

chars Examples

Generate a random password of length 15

> random chars -l 15
fWBSbE7QtaoJGeo