Struct puffin::trace::Trace

pub struct Trace<M: Matcher> {
    pub descriptors: Vec<AgentDescriptor>,
    pub steps: Vec<Step<M>>,
    pub prior_traces: Vec<Trace<M>>,
}

Fields

descriptors: Vec<AgentDescriptor>

steps: Vec<Step<M>>

prior_traces: Vec<Trace<M>>

Implementations

impl<M: Matcher> Trace<M>

pub fn dot_graph(&self, tree_mode: bool) -> String

pub fn dot_subgraphs(&self, tree_mode: bool) -> Vec<String>

impl<M: Matcher> Trace<M>

pub fn count_functions_by_name(&self, find_name: &'static str) -> usize

pub fn count_functions(&self) -> usize

pub fn write_plots(&self, i: u16)

impl<M: Matcher> Trace<M>

A Trace consists of several Steps. Each has either a OutputAction or an InputAction. Each Steps references an Agent by name. Furthermore, a trace also has a list of AgentDescriptors which act like a blueprint to spawn Agents with a corresponding server or client role and a specific TLs version. Essentially they are an Agent without a stream.

fn spawn_agents<PB: ProtocolBehavior>(
    &self,
    ctx: &mut TraceContext<PB>
) -> Result<(), Error>

pub fn execute<PB>(&self, ctx: &mut TraceContext<PB>) -> Result<(), Error>where
    PB: ProtocolBehavior<Matcher = M>,

pub fn execute_deterministic<PB>(
    &self,
    put_registry: &PutRegistry<PB>,
    default_put_options: PutOptions
) -> Result<TraceContext<PB>, Error>where
    PB: ProtocolBehavior<Matcher = M>,

pub fn execute_with_non_default_puts<PB>(
    &self,
    put_registry: &PutRegistry<PB>,
    descriptors: &[(AgentName, PutDescriptor)]
) -> Result<TraceContext<PB>, Error>where
    PB: ProtocolBehavior<Matcher = M>,

pub fn serialize_postcard(&self) -> Result<Vec<u8>, Error>

pub fn deserialize_postcard(slice: &[u8]) -> Result<Trace<M>, Error>

Trait Implementations

impl<M: Clone + Matcher> Clone for Trace<M>

fn clone(&self) -> Trace<M>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<M: Matcher> Debug for Trace<M>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de, M> Deserialize<'de> for Trace<M>where
    M: Matcher,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<M: Matcher> Display for Trace<M>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<M: Matcher> HasLen for Trace<M>

fn len(&self) -> usize

The length

fn is_empty(&self) -> bool

Returns true if it has no elements.

impl<M: Hash + Matcher> Hash for Trace<M>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,
    Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<M: Matcher> Input for Trace<M>

fn generate_name(&self, _idx: usize) -> String

Generate a name for this input, the user is responsible for making each name of testcase unique.

fn to_file<P>(&self, path: P) -> Result<(), Error>where
    P: AsRef<Path>,

Write this input to the file

fn from_file<P>(path: P) -> Result<Self, Error>where
    P: AsRef<Path>,

Load the content of this input from a file

fn wrapped_as_testcase(&mut self)

An hook executed if the input is stored as Testcase

impl<S, M: Matcher> Mutator<Trace<M>, S> for GenerateMutator<S, M>where
    S: HasRand,

fn mutate(
    &mut self,
    state: &mut S,
    trace: &mut Trace<M>,
    _stage_idx: i32
) -> Result<MutationResult, Error>

Mutate a given input

fn post_exec(
    &mut self,
    _state: &mut S,
    _stage_idx: i32,
    _corpus_idx: Option<CorpusId>
) -> Result<(), Error>

Post-process given the outcome of the execution

impl<S, M: Matcher> Mutator<Trace<M>, S> for RemoveAndLiftMutator<S>where
    S: HasRand,

fn mutate(
    &mut self,
    state: &mut S,
    trace: &mut Trace<M>,
    _stage_idx: i32
) -> Result<MutationResult, Error>

Mutate a given input

fn post_exec(
    &mut self,
    _state: &mut S,
    _stage_idx: i32,
    _corpus_idx: Option<CorpusId>
) -> Result<(), Error>

Post-process given the outcome of the execution

impl<S, M: Matcher> Mutator<Trace<M>, S> for RepeatMutator<S>where
    S: HasRand,

fn mutate(
    &mut self,
    state: &mut S,
    trace: &mut Trace<M>,
    _stage_idx: i32
) -> Result<MutationResult, Error>

Mutate a given input

fn post_exec(
    &mut self,
    _state: &mut S,
    _stage_idx: i32,
    _corpus_idx: Option<CorpusId>
) -> Result<(), Error>

Post-process given the outcome of the execution

impl<S, M: Matcher> Mutator<Trace<M>, S> for ReplaceMatchMutator<S>where
    S: HasRand,

fn mutate(
    &mut self,
    state: &mut S,
    trace: &mut Trace<M>,
    _stage_idx: i32
) -> Result<MutationResult, Error>

Mutate a given input

fn post_exec(
    &mut self,
    _state: &mut S,
    _stage_idx: i32,
    _corpus_idx: Option<CorpusId>
) -> Result<(), Error>

Post-process given the outcome of the execution

impl<S, M: Matcher> Mutator<Trace<M>, S> for ReplaceReuseMutator<S>where
    S: HasRand,

fn mutate(
    &mut self,
    state: &mut S,
    trace: &mut Trace<M>,
    _stage_idx: i32
) -> Result<MutationResult, Error>

Mutate a given input

fn post_exec(
    &mut self,
    _state: &mut S,
    _stage_idx: i32,
    _corpus_idx: Option<CorpusId>
) -> Result<(), Error>

Post-process given the outcome of the execution

impl<S, M: Matcher> Mutator<Trace<M>, S> for SkipMutator<S>where
    S: HasRand,

fn mutate(
    &mut self,
    state: &mut S,
    trace: &mut Trace<M>,
    _stage_idx: i32
) -> Result<MutationResult, Error>

Mutate a given input

fn post_exec(
    &mut self,
    _state: &mut S,
    _stage_idx: i32,
    _corpus_idx: Option<CorpusId>
) -> Result<(), Error>

Post-process given the outcome of the execution

impl<S, M: Matcher> Mutator<Trace<M>, S> for SwapMutator<S>where
    S: HasRand,

fn mutate(
    &mut self,
    state: &mut S,
    trace: &mut Trace<M>,
    _stage_idx: i32
) -> Result<MutationResult, Error>

Mutate a given input

fn post_exec(
    &mut self,
    _state: &mut S,
    _stage_idx: i32,
    _corpus_idx: Option<CorpusId>
) -> Result<(), Error>

Post-process given the outcome of the execution

impl<M> Serialize for Trace<M>where
    M: Matcher,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where
    __S: Serializer,

Serialize this value into the given Serde serializer.