mutatis 0.5.2

`mutatis` is a library for writing custom, structure-aware test-case mutators for fuzzers in Rust.
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

use super::*;
use core::marker;

/// A mutator for `core::marker::PhantomData<T>` values.
///
/// See the [`phantom_data()`] function to create new instances and for example
/// usage.
#[derive(Clone, Debug)]
pub struct PhantomDataMutator<T> {
    _phantom: marker::PhantomData<T>,
}

impl<T> Default for PhantomDataMutator<T> {
    fn default() -> Self {
        PhantomDataMutator {
            _phantom: marker::PhantomData,
        }
    }
}

/// Create a new mutator for `core::marker::PhantomData<T>` values.
///
/// # Example
///
/// ```
/// use mutatis::{mutators as m, Generate, Session};
/// use core::marker::PhantomData;
///
/// let mut mutator = m::phantom_data::<u32>();
/// let mut session = Session::new();
///
/// let value: PhantomData<u32> = session.generate_with(&mut mutator).unwrap();
///
/// assert_eq!(value, PhantomData);
/// ```
pub fn phantom_data<T>() -> PhantomDataMutator<T> {
    PhantomDataMutator {
        _phantom: marker::PhantomData,
    }
}

impl<T> Mutate<marker::PhantomData<T>> for PhantomDataMutator<T> {
    #[inline]
    fn mutate(&mut self, _c: &mut Candidates, _value: &mut marker::PhantomData<T>) -> Result<()> {
        Ok(())
    }

    #[inline]
    fn mutation_count(
        &self,
        _value: &marker::PhantomData<T>,
        _shrink: bool,
    ) -> core::option::Option<u32> {
        Some(0)
    }
}

impl<T> Generate<marker::PhantomData<T>> for PhantomDataMutator<T> {
    #[inline]
    fn generate(&mut self, _ctx: &mut Context) -> Result<marker::PhantomData<T>> {
        Ok(marker::PhantomData)
    }
}

impl<T> DefaultMutate for marker::PhantomData<T> {
    type DefaultMutate = PhantomDataMutator<T>;
}