chance

What is chance?

The Chance npm package is a minimalist generator of random strings, numbers, and other utilities. It is designed to help developers create random data for testing, simulations, and more. The package offers a wide range of functionalities, from generating random names, addresses, and phone numbers to creating random numbers, characters, and even custom random generators.

What are chance's main functionalities?

Basic Random Data Generation

This feature demonstrates how to generate basic random data such as names and integers. The 'name' method generates a random full name, while the 'integer' method generates a random integer within a specified range.

const Chance = require('chance');
const chance = new Chance();

// Generate a random name
console.log(chance.name());

// Generate a random integer
console.log(chance.integer({min: 0, max: 100}));

Advanced Random Data Generation

This feature showcases the generation of more complex data types like addresses and geo-coordinates. The 'address' method returns a random address, and the 'coordinates' method returns a random latitude and longitude pair.

const Chance = require('chance');
const chance = new Chance();

// Generate a random address
console.log(chance.address());

// Generate a random geo-coordinate
console.log(chance.coordinates());

Custom Random Data Generation

This feature illustrates how to create custom random data generators using Chance. In this example, a simple dice roll function is created that returns a random integer between 1 and 6.

const Chance = require('chance');
const chance = new Chance();

// Custom random generator for a dice roll
function diceRoll() {
  return chance.integer({min: 1, max: 6});
}

console.log(diceRoll());

Other packages similar to chance

faker

Faker is a popular alternative to Chance that focuses on generating massive amounts of fake data, especially for testing purposes. It supports a wide range of data types similar to Chance but also includes locales for generating data in specific languages and formats.

random-js

Random-js is a mathematically correct random number generator library for JavaScript. It offers a lower-level approach compared to Chance, providing tools to generate random values using various distributions. It's more suited for simulations and games that require specific random behavior.

README

Chance

Chance - Random generator helper for JavaScript

Homepage: http://chancejs.com

Many more details on http://chancejs.com but this single library can generate random numbers, characters, strings, names, addresses, dice, and pretty much anything else.

It includes the basic building blocks for all these items and is built on top of a Mersenne Twister so it can generate these things with repeatability, if desired.

Usage

Browser

Chance instantiates itself onto the window. This means that in the simplest case you can just include the script tag then use an instance of Chance immediately.

<script src="chance.js"></script>
<script>
    console.log(chance.string());
</script>

More info

Bower

It can also be used with Bower

bower install chance

then in the HTML of your app:

<!-- Load Chance -->
<script type="text/javascript" src="app/bower_components/chance/chance.min.js"></script>
<script>
    // Use Chance immediately!
    alert(chance.string());
</script>

spm

It can also be used with spm.

spm install chance

Component

It can also be used with Component

component install victorquinn/chancejs

then in the HTML of your app:

<!-- Load Chance -->
<script type="text/javascript" src="components/victorquinn-chancejs/chance.js"></script>
<script>
    // Use Chance immediately!
    alert(chance.string());
</script>

Node.js

And it can be used in Node.js.

var Chance = require('chance'),
    chance = new Chance();

// Get a random zip code
chance.zip();

RequireJS

Chance also includes an AMD define so it can be used with RequireJS.

require(['Chance'], function(Chance) {
    // Instantiate
    var chance = new Chance();
       
    // Then just use it:
    var my_random_integer = chance.integer();
});

## Author
### Victor Quinn
[http://victorquinn.com](http://victorquinn.com)

Please feel free to reach out to me if you have any questions or suggestions.

### Contributors

THANK YOU!

project : chancejs repo age : 1 year, 5 months active : 103 days commits : 387 files : 22 authors : 274 Victor Quinn 70.8% 13 Oliver Salzburg 3.4% 13 Tim Petricola 3.4% 11 davmillar 2.8% 5 Michael Cordingley 1.3% 5 Alex DiLiberto 1.3% 5 Matt Klaber 1.3% 4 Avishaan 1.0% 4 Kevin Garnett 1.0% 4 Abhijeet Pawar 1.0% 4 Chris Villarreal 1.0% 3 Alexandr Lozovyuk 0.8% 3 qjcg 0.8% 3 Nicholas Johnson 0.8% 2 xshyamx 0.5% 2 Adam Krebs 0.5% 2 Andreas Koeberle 0.5% 2 Iskren Chernev 0.5% 2 Nathan MacInnes 0.5% 2 Pascal Borreli 0.5% 2 SeeSchloss 0.5% 2 Stefan Penner 0.5% 2 dhilipsiva 0.5% 2 path411 0.5% 2 shyam 0.5% 1 Brian.Barnett 0.3% 1 Johannes Stein 0.3% 1 afc163 0.3% 1 Doug Lawrence 0.3% 1 ddunning 0.3% 1 Dominic Barnes 0.3% 1 flrent 0.3% 1 kkroner 0.3% 1 leesei 0.3% 1 Richard Anaya 0.3% 1 Ryan Tenney 0.3% 1 Samuel Greene 0.3% 1 lkptrzk 0.3% 1 Ng Patrick 0.3%

### Contribute! 

Be a part of this project! You can run the test using the following.
1. Install dependencies from package.json by running `npm install`
2. Install dependencies for testing by running `bower install`
3. Run the test via `npm test`
4. Make some fun new modules!

This project is licensed under the [MIT License](http://en.wikipedia.org/wiki/MIT_License) so feel free to hack away :)

[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/victorquinn/chancejs/trend.png)](https://bitdeli.com/free "Bitdeli Badge")

Proudly written in Washington, D.C.