touched 0.1.0

Utility for writing fuzzing harnesses of callback-style and trait-style Rust crates
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

#![doc = include_str!("../README.md")]
#![no_std]
#![cfg_attr(docsrs, feature(doc_cfg))]

mod primitive;
mod slice;
mod tuple;
mod util;

#[cfg(feature = "derive")]
pub use touched_derive::Touchable;

/// Trait for accessing each memory unit of a target.
///
/// You can use `#[derive(Touchable)]` for common structures.
pub trait Touchable {
    /// Take the reference of a target, access its each memory unit
    fn touch(&self);
}

impl<T: Touchable + ?Sized> Touchable for &T {
    fn touch(&self) {
        touching::<T>(*self)
    }
}

impl<T: Touchable + ?Sized> Touchable for &mut T {
    fn touch(&self) {
        touching::<T>(*self)
    }
}

/// Access a target's each memory unit.
///
/// The target should implement [`Touchable`].
pub fn touching<T: Touchable + ?Sized>(t: &T) {
    <T as Touchable>::touch(t);
}