Crate beaver

This crate is a library for setting up Rust objects inspired by factory_bot.

Dependencies

[dependencies]
beaver = "1"
serde = { version = "1.0", features = ["derive"] }

If you want to use chrono for your struct fields, Cargo.toml would look like this.

[dependencies]
beaver = "1"
serde = { version = "1.0", features = ["derive"] }
# you need `serde` feature.
chrono = { version = "0.4", features = ["serde"] }

Examples

Define a factory

use serde::{Deserialize, Serialize};

// Your struct needs both of `Serialize` and `Deserialize`.
#[derive(Serialize, Deserialize)]
struct Post {
    id: u16,
    title: String,
    approved: bool,
}

beaver::define! {
    PostFactory (Post) {
        // n is a sequence number.
        id -> |n| n,
        title -> |n| format!("{}", n),
        approved -> |_| false,
    }
}

If you want to use factories outside modules, you need to make factories public. For more information, please see this example.

You can use the following functions in factory definition.

• sequence: If you want to use a sequence number, you can use this function.
• sequence_a: If you want to use a sequence letter, you can use this function.

Build structs

use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize, Debug)]
struct Post {
    id: u16,
    title: String,
    approved: bool,
}

beaver::define! {
    PostFactory (Post) {
        id -> |n| n,
        title -> |n| format!("{}", n),
        approved -> |_| false,
    }
}

impl Post {
    pub fn something(self) -> String {
        self.title
    }
}

#[cfg(test)]
mod tests {
    #[test]
    fn test_something() {
        use crate::factory::PostFactory;

        let post_factory = PostFactory::new();
        let post1 = post_factory.build(|_| {});
        let post2 = post_factory.build(|_| {});
        // override attributes of a factory
        let post3 = post_factory.build(|post| {
            post.id = 1024;
            post.title = "foo bar".to_string()
        });

        assert_eq!(post1.something(), "post-1");
        assert_eq!(post2.something(), "post-2");
        assert_eq!(post3.something(), "foo bar");
    }
}

Macros

define

Defines a Factory.

Structs

Factory

Functions

sequence

Returns a consecutive term. from is the first term.

sequence_a

Returns a consecutive letter. from is the first letter.