dicetest 0.4.0

Framework for writing tests with randomly generated test data
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

use crate::prelude::*;

/// Generates the given value.
///
/// # Examples
///
/// ```
/// use dicetest::prelude::*;
/// use dicetest::{Prng, Limit};
///
/// let mut prng = Prng::from_seed(0x5EED.into());
/// let limit = Limit::default();
/// let mut fate = Fate::new(&mut prng, limit);
///
/// assert_eq!(fate.roll(dice::just_once(42)), 42);
///
/// #[derive(Debug, PartialEq, Eq)]
/// struct CannotBeCloned;
/// assert_eq!(fate.roll(dice::just_once(CannotBeCloned)), CannotBeCloned);
/// ```
pub fn just_once<T>(value: T) -> impl DieOnce<T> {
    dice::from_fn_once(|_| value)
}

/// Generates a clone of the given value.
///
/// # Examples
///
/// ```
/// use dicetest::prelude::*;
/// use dicetest::{Prng, Limit};
///
/// let mut prng = Prng::from_seed(0x5EED.into());
/// let limit = Limit::default();
/// let mut fate = Fate::new(&mut prng, limit);
///
/// assert_eq!(fate.roll(dice::just(42)), 42);
///
/// let cloning_die = dice::just(vec![0, 1, 2]);
/// for _ in 0..10 {
///     assert_eq!(fate.roll(&cloning_die), vec![0, 1, 2]);
/// }
/// ```
pub fn just<T>(value: T) -> impl Die<T>
where
    T: Clone,
{
    dice::from_fn(move |_| value.clone())
}