fuzzcheck_serializer 0.6.0

Basic serializers to use with fuzzcheck-rs
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

//! This crate contains types implementing the Serializer trait of fuzzcheck.
//! There are currently two implementations:
//!
//! * SerdeSerializer uses the `serde` and `serde_json` crate to serialize
//! the test inputs (of arbitrary Serializable type) to a `.json` file.
//! It is available under the “serde” feature
//!
//! * [ByteSerializer] encodes and decodes values of type `Vec<u8>` by simply
//! copy/pasting the bytes from/to the files. The extension is customizable.
//!

extern crate fuzzcheck_traits;

#[cfg(feature = "serde-json")]
mod serde_serializer;
#[cfg(feature = "serde-json")]
pub use serde_serializer::SerdeSerializer;

#[cfg(feature = "serde-json-alternative")]
mod json_serializer;
#[cfg(feature = "serde-json-alternative")]
pub use json_serializer::JsonSerializer;

/**
A Serializer for Vec<u8> that simply copies the bytes from/to the files.

```ignore
fn parse(data: &[u8]) -> bool {
    // ...
}
let mutator = VecMutator<U8Mutator>::default();

// pass the desired extension of the file as argument
let serializer = ByteSerializer::new("png");

fuzzcheck::launch(parse, mutator, serializer)
```
*/
pub struct ByteSerializer {
    ext: &'static str,
}

impl ByteSerializer {
    pub fn new(ext: &'static str) -> Self {
        Self { ext }
    }
}

impl fuzzcheck_traits::Serializer for ByteSerializer {
    type Value = Vec<u8>;
    fn is_utf8(&self) -> bool {
        false
    }
    fn extension(&self) -> &str {
        self.ext
    }
    fn from_data(&self, data: &[u8]) -> Option<Self::Value> {
        Some(data.into())
    }
    fn to_data(&self, value: &Self::Value) -> Vec<u8> {
        value.clone()
    }
}