Struct proptest::test_runner::TestRunner
source · pub struct TestRunner { /* private fields */ }
Expand description
State used when running a proptest test.
Implementations§
source§impl TestRunner
impl TestRunner
sourcepub fn rng(&mut self) -> &mut XorShiftRng
pub fn rng(&mut self) -> &mut XorShiftRng
Returns the RNG for this test run.
sourcepub fn new_rng(&mut self) -> XorShiftRng
pub fn new_rng(&mut self) -> XorShiftRng
Create a new, independent but deterministic RNG from the RNG in this runner.
sourcepub fn run<S: Strategy, F: Fn(&ValueFor<S>) -> TestCaseResult>(
&mut self,
strategy: &S,
test: F
) -> Result<(), TestError<ValueFor<S>>>
pub fn run<S: Strategy, F: Fn(&ValueFor<S>) -> TestCaseResult>(
&mut self,
strategy: &S,
test: F
) -> Result<(), TestError<ValueFor<S>>>
Run test cases against f
, choosing inputs via strategy
.
If any failure cases occur, try to find a minimal failure case and
report that. If invoking f
panics, the panic is turned into a
TestCaseError::Fail
.
If failure persistence is enabled, all persisted failing cases are tested first. If a later non-persisted case fails, its seed is persisted before returning failure.
Returns success or failure indicating why the test as a whole failed.
sourcepub fn run_one<V: ValueTree, F: Fn(&V::Value) -> TestCaseResult>(
&mut self,
case: V,
test: F
) -> Result<bool, TestError<V::Value>>
pub fn run_one<V: ValueTree, F: Fn(&V::Value) -> TestCaseResult>(
&mut self,
case: V,
test: F
) -> Result<bool, TestError<V::Value>>
Run one specific test case against this runner.
If the test fails, finds the minimal failing test case. If the test does not fail, returns whether it succeeded or was filtered out.
This does not honour the fork
config, and will not be able to
terminate the run if it runs for longer than timeout
. However, if the
test function returns but took longer than timeout
, the test case
will fail.
sourcepub fn reject_local<R>(&mut self, whence: R) -> Result<(), Reason>where
R: Into<Reason>,
pub fn reject_local<R>(&mut self, whence: R) -> Result<(), Reason>where
R: Into<Reason>,
Update the state to account for a local rejection from whence
, and
return Ok
if the caller should keep going or Err
to abort.
sourcepub fn flat_map_regen(&self) -> bool
pub fn flat_map_regen(&self) -> bool
Increment the counter of flat map regenerations and return whether it is still under the configured limit.
Trait Implementations§
source§impl Clone for TestRunner
impl Clone for TestRunner
source§fn clone(&self) -> TestRunner
fn clone(&self) -> TestRunner
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for TestRunner
impl Debug for TestRunner
source§impl Default for TestRunner
impl Default for TestRunner
Equivalent to: TestRunner::new(Config::default())
.