nanorand

nanorand is a Rust crate, meant for fast, high-level, zero-dependency random number generation.

Examples

use nanorand::{RNG, WyRand};

fn main() {
    let mut rng = WyRand::new();
    println!("Random 64-bit number: {}", rng.generate::<u64>());
}

RNG Implementations

RNG	nanorand type	Output Size	Cryptographically Secure	Speed	Notes	Original Implementation
wyrand	nanohash::WyRand	64 bits (`u64`)	🚫	4 GB/s		https://github.com/lemire/testingRNG/blob/master/source/wyrand.h
Pcg64	nanohash::Pcg64	64 bits (`u64`)	🚫	1 GB/s		https://github.com/rkern/pcg64
ChaCha	nanohash::ChaCha	512 bits (`[u32; 16]`)	✅	90 MB/s (ChaCha8), 40 MB/s (ChaCha20)	Currently only works in Nightly Rust, will work with Stable 1.47 (see rust#74060)	https://cr.yp.to/chacha.htmightlyl

Entropy Sources

Unix-like (Linux, Android, macOS, iOS, FreeBSD, OpenBSD) - first /dev/urandom, else /dev/random, else system time. (#[forbid(unsafe_code)])
Windows - BCryptGenRandom with system-preferred RNG. (#[deny(unsafe_code)])

Feature Flags

std (default) - Enables Rust std lib features, such as seeding from OS entropy sources.
wyrand (default) - Enable the "wyrand" RNG.
pcg64 (default) - Enable the "Pcg64" RNG.
chacha (Nightly-only) - Enable the "ChaCha" RNG.

License

The zlib/libpng License

This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions: