rng_buffer

This small crate provides RngBufferCore, a struct that wraps any rand::Rng and implements BlockRngCore so that, when used in a rand_core::block::BlockRng64, it will fetch more bytes with each call. This is mainly intended to reduce the number of system calls when using rand::rngs::OsRng or a client of a remote RNG, for purposes where you want to reseed regularly to prevent subtle patterns in your random numbers, but don't need fast key erasure (mainly for Monte Carlo simulations and game servers; I don't recommend it for cryptography or gambling). Profiling with Vtune on an EC2 c7i.metal-24xl instance running Linux HVM kernel version 6.1.72-96.166.amzn2023.x86_64 showed that this reduced the number of CPU cycles spent inside system calls by 80% with a 256-byte buffer per thread (currently the default).

The following are also provided:

• RngBufferWrapper, a wrapper around RngBufferCore that lets you share the buffer with all of its clones. It also bypasses the buffer and directly invokes the wrapped RNG when fill_bytes or try_fill_bytes is called with a slice that's as large as the buffer.
• RngWrapper, a struct that wraps any Rng in an Rc<RefCell<_>> so that clones will use the same instance. Useful for implementing custom replacements for rand::rngs::ThreadRng.
• thread_rng(), a drop-in replacement for rand::thread_rng() that uses an RngBufferCore per thread but otherwise behaves identically.
• thread_seed_source(), which provides an RngBufferWrapper around a thread-local instance of OsRng.
• build_default_seeder() and build_default_rng(), intended for no_std environments where you can't use thread-locals.