Orzo NPM | npm.io

orzo

A library for random events like dice rolls and random strings.

Requirements

orzo requires the following to run:

Node.js
npm (usually comes with Node.js)

Usage

orzo is easily installed with npm:

npm install orzo

Then you can load the library into your project with a require:

var orzo = require('orzo');

The orzo object has the following methods:

`orzo.dice({ min: 1, max: 6 })`

Returns a random number between the min and max values.

min is the lowest possible random number (inclusive). (Number, Optional, Default: 1)
max is the highest possible random number (inclusive). (Number, Optional, Default: 6)
return is a random number (Number)

// examples
orzo.dice() // 4
orzo.dice({ max: 20 }) // 13
orzo.dice({ min: -50, max: 50 }); // -12

`orzo.chars({chars: '', len: 10 })`

Returns a random set of characters.

chars is the character set for the random string. (String, Optional, Default: 'abcdefghijklmnopqrstuvwxyzABCDEFGHHIJKLMNOPQRSTUVWXUZ0123456789')
len is the length for the random string. (Number, Optional, Default: 10)
return is a string with random characters. (String)

// examples
orzo.chars() // FBnQPprZw3
orzo.chars({ len: 25, chars: orzo.HEX_CHARACTERS }) // ff0b28ef67d91e04c1b707169

`orzo.uuid()`

Returns a valid UUIDv4.

returns a UUIDv4. (String)

// example
orzo.uuid() // 5287a662-0623-4ff4-8228-3a3b371926a3

`orzo.encode({ input: '', chars: '' })`

Returns a string encoded in a specified base.

input is the input to convert to the different base. (String)
chars is the character set for the new base. (String, Optional, Default: 'abcdefghijklmnopqrstuvwxyzABCDEFGHHIJKLMNOPQRSTUVWXUZ0123456789')
return is a string in the custom base. (String)

// examples

// encode 1999 to base16
orzo.encode({input: 1999, chars: orzo.HEX_CHARACTERS}) // 7cf

// encode 1999 to base62
orzo.encode({input: 1999}) // wf

`orzo.decode({ input: '', chars: '' })`

Returns a string back to base10.

input is the input to convert to base10. (String)
chars the characters used previously to conver the base. (String, Optional, Default: 'abcdefghijklmnopqrstuvwxyzABCDEFGHHIJKLMNOPQRSTUVWXUZ0123456789')
return is a string in base10. (String)

// examples

// decode 7cf from base16 to base10
orzo.decode({input: '7cf', chars: orzo.HEX_CHARACTERS}) // 1999

// decode wf from base62 to base10
orzo.decode({input: 'wf'}) // 1999