Struct Fickle

pub struct Fickle { /* private fields */ }

Retry a fickle test if it fails initially.

use fickle::Fickle;

// There is a 30% chance this test fails any 1 run. But since 3 retries are allowed (4 total
// runs), this is just a 0.3^4=0.81% chance that they *all* fail. So `Fickle` transforms this
// from a test that is problematically flaky to one that should rarely be an issue.
fn flaky() {
    let fickle = Fickle::new(3, 1).unwrap();
    let flakycode: fn() -> () = || {
        if 0.7 < rand::random() {
            panic!("number was too big!")
        }
    };
    fickle.run(flakycode).unwrap()
}

Implementations

impl Fickle

pub fn new(retries: usize, passes: usize) -> Result<Self, FickleError>

Specify the number of retries & number of required passes.

pub fn new_retries(retries: usize) -> Result<Self, FickleError>

Specify the number of retries, while using the default number of passes (1).

pub fn new_passes(passes: usize) -> Result<Self, FickleError>

Specify the number of passes, while using the default number of retries (1).

pub fn run<T, E: Display, P, Q: Debug>( &self, test: impl Test<T, E, P, Q>, ) -> Result<T, TooManyFailures<E, Q>>

Trait Implementations

impl Clone for Fickle

fn clone(&self) -> Fickle

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Fickle

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

Formats the value using the given formatter.

impl Default for Fickle

By default, just 1 retry is attempted and 1 passing test run is required.

fn default() -> Self

Returns the “default value” for a type.

impl Copy for Fickle