Struct Factory 

pub struct Factory<M> { /* private fields */ }

Builds models for a test.

Implementations

impl<M> Factory<M>

pub fn new(make: impl Fn(usize) -> M + Send + Sync + 'static) -> Self

Build each model with make, which is handed the row’s index.

pub fn count(self, count: usize) -> Self

How many to build.

pub fn state(self, state: impl Fn(&mut M) + Send + Sync + 'static) -> Self

Adjust every model this factory builds.

The field the test is actually about. Applied in the order added, after the base model is built.

pub fn sequence( self, state: impl Fn(&mut M, usize) + Send + Sync + 'static, ) -> Self

Adjust each model, knowing which one it is.

For anything that has to differ between rows — a unique email, an ordering, a timestamp that has to be distinct.

pub fn make(&self) -> Vec<M>

Build them, without touching a database.

For a test about a pure function, a serialiser or a policy — none of which need a row to exist anywhere.

pub fn make_one(&self) -> M

Build exactly one.

Panics

Never — count is ignored and one is built.

impl<M: Model> Factory<M>

pub async fn create(&self, repository: &dyn Repository<M>) -> Result<Vec<M>>

Build them and insert them.

Returns what the repository returned — so a database-assigned key is on the model a test goes on to use, rather than the zero it was built with.

pub async fn create_one(&self, repository: &dyn Repository<M>) -> Result<M>

Build one and insert it.

Trait Implementations

impl<M> Clone for Factory<M>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<M> Debug for Factory<M>

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

Formats the value using the given formatter.