block-pseudorand 0.1.2

Generator of random Vec<T>'s for types that can be transmuted from arbitrary bytes.
Documentation

block-pseudorand

This crate allows multi-threaded creation of pseudorandom Vec<T>'s of arbitrary length. It does this by generating arbitrary byte vectors randomly and transmuting to the provided type.

Notes

  • Generated data is not guaranteed to be cryptographically secure
  • Output can be deterministic if you provide a seed
  • This is very unsafe for certain types, see the warning above

Use cases

If you need a lot of random numbers quickly for something non-production critical like unit tests, this may be a good candidate. Otherwise, if you are planning to use this at runtime, or with types that are non-numeric or otherwise cannot be created from arbitrary bytes, I would recommend you to choose another, safer crate.

Usage

If you are certain the above warnings do not apply to the type you are generating, you can use this library like so:

Without Seed

use block_pseudorand::block_rand;

let random_data: Vec<u64> = block_rand(128);

assert_eq!(random_data.len(), 128);

With Seed

use block_pseudorand::block_rand_with_seed;

// Populate this seed as you wish
let seed = [0u8; 32];
let random_data: Vec<u64> = block_rand_with_seed(128, &seed);

assert_eq!(random_data.len(), 128);