#testing #default #unit-testing

default-test

A default trait that can be used in tests

2 releases

0.1.1 Jan 6, 2021
0.1.0 Jan 6, 2021

#2690 in Rust patterns

45 downloads per month

MIT license

9KB
93 lines

default-test-rs

Provides a Rust trait similar to Default that can be used in tests.

Often tests need to construct mock instances of structs. For example:

struct User {
    id: usize,
    name: String,
    email: String,
    admin: bool
}

While it's tempting to define Default, often tests need mock values for types that shouldn't apply in production code. Sometimes, tests need values for types that don't even implement Default.

This crate provides DefaultTest, a trait which can provide default instances with mock values.

impl DefaultTest for User {
    fn default_test() -> Self {
        User {
            id: 0,
            name: "name".into(),
            email: "email".into(),
            admin: false
        }
    }
}

Unit tests can then use the spread operator to construct values:

mod tests {
    #[test]
    fn test() {
        let user = User {
            id: 99
            ..User::test_default()
        };
        // ...
    }
}

Roadmap:

  • Derive macro which fills sensible defaults that would be useful in unit test implementations. String files would be filled with their property name, and other types may use T::default() or unique values.

No runtime deps