proptest::strategy

Trait ValueTree

source
pub trait ValueTree {
    type Value: Debug;

    // Required methods
    fn current(&self) -> Self::Value;
    fn simplify(&mut self) -> bool;
    fn complicate(&mut self) -> bool;
}
Expand description

A generated value and its associated shrinker.

Conceptually, a ValueTree represents a spectrum between a “minimally complex” value and a starting, randomly-chosen value. For values such as numbers, this can be thought of as a simple binary search, and this is how the ValueTree state machine is defined.

The ValueTree state machine notionally has three fields: low, current, and high. Initially, low is the “minimally complex” value for the type, and high and current are both the initially chosen value. It can be queried for its current state. When shrinking, the controlling code tries simplifying the value one step. If the test failure still happens with the simplified value, further simplification occurs. Otherwise, the code steps back up towards the prior complexity.

The main invariants here are that the “high” value always corresponds to a failing test case, and that repeated calls to complicate() will return false only once the “current” value has returned to what it was before the last call to simplify().

While it would be possible for default do-nothing implementations of simplify() and complicate() to be provided, this was not done deliberately since the majority of strategies will want to define their own shrinking anyway, and the minority that do not must call it out explicitly by their own implementation.

Required Associated Types§

source

type Value: Debug

The type of the value produced by this ValueTree.

Required Methods§

source

fn current(&self) -> Self::Value

Returns the current value.

source

fn simplify(&mut self) -> bool

Attempts to simplify the current value. Notionally, this sets the “high” value to the current value, and the current value to a “halfway point” between high and low, rounding towards low.

Returns whether any state changed as a result of this call. This does not necessarily imply that the value of current() has changed, since in the most general case, it is not possible for an implementation to determine this.

This call needs to correctly handle being called even immediately after it had been called previously and returned false.

source

fn complicate(&mut self) -> bool

Attempts to partially undo the last simplification. Notionally, this sets the “low” value to one plus the current value, and the current value to a “halfway point” between high and the new low, rounding towards low.

Returns whether any state changed as a result of this call. This does not necessarily imply that the value of current() has changed, since in the most general case, it is not possible for an implementation to determine this.

It is usually expected that, immediately after a call to simplify() which returns true, this call will itself return true. However, this is not always the case; in some strategies, particularly those that use some form of rejection sampling, the act of trying to simplify may change the state such that simplify() returns true, yet ultimately left the resulting value unchanged, in which case there is nothing left to complicate.

This call does not need to gracefully handle being called before simplify() was ever called, but does need to correctly handle being called even immediately after it had been called previously and returned false.

Implementations on Foreign Types§

source§

impl<T: Debug> ValueTree for fn() -> T

source§

type Value = T

source§

fn simplify(&mut self) -> bool

source§

fn complicate(&mut self) -> bool

source§

fn current(&self) -> Self::Value

source§

impl<T: ValueTree + ?Sized> ValueTree for Box<T>

source§

type Value = <T as ValueTree>::Value

source§

fn current(&self) -> Self::Value

source§

fn simplify(&mut self) -> bool

source§

fn complicate(&mut self) -> bool

Implementors§

source§

impl ValueTree for BoolValueTree

source§

impl ValueTree for CharValueTree

source§

impl ValueTree for proptest::num::f32::BinarySearch

source§

impl ValueTree for proptest::num::f64::BinarySearch

source§

impl ValueTree for proptest::num::i8::BinarySearch

source§

impl ValueTree for proptest::num::i16::BinarySearch

source§

impl ValueTree for proptest::num::i32::BinarySearch

source§

impl ValueTree for proptest::num::i64::BinarySearch

source§

impl ValueTree for proptest::num::i128::BinarySearch

source§

impl ValueTree for proptest::num::isize::BinarySearch

source§

impl ValueTree for proptest::num::u8::BinarySearch

source§

impl ValueTree for proptest::num::u16::BinarySearch

source§

impl ValueTree for proptest::num::u32::BinarySearch

source§

impl ValueTree for proptest::num::u64::BinarySearch

source§

impl ValueTree for proptest::num::u128::BinarySearch

source§

impl ValueTree for proptest::num::usize::BinarySearch

source§

impl ValueTree for IndexValueTree

source§

impl ValueTree for SelectorValueTree

source§

impl<A: Strategy, B: Strategy<Value = A::Value>> ValueTree for TupleUnionValueTree<(LazyValueTree<A>, Option<LazyValueTree<B>>)>

source§

impl<A: Strategy, B: Strategy<Value = A::Value>, C: Strategy<Value = A::Value>> ValueTree for TupleUnionValueTree<(LazyValueTree<A>, Option<LazyValueTree<B>>, Option<LazyValueTree<C>>)>

source§

impl<A: Strategy, B: Strategy<Value = A::Value>, C: Strategy<Value = A::Value>, D: Strategy<Value = A::Value>> ValueTree for TupleUnionValueTree<(LazyValueTree<A>, Option<LazyValueTree<B>>, Option<LazyValueTree<C>>, Option<LazyValueTree<D>>)>

source§

impl<A: Strategy, B: Strategy<Value = A::Value>, C: Strategy<Value = A::Value>, D: Strategy<Value = A::Value>, E: Strategy<Value = A::Value>> ValueTree for TupleUnionValueTree<(LazyValueTree<A>, Option<LazyValueTree<B>>, Option<LazyValueTree<C>>, Option<LazyValueTree<D>>, Option<LazyValueTree<E>>)>

source§

impl<A: Strategy, B: Strategy<Value = A::Value>, C: Strategy<Value = A::Value>, D: Strategy<Value = A::Value>, E: Strategy<Value = A::Value>, F: Strategy<Value = A::Value>> ValueTree for TupleUnionValueTree<(LazyValueTree<A>, Option<LazyValueTree<B>>, Option<LazyValueTree<C>>, Option<LazyValueTree<D>>, Option<LazyValueTree<E>>, Option<LazyValueTree<F>>)>

source§

impl<A: Strategy, B: Strategy<Value = A::Value>, C: Strategy<Value = A::Value>, D: Strategy<Value = A::Value>, E: Strategy<Value = A::Value>, F: Strategy<Value = A::Value>, G: Strategy<Value = A::Value>> ValueTree for TupleUnionValueTree<(LazyValueTree<A>, Option<LazyValueTree<B>>, Option<LazyValueTree<C>>, Option<LazyValueTree<D>>, Option<LazyValueTree<E>>, Option<LazyValueTree<F>>, Option<LazyValueTree<G>>)>

source§

impl<A: Strategy, B: Strategy<Value = A::Value>, C: Strategy<Value = A::Value>, D: Strategy<Value = A::Value>, E: Strategy<Value = A::Value>, F: Strategy<Value = A::Value>, G: Strategy<Value = A::Value>, H: Strategy<Value = A::Value>> ValueTree for TupleUnionValueTree<(LazyValueTree<A>, Option<LazyValueTree<B>>, Option<LazyValueTree<C>>, Option<LazyValueTree<D>>, Option<LazyValueTree<E>>, Option<LazyValueTree<F>>, Option<LazyValueTree<G>>, Option<LazyValueTree<H>>)>

source§

impl<A: Strategy, B: Strategy<Value = A::Value>, C: Strategy<Value = A::Value>, D: Strategy<Value = A::Value>, E: Strategy<Value = A::Value>, F: Strategy<Value = A::Value>, G: Strategy<Value = A::Value>, H: Strategy<Value = A::Value>, I: Strategy<Value = A::Value>> ValueTree for TupleUnionValueTree<(LazyValueTree<A>, Option<LazyValueTree<B>>, Option<LazyValueTree<C>>, Option<LazyValueTree<D>>, Option<LazyValueTree<E>>, Option<LazyValueTree<F>>, Option<LazyValueTree<G>>, Option<LazyValueTree<H>>, Option<LazyValueTree<I>>)>

source§

impl<A: Strategy, B: Strategy<Value = A::Value>, C: Strategy<Value = A::Value>, D: Strategy<Value = A::Value>, E: Strategy<Value = A::Value>, F: Strategy<Value = A::Value>, G: Strategy<Value = A::Value>, H: Strategy<Value = A::Value>, I: Strategy<Value = A::Value>, J: Strategy<Value = A::Value>> ValueTree for TupleUnionValueTree<(LazyValueTree<A>, Option<LazyValueTree<B>>, Option<LazyValueTree<C>>, Option<LazyValueTree<D>>, Option<LazyValueTree<E>>, Option<LazyValueTree<F>>, Option<LazyValueTree<G>>, Option<LazyValueTree<H>>, Option<LazyValueTree<I>>, Option<LazyValueTree<J>>)>

source§

impl<A: ValueTree> ValueTree for TupleValueTree<(A,)>

source§

type Value = (<A as ValueTree>::Value,)

source§

impl<A: ValueTree, B: ValueTree> ValueTree for TupleValueTree<(A, B)>

source§

type Value = (<A as ValueTree>::Value, <B as ValueTree>::Value)

source§

impl<A: ValueTree, B: ValueTree, C: ValueTree> ValueTree for TupleValueTree<(A, B, C)>

source§

type Value = (<A as ValueTree>::Value, <B as ValueTree>::Value, <C as ValueTree>::Value)

source§

impl<A: ValueTree, B: ValueTree, C: ValueTree, D: ValueTree> ValueTree for TupleValueTree<(A, B, C, D)>

source§

type Value = (<A as ValueTree>::Value, <B as ValueTree>::Value, <C as ValueTree>::Value, <D as ValueTree>::Value)

source§

impl<A: ValueTree, B: ValueTree, C: ValueTree, D: ValueTree, E: ValueTree> ValueTree for TupleValueTree<(A, B, C, D, E)>

source§

type Value = (<A as ValueTree>::Value, <B as ValueTree>::Value, <C as ValueTree>::Value, <D as ValueTree>::Value, <E as ValueTree>::Value)

source§

impl<A: ValueTree, B: ValueTree, C: ValueTree, D: ValueTree, E: ValueTree, F: ValueTree> ValueTree for TupleValueTree<(A, B, C, D, E, F)>

source§

type Value = (<A as ValueTree>::Value, <B as ValueTree>::Value, <C as ValueTree>::Value, <D as ValueTree>::Value, <E as ValueTree>::Value, <F as ValueTree>::Value)

source§

impl<A: ValueTree, B: ValueTree, C: ValueTree, D: ValueTree, E: ValueTree, F: ValueTree, G: ValueTree> ValueTree for TupleValueTree<(A, B, C, D, E, F, G)>

source§

type Value = (<A as ValueTree>::Value, <B as ValueTree>::Value, <C as ValueTree>::Value, <D as ValueTree>::Value, <E as ValueTree>::Value, <F as ValueTree>::Value, <G as ValueTree>::Value)

source§

impl<A: ValueTree, B: ValueTree, C: ValueTree, D: ValueTree, E: ValueTree, F: ValueTree, G: ValueTree, H: ValueTree> ValueTree for TupleValueTree<(A, B, C, D, E, F, G, H)>

source§

type Value = (<A as ValueTree>::Value, <B as ValueTree>::Value, <C as ValueTree>::Value, <D as ValueTree>::Value, <E as ValueTree>::Value, <F as ValueTree>::Value, <G as ValueTree>::Value, <H as ValueTree>::Value)

source§

impl<A: ValueTree, B: ValueTree, C: ValueTree, D: ValueTree, E: ValueTree, F: ValueTree, G: ValueTree, H: ValueTree, I: ValueTree> ValueTree for TupleValueTree<(A, B, C, D, E, F, G, H, I)>

source§

type Value = (<A as ValueTree>::Value, <B as ValueTree>::Value, <C as ValueTree>::Value, <D as ValueTree>::Value, <E as ValueTree>::Value, <F as ValueTree>::Value, <G as ValueTree>::Value, <H as ValueTree>::Value, <I as ValueTree>::Value)

source§

impl<A: ValueTree, B: ValueTree, C: ValueTree, D: ValueTree, E: ValueTree, F: ValueTree, G: ValueTree, H: ValueTree, I: ValueTree, J: ValueTree> ValueTree for TupleValueTree<(A, B, C, D, E, F, G, H, I, J)>

source§

type Value = (<A as ValueTree>::Value, <B as ValueTree>::Value, <C as ValueTree>::Value, <D as ValueTree>::Value, <E as ValueTree>::Value, <F as ValueTree>::Value, <G as ValueTree>::Value, <H as ValueTree>::Value, <I as ValueTree>::Value, <J as ValueTree>::Value)

source§

impl<A: ValueTree, B: ValueTree, C: ValueTree, D: ValueTree, E: ValueTree, F: ValueTree, G: ValueTree, H: ValueTree, I: ValueTree, J: ValueTree, K: ValueTree> ValueTree for TupleValueTree<(A, B, C, D, E, F, G, H, I, J, K)>

source§

type Value = (<A as ValueTree>::Value, <B as ValueTree>::Value, <C as ValueTree>::Value, <D as ValueTree>::Value, <E as ValueTree>::Value, <F as ValueTree>::Value, <G as ValueTree>::Value, <H as ValueTree>::Value, <I as ValueTree>::Value, <J as ValueTree>::Value, <K as ValueTree>::Value)

source§

impl<A: ValueTree, B: ValueTree, C: ValueTree, D: ValueTree, E: ValueTree, F: ValueTree, G: ValueTree, H: ValueTree, I: ValueTree, J: ValueTree, K: ValueTree, L: ValueTree> ValueTree for TupleValueTree<(A, B, C, D, E, F, G, H, I, J, K, L)>

source§

type Value = (<A as ValueTree>::Value, <B as ValueTree>::Value, <C as ValueTree>::Value, <D as ValueTree>::Value, <E as ValueTree>::Value, <F as ValueTree>::Value, <G as ValueTree>::Value, <H as ValueTree>::Value, <I as ValueTree>::Value, <J as ValueTree>::Value, <K as ValueTree>::Value, <L as ValueTree>::Value)

source§

impl<K, V> ValueTree for BTreeMapValueTree<K, V>
where K: ValueTree, V: ValueTree, K::Value: Ord,

source§

impl<K, V> ValueTree for HashMapValueTree<K, V>
where K: ValueTree, V: ValueTree, K::Value: Hash + Eq,

source§

impl<S: ValueTree> ValueTree for FlattenValueTree<S>
where S::Value: Strategy,

source§

impl<S: ValueTree, F: Fn(&S::Value) -> bool> ValueTree for proptest::strategy::Filter<S, F>

source§

impl<S: ValueTree, F: FilterFn<S::Value>> ValueTree for proptest::strategy::statics::Filter<S, F>

source§

impl<S: ValueTree, F: MapFn<S::Value>> ValueTree for proptest::strategy::statics::Map<S, F>

source§

type Value = <F as MapFn<<S as ValueTree>::Value>>::Output

source§

impl<S: ValueTree, O: Debug> ValueTree for MapInto<S, O>
where S::Value: Into<O>,

source§

type Value = O

source§

impl<S: ValueTree, O: Debug, F: Fn(S::Value) -> O> ValueTree for proptest::strategy::Map<S, F>

source§

type Value = O

source§

impl<S: ValueTree, O: Debug, F: Fn(S::Value, TestRng) -> O> ValueTree for PerturbValueTree<S, F>

source§

type Value = O

source§

impl<T> ValueTree for BTreeSetValueTree<T>
where T: ValueTree, T::Value: Ord,

source§

impl<T> ValueTree for BinaryHeapValueTree<T>
where T: ValueTree, T::Value: Ord,

source§

impl<T> ValueTree for HashSetValueTree<T>
where T: ValueTree, T::Value: Hash + Eq,

source§

impl<T> ValueTree for LinkedListValueTree<T>
where T: ValueTree,

source§

impl<T> ValueTree for VecDequeValueTree<T>
where T: ValueTree,

source§

impl<T> ValueTree for OptionValueTree<T>
where T: Strategy,

source§

impl<T> ValueTree for SelectValueTree<T>
where T: Clone + Debug + 'static,

source§

type Value = T

source§

impl<T> ValueTree for RegexGeneratorValueTree<T>
where T: Debug,

source§

type Value = T

source§

impl<T, E> ValueTree for MaybeErrValueTree<T, E>
where T: Strategy, E: Strategy,

source§

type Value = Result<<T as Strategy>::Value, <E as Strategy>::Value>

source§

impl<T, E> ValueTree for MaybeOkValueTree<T, E>
where T: Strategy, E: Strategy,

source§

type Value = Result<<T as Strategy>::Value, <E as Strategy>::Value>

source§

impl<T: BitSetLike> ValueTree for BitSetValueTree<T>

source§

type Value = T

source§

impl<T: Clone + Debug> ValueTree for Just<T>

source§

type Value = T

source§

impl<T: Debug + Clone + 'static> ValueTree for SubsequenceValueTree<T>

source§

type Value = Vec<T>

source§

impl<T: Debug, F: Fn() -> T> ValueTree for LazyJust<T, F>

source§

type Value = T

source§

impl<T: Strategy> ValueTree for UnionValueTree<T>

source§

impl<T: ValueTree> ValueTree for VecValueTree<T>

source§

impl<T: ValueTree> ValueTree for Fuse<T>

source§

impl<T: ValueTree> ValueTree for NoShrink<T>

source§

impl<T: ValueTree, const N: usize> ValueTree for ArrayValueTree<[T; N]>

source§

type Value = [<T as ValueTree>::Value; N]

source§

impl<V: ValueTree> ValueTree for ShuffleValueTree<V>
where V::Value: Shuffleable,

source§

impl<V: ValueTree, F: Fn(V::Value) -> Option<O>, O: Debug> ValueTree for FilterMapValueTree<V, F, O>

source§

type Value = O