Enum proptest::test_runner::RngAlgorithm
source · [−]pub enum RngAlgorithm {
XorShift,
ChaCha,
PassThrough,
Recorder,
// some variants omitted
}
Expand description
Identifies a particular RNG algorithm supported by proptest.
Proptest supports dynamic configuration of algorithms to allow it to
continue operating with persisted regression files and to allow the
configuration to be expressed in the Config
struct.
Variants
XorShift
The XorShift algorithm. This was the default up through and including Proptest 0.9.0.
It is faster than ChaCha but produces lower quality randomness and has some pathological cases where it may fail to produce outputs that are random even to casual observation.
The seed must be exactly 16 bytes.
ChaCha
The ChaCha algorithm. This became the default with Proptest 0.9.1.
The seed must be exactly 32 bytes.
PassThrough
This is not an actual RNG algorithm, but instead returns data directly from its “seed”.
This is useful when Proptest is being driven from some other entropy source, such as a fuzzer.
If the seed is depleted, the RNG will return 0s forever.
Note that in cases where a new RNG is to be derived from an existing
one, the data is split evenly between them, regardless of how much
entropy is actually needed. This means that combinators like
prop_perturb
and prop_flat_map
can require extremely large inputs.
Recorder
This is equivalent to the ChaCha
RNG, with the addition that it
records the bytes used to create a value.
This is useful when Proptest is used for fuzzing, and a corpus of
initial inputs need to be created. Note that in these cases, you need
to use the TestRunner
API directly yourself instead of using the
proptest!
macro, as otherwise there is no way to obtain the bytes
this captures.
Trait Implementations
sourceimpl Clone for RngAlgorithm
impl Clone for RngAlgorithm
sourcefn clone(&self) -> RngAlgorithm
fn clone(&self) -> RngAlgorithm
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
sourceimpl Debug for RngAlgorithm
impl Debug for RngAlgorithm
sourceimpl Default for RngAlgorithm
impl Default for RngAlgorithm
sourceimpl Display for RngAlgorithm
impl Display for RngAlgorithm
sourceimpl FromStr for RngAlgorithm
impl FromStr for RngAlgorithm
sourceimpl PartialEq<RngAlgorithm> for RngAlgorithm
impl PartialEq<RngAlgorithm> for RngAlgorithm
impl Copy for RngAlgorithm
impl Eq for RngAlgorithm
impl StructuralEq for RngAlgorithm
impl StructuralPartialEq for RngAlgorithm
Auto Trait Implementations
impl RefUnwindSafe for RngAlgorithm
impl Send for RngAlgorithm
impl Sync for RngAlgorithm
impl Unpin for RngAlgorithm
impl UnwindSafe for RngAlgorithm
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more