Struct Scenario 

pub struct Scenario { /* private fields */ }

Your workflows and requests, run under seeds. See the module docs.

Implementations

impl Scenario

pub fn new(setup: impl Fn(&mut Setup) + Send + Sync + 'static) -> Self

setup runs once per seed, on a fresh machine, and builds that seed’s workflows, requests and checks.

pub fn shards(self, n: u32) -> Self

A fixed shard count (by default the seed picks 1 to 3).

pub fn fault_window(self, d: Duration) -> Self

How long faults are injected, from the start of the simulation (default 2 s of simulated time). Requests may come later.

pub fn crash_every(self, d: Duration) -> Self

Mean time between process crashes in the fault window; zero for none. By default the seed picks none, 150, 400 or 900 ms.

pub fn flush_failures_per_mille(self, n: u32) -> Self

Flushes that fail, per thousand, in the fault window. By default the seed picks 0, 2 or 10.

pub fn torn_writes(self, on: bool) -> Self

Whether a crash tears unflushed writes (default true) or only loses them.

pub fn no_faults(self) -> Self

No crashes and no failed flushes: the scheduler and the clock only.

pub fn settle_within(self, d: Duration) -> Self

Simulated time every workflow gets to finish once faults stop (default one hour). Workflows that sleep longer need more.

pub fn config(&self, seed: u64) -> SimConfig

The configuration seed seed runs with.

pub fn run(&self, seed: u64) -> Result<Report, Failure>

Runs one seed. The same seed reproduces the same run, so a failing seed is a test case.

pub fn run_seeds( &self, seeds: impl IntoIterator<Item = u64>, ) -> Result<Summary, Failure>

Runs every seed, stopping at the first failure.

Trait Implementations

impl Clone for Scenario

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.