#factory #fixture #test #define

macro factori-impl

You shouldn't use this crate directly. It's internal to factori.

4 releases (2 stable)

1.1.0 Aug 14, 2020
1.0.0 Jan 15, 2020
0.1.1 Jan 8, 2020
0.1.0 May 18, 2019

#19 in #fixture

Download history 887/week @ 2024-05-22 716/week @ 2024-05-29 898/week @ 2024-06-05 1019/week @ 2024-06-12 1497/week @ 2024-06-19 1815/week @ 2024-06-26 1233/week @ 2024-07-03 1121/week @ 2024-07-10 978/week @ 2024-07-17 926/week @ 2024-07-24 1032/week @ 2024-07-31 946/week @ 2024-08-07 539/week @ 2024-08-14 1047/week @ 2024-08-21 778/week @ 2024-08-28 634/week @ 2024-09-04

3,107 downloads per month
Used in factori

MIT license

14KB
356 lines

Factori Build Status Crates.io Docs.rs

A testing factory library for Rust, inspired by FactoryBot. 🤖 🦀

Factori makes it easy to instantiate your test objects/fixtures in tests while providing an ergonomic syntax for defining how they are instantiated.

Factori works on stable Rust >=1.45.

Documentation

See API documentation.

Example

Factori provides two macros: factori!, which defines a factory for a type, and create! which instantiates it:

#[macro_use]
extern crate factori;

pub struct Vehicle {
    number_wheels: u8,
    electric: bool,
}

factori!(Vehicle, {
    default {
        number_wheels = 4,
        electric = false,
    }

    mixin bike {
        number_wheels = 2,
    }
});

fn main() {
    let default = create!(Vehicle);
    assert_eq!(default.number_wheels, 4);
    assert_eq!(default.electric, false);

    // Its type is Vehicle, nothing fancy:
    let vehicle: Vehicle = default;

    let three_wheels = create!(Vehicle, number_wheels: 3);
    assert_eq!(three_wheels.number_wheels, 3);

    let electric_bike = create!(Vehicle, :bike, electric: true);
    assert_eq!(electric_bike.number_wheels, 2);
    assert_eq!(electric_bike.electric, true);
}

More examples are available in the tests/ directory.

Testing

Run:

cargo test

License

MIT

Dependencies

~1.5MB
~36K SLoC