rstmt-core 0.1.0

the core modules for the rstmt framework
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
43
44
45
46
47
48
49

/*
    appellation: impl_freq_rand <module>
    authors: @FL03
*/
#![cfg(feature = "rand")]
use crate::freq::Frequency;
use rand::{Rng, RngExt};
use rand_distr::uniform::{SampleRange, SampleUniform};
use rand_distr::{Distribution, StandardUniform};

impl<T> Frequency<T> {
    /// generates a new random frequency within the specified range.
    pub fn random_range<R>(range: R) -> Self
    where
        R: SampleRange<T>,
        T: SampleUniform,
    {
        Frequency(rand::random_range(range))
    }
}

impl<T> Frequency<T>
where
    StandardUniform: Distribution<T>,
{
    /// generates a random frequency.
    pub fn random() -> Self {
        Frequency::random_with(&mut rand::rng())
    }
    /// generates a random frequency using the provided random number generator.
    pub fn random_with<R>(rng: &mut R) -> Self
    where
        R: ?Sized + Rng,
    {
        Frequency(rng.random())
    }
}

impl<T> Distribution<Frequency<T>> for StandardUniform
where
    StandardUniform: Distribution<T>,
{
    fn sample<R>(&self, rng: &mut R) -> Frequency<T>
    where
        R: ?Sized + Rng,
    {
        Frequency(rng.random())
    }
}