Trait quickcheck::Arbitrary

pub trait Arbitrary: Clone + Send + 'static {
    fn arbitrary<G: Gen>(g: &mut G) -> Self;

    fn shrink(&self) -> Box<Iterator<Item = Self>> { ... }
}

Arbitrary describes types whose values can be randomly generated and shrunk.

Aside from shrinking, Arbitrary is different from the std::Rand trait in that it uses a Gen to control the distribution of random values.

As of now, all types that implement Arbitrary must also implement Clone. (I'm not sure if this is a permanent restriction.)

They must also be sendable and static since every test is run in its own thread using thread::Builder::spawn, which requires the Send + 'static bounds.

Required Methods

fn arbitrary<G: Gen>(g: &mut G) -> Self

Provided Methods

fn shrink(&self) -> Box<Iterator<Item = Self>>

Implementations on Foreign Types

impl Arbitrary for ()

fn arbitrary<G: Gen>(_: &mut G)

fn shrink(&self) -> Box<Iterator<Item = Self>>

impl Arbitrary for bool

fn arbitrary<G: Gen>(g: &mut G) -> bool

fn shrink(&self) -> Box<Iterator<Item = bool>>

impl<A: Arbitrary> Arbitrary for Option<A>

fn arbitrary<G: Gen>(g: &mut G) -> Option<A>

fn shrink(&self) -> Box<Iterator<Item = Option<A>>>

impl<A: Arbitrary, B: Arbitrary> Arbitrary for Result<A, B>

fn arbitrary<G: Gen>(g: &mut G) -> Result<A, B>

fn shrink(&self) -> Box<Iterator<Item = Result<A, B>>>

impl<A> Arbitrary for (A,) where
    A: Arbitrary, 

fn arbitrary<GEN: Gen>(g: &mut GEN) -> (A,)

fn shrink(&self) -> Box<Iterator<Item = (A,)>>

impl<A, B> Arbitrary for (A, B) where
    A: Arbitrary,
    B: Arbitrary, 

fn arbitrary<GEN: Gen>(g: &mut GEN) -> (A, B)

fn shrink(&self) -> Box<Iterator<Item = (A, B)>>

impl<A, B, C> Arbitrary for (A, B, C) where
    A: Arbitrary,
    B: Arbitrary,
    C: Arbitrary, 

fn arbitrary<GEN: Gen>(g: &mut GEN) -> (A, B, C)

fn shrink(&self) -> Box<Iterator<Item = (A, B, C)>>

impl<A, B, C, D> Arbitrary for (A, B, C, D) where
    A: Arbitrary,
    B: Arbitrary,
    C: Arbitrary,
    D: Arbitrary, 

fn arbitrary<GEN: Gen>(g: &mut GEN) -> (A, B, C, D)

fn shrink(&self) -> Box<Iterator<Item = (A, B, C, D)>>

impl<A, B, C, D, E> Arbitrary for (A, B, C, D, E) where
    A: Arbitrary,
    B: Arbitrary,
    C: Arbitrary,
    D: Arbitrary,
    E: Arbitrary, 

fn arbitrary<GEN: Gen>(g: &mut GEN) -> (A, B, C, D, E)

fn shrink(&self) -> Box<Iterator<Item = (A, B, C, D, E)>>

impl<A, B, C, D, E, F> Arbitrary for (A, B, C, D, E, F) where
    A: Arbitrary,
    B: Arbitrary,
    C: Arbitrary,
    D: Arbitrary,
    E: Arbitrary,
    F: Arbitrary, 

fn arbitrary<GEN: Gen>(g: &mut GEN) -> (A, B, C, D, E, F)

fn shrink(&self) -> Box<Iterator<Item = (A, B, C, D, E, F)>>

impl<A, B, C, D, E, F, G> Arbitrary for (A, B, C, D, E, F, G) where
    A: Arbitrary,
    B: Arbitrary,
    C: Arbitrary,
    D: Arbitrary,
    E: Arbitrary,
    F: Arbitrary,
    G: Arbitrary, 

fn arbitrary<GEN: Gen>(g: &mut GEN) -> (A, B, C, D, E, F, G)

fn shrink(&self) -> Box<Iterator<Item = (A, B, C, D, E, F, G)>>

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

fn arbitrary<GEN: Gen>(g: &mut GEN) -> (A, B, C, D, E, F, G, H)

fn shrink(&self) -> Box<Iterator<Item = (A, B, C, D, E, F, G, H)>>

impl<A: Arbitrary> Arbitrary for Vec<A>

fn arbitrary<G: Gen>(g: &mut G) -> Vec<A>

fn shrink(&self) -> Box<Iterator<Item = Vec<A>>>

impl<K: Arbitrary + Ord, V: Arbitrary> Arbitrary for BTreeMap<K, V>

fn arbitrary<G: Gen>(g: &mut G) -> BTreeMap<K, V>

fn shrink(&self) -> Box<Iterator<Item = BTreeMap<K, V>>>

impl<K: Arbitrary + Eq + Hash, V: Arbitrary, S: BuildHasher + Default + Clone + Send + 'static> Arbitrary for HashMap<K, V, S>

fn arbitrary<G: Gen>(g: &mut G) -> Self

fn shrink(&self) -> Box<Iterator<Item = Self>>

impl<T: Arbitrary + Ord> Arbitrary for BTreeSet<T>

fn arbitrary<G: Gen>(g: &mut G) -> BTreeSet<T>

fn shrink(&self) -> Box<Iterator<Item = BTreeSet<T>>>

impl<T: Arbitrary + Ord> Arbitrary for BinaryHeap<T>

fn arbitrary<G: Gen>(g: &mut G) -> BinaryHeap<T>

fn shrink(&self) -> Box<Iterator<Item = BinaryHeap<T>>>

impl<T: Arbitrary + Eq + Hash, S: BuildHasher + Default + Clone + Send + 'static> Arbitrary for HashSet<T, S>

fn arbitrary<G: Gen>(g: &mut G) -> Self

fn shrink(&self) -> Box<Iterator<Item = Self>>

impl<T: Arbitrary> Arbitrary for LinkedList<T>

fn arbitrary<G: Gen>(g: &mut G) -> LinkedList<T>

fn shrink(&self) -> Box<Iterator<Item = LinkedList<T>>>

impl<T: Arbitrary> Arbitrary for VecDeque<T>

fn arbitrary<G: Gen>(g: &mut G) -> VecDeque<T>

fn shrink(&self) -> Box<Iterator<Item = VecDeque<T>>>

impl Arbitrary for IpAddr

fn arbitrary<G: Gen>(g: &mut G) -> IpAddr

fn shrink(&self) -> Box<Iterator<Item = Self>>

impl Arbitrary for Ipv4Addr

fn arbitrary<G: Gen>(g: &mut G) -> Ipv4Addr

fn shrink(&self) -> Box<Iterator<Item = Self>>

impl Arbitrary for Ipv6Addr

fn arbitrary<G: Gen>(g: &mut G) -> Ipv6Addr

fn shrink(&self) -> Box<Iterator<Item = Self>>

impl Arbitrary for SocketAddr

fn arbitrary<G: Gen>(g: &mut G) -> SocketAddr

fn shrink(&self) -> Box<Iterator<Item = Self>>

impl Arbitrary for SocketAddrV4

fn arbitrary<G: Gen>(g: &mut G) -> SocketAddrV4

fn shrink(&self) -> Box<Iterator<Item = Self>>

impl Arbitrary for SocketAddrV6

fn arbitrary<G: Gen>(g: &mut G) -> SocketAddrV6

fn shrink(&self) -> Box<Iterator<Item = Self>>

impl Arbitrary for PathBuf

fn arbitrary<G: Gen>(g: &mut G) -> PathBuf

fn shrink(&self) -> Box<Iterator<Item = PathBuf>>

impl Arbitrary for OsString

fn arbitrary<G: Gen>(g: &mut G) -> OsString

fn shrink(&self) -> Box<Iterator<Item = OsString>>

impl Arbitrary for String

fn arbitrary<G: Gen>(g: &mut G) -> String

fn shrink(&self) -> Box<Iterator<Item = String>>

impl Arbitrary for char

fn arbitrary<G: Gen>(g: &mut G) -> char

fn shrink(&self) -> Box<Iterator<Item = char>>

impl Arbitrary for usize

fn arbitrary<G: Gen>(g: &mut G) -> usize

fn shrink(&self) -> Box<Iterator<Item = usize>>

impl Arbitrary for u8

fn arbitrary<G: Gen>(g: &mut G) -> u8

fn shrink(&self) -> Box<Iterator<Item = u8>>

impl Arbitrary for u16

fn arbitrary<G: Gen>(g: &mut G) -> u16

fn shrink(&self) -> Box<Iterator<Item = u16>>

impl Arbitrary for u32

fn arbitrary<G: Gen>(g: &mut G) -> u32

fn shrink(&self) -> Box<Iterator<Item = u32>>

impl Arbitrary for u64

fn arbitrary<G: Gen>(g: &mut G) -> u64

fn shrink(&self) -> Box<Iterator<Item = u64>>

impl Arbitrary for isize

fn arbitrary<G: Gen>(g: &mut G) -> isize

fn shrink(&self) -> Box<Iterator<Item = isize>>

impl Arbitrary for i8

fn arbitrary<G: Gen>(g: &mut G) -> i8

fn shrink(&self) -> Box<Iterator<Item = i8>>

impl Arbitrary for i16

fn arbitrary<G: Gen>(g: &mut G) -> i16

fn shrink(&self) -> Box<Iterator<Item = i16>>

impl Arbitrary for i32

fn arbitrary<G: Gen>(g: &mut G) -> i32

fn shrink(&self) -> Box<Iterator<Item = i32>>

impl Arbitrary for i64

fn arbitrary<G: Gen>(g: &mut G) -> i64

fn shrink(&self) -> Box<Iterator<Item = i64>>

impl Arbitrary for f32

fn arbitrary<G: Gen>(g: &mut G) -> f32

fn shrink(&self) -> Box<Iterator<Item = f32>>

impl Arbitrary for f64

fn arbitrary<G: Gen>(g: &mut G) -> f64

fn shrink(&self) -> Box<Iterator<Item = f64>>

impl<T: Arbitrary + Clone + PartialOrd> Arbitrary for Range<T>

fn arbitrary<G: Gen>(g: &mut G) -> Range<T>

fn shrink(&self) -> Box<Iterator<Item = Range<T>>>

impl<T: Arbitrary + Clone + PartialOrd> Arbitrary for RangeFrom<T>

fn arbitrary<G: Gen>(g: &mut G) -> RangeFrom<T>

fn shrink(&self) -> Box<Iterator<Item = RangeFrom<T>>>

impl<T: Arbitrary + Clone + PartialOrd> Arbitrary for RangeTo<T>

fn arbitrary<G: Gen>(g: &mut G) -> RangeTo<T>

fn shrink(&self) -> Box<Iterator<Item = RangeTo<T>>>

impl Arbitrary for RangeFull

fn arbitrary<G: Gen>(_: &mut G) -> RangeFull

fn shrink(&self) -> Box<Iterator<Item = Self>>

impl Arbitrary for Duration

fn arbitrary<G: Gen>(gen: &mut G) -> Self

fn shrink(&self) -> Box<Iterator<Item = Self>>

impl<A: Arbitrary> Arbitrary for Box<A>

fn arbitrary<G: Gen>(g: &mut G) -> Box<A>

fn shrink(&self) -> Box<Iterator<Item = Box<A>>>

impl<A: Arbitrary + Sync> Arbitrary for Arc<A>

fn arbitrary<G: Gen>(g: &mut G) -> Arc<A>

fn shrink(&self) -> Box<Iterator<Item = Arc<A>>>

Implementors