___________ _________ .___ \_ _____/____ _________.__./ _____/ ____ ____ __| _/ | __)_\__ \ / ___| | |\_____ \_/ __ \_/ __ \ / __ | | \/ __ \_\___ \ \___ |/ \ ___/\ ___// /_/ | /_______ (____ /____ >/ ____/_______ /\___ >\___ >____ | EasySeed\/ \/ \/ \/ \/ \/ \/ \/
EasySeed is seedable random number generator that utilizes David Bau's seedable random number generator internally(with a few minor changes for Node.js support), and provides an easy interface for seeding and using the generator.
Note: A generator of this nature is only as random as the seed provided.
Simply require, seed, and use.
var easyseed = ;easyseedseed;easyseed;
Before any values can be generated, the generator must be seeded. All seed types are part of the
easyseed.seed namespace.
Seeds the generator with the current data/time. Useful for general purpose pseudo-random numbers.
Seeds the generator with the specified string.
Seeds the generator is the data within the provided buffer.
Makes a request for the specificed web resource and uses the response body as the seed for the generator.
Loads a file, then uses the contents as the seed for the generator.
EasySeed gives you the option to get random integers or floats.
Note: Internally a queue is used to hold generation while seeding is done. This is required since some seeding options require asynchronous operations, such as making HTTP requests or reading files. This means callbacks are required for all generators.
Generates an integer between min and max, 0 and max, or 0-1. The callback is called with the number generated.
//require and seed it...var {console;};easyseed; //0 or 1easyseed; //between 0 and 10easyseed; //between 50 and 100
Same as
easyseed.int, expect a floating point number is returned.
easyseed.float(callback) (no min/max) generates exactly what
Math.random does.
There are a couple events you can subscribe to if needed.
Fires when a request of filesystem error occurs for the corresponding seed functions.
Fires when seeding is complete, and provides the seed string used.
The tests provided simply seed using all the seed functions, then generate 2000 0-1 floats (
Math.random), 2000 floats between 10 and 100, and 2000 integers between 10 and 100. Node.js' Assert is used for validation. Errors are thrown if a request or filesystem error occurs.
node test.js