nanorand 0.7.0

A tiny, fast, zero-dep library for random number generation.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

use crate::rand::{wyrand::WyRand, Rng, SeedableRng};
use std::{cell::RefCell, rc::Rc};

thread_local! {
	static WYRAND: Rc<RefCell<WyRand>> = Rc::new(RefCell::new(WyRand::new()));
}

#[derive(Clone)]
#[doc(hidden)]
pub struct TlsWyRand(Rc<RefCell<WyRand>>);

impl Rng<8> for TlsWyRand {
	fn rand(&mut self) -> [u8; 8] {
		self.0.borrow_mut().rand()
	}
}

impl SeedableRng<8, 8> for TlsWyRand {
	fn reseed(&mut self, seed: [u8; 8]) {
		self.0.borrow_mut().reseed(seed);
	}
}

/// Fetch a thread-local [`WyRand`]
/// ```rust
/// use nanorand::Rng;
///
/// let mut rng = nanorand::tls_rng();
/// println!("Random number: {}", rng.generate::<u64>());
/// ```
/// This cannot be passed to another thread, as something like this will fail to compile:
/// ```compile_fail
/// use nanorand::Rng;
///
/// let mut rng = nanorand::tls_rng();
/// std::thread::spawn(move || {
///     println!("Random number: {}", rng.generate::<u64>());
/// });
/// ```
pub fn tls_rng() -> TlsWyRand {
	WYRAND.with(|tls| TlsWyRand(tls.clone()))
}