Struct FakeCryptoRng

pub struct FakeCryptoRng<R = XorShiftRng>(/* private fields */);

A wrapper which implements RngCore and CryptoRng for any RngCore.

This is used to satisfy RngContext’s requirement that the associated Rng type implements CryptoRng.

Security

This is obviously insecure. Don’t use it except in testing!

Implementations

impl FakeCryptoRng<XorShiftRng>

pub fn new_xorshift(seed: u128) -> FakeCryptoRng<XorShiftRng>

Creates a new FakeCryptoRng<XorShiftRng> from a seed.

pub fn deep_clone(&self) -> Self

Returns a deep clone of this RNG, copying the current RNG state.

pub fn with_fake_rngs<F: Fn(Self)>(iterations: u128, f: F)

Creates iterations fake RNGs.

with_fake_rngs will create iterations different FakeCryptoRngs and call the function f for each one of them.

This function can be used for tests that weed out weirdness that can happen with certain random number sequences.

Trait Implementations

impl<R: Clone> Clone for FakeCryptoRng<R>

fn clone(&self) -> FakeCryptoRng<R>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<R: Debug> Debug for FakeCryptoRng<R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FakeCryptoRng<XorShiftRng>

fn default() -> FakeCryptoRng<XorShiftRng>

Returns the “default value” for a type.

impl<R: RngCore> RngContext for FakeCryptoRng<R>

type Rng<'a> = &'a mut FakeCryptoRng<R> where Self: 'a

The random number generator (RNG) provided by this RngContext.

fn rng(&mut self) -> Self::Rng<'_>

Gets the random number generator (RNG).

impl<R: RngCore> RngCore for FakeCryptoRng<R>

fn next_u32(&mut self) -> u32

Return the next random u32.

fn next_u64(&mut self) -> u64

Return the next random u64.

fn fill_bytes(&mut self, dest: &mut [u8])

Fill dest with random data.

impl<R: SeedableRng> SeedableRng for FakeCryptoRng<R>

type Seed = <R as SeedableRng>::Seed

Seed type, which is restricted to types mutably-dereferenceable as u8 arrays (we recommend [u8; N] for some N).

fn from_seed(seed: Self::Seed) -> Self

Create a new PRNG using the given seed.

fn seed_from_u64(state: u64) -> Self

Create a new PRNG using a u64 seed.

fn from_rng(rng: &mut impl RngCore) -> Self

Create a new PRNG seeded from an infallible Rng.

fn try_from_rng<R>(rng: &mut R) -> Result<Self, <R as TryRngCore>::Error>

where R: TryRngCore,

Create a new PRNG seeded from a potentially fallible Rng.

fn from_os_rng() -> Self

Creates a new instance of the RNG seeded via getrandom.

fn try_from_os_rng() -> Result<Self, Error>

Creates a new instance of the RNG seeded via getrandom without unwrapping potential getrandom errors.

impl<R: RngCore> CryptoRng for FakeCryptoRng<R>