#mocking #codegen #diagnostics #friendly #stable #order #mockiato

macro mockiato-codegen

Internally used by mockiato for code generation. This crate should never be used directly

18 releases (8 breaking)

0.9.5 Oct 12, 2019
0.9.3 Sep 30, 2019
0.9.0 Jul 12, 2019
0.3.0 Mar 22, 2019

#60 in #friendly

Download history 128/week @ 2023-11-23 58/week @ 2023-11-30 68/week @ 2023-12-07 66/week @ 2023-12-14 64/week @ 2023-12-21 40/week @ 2023-12-28 51/week @ 2024-01-04 63/week @ 2024-01-11 55/week @ 2024-01-18 47/week @ 2024-01-25 44/week @ 2024-02-01 50/week @ 2024-02-08 69/week @ 2024-02-15 76/week @ 2024-02-22 74/week @ 2024-02-29 51/week @ 2024-03-07

277 downloads per month
Used in 2 crates (via mockiato)

MIT license

85KB
2.5K SLoC

Mockiato

Build Status Latest Version Documentation dependency status Changelog

A strict, yet friendly mocking library for Rust 2018

⚠️ Disclaimer for working with stable rust

Mockiato relies on the unstable proc_macro_diagnostics API to print helpful messages and the unstable specialization feature to be able to print expected calls.

Mocks work as expected on stable rust, but diagnostics are very limited.
We recommend re-running failing tests using nighly rust in order to pin-point the issue.

Quickstart

#[cfg(test)]
use mockiato::mockable;

#[cfg_attr(test, mockable)]
trait Greeter {
    fn greet(&self, name: &str) -> String;
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn greet_the_world() {
        let mut greeter = GreeterMock::new();

        greeter
            .expect_greet(|arg| arg.partial_eq("world"))
            .times(1..2)
            .returns(String::from("Hello world"));

        assert_eq!("Hello world", greeter.greet("world"));
    }
}

Trait Bounds

Trait bounds are currently not supported meaning that the supertraits will not be implemented for mocks.

The following traits are always implemented for mocks:

Downcasting

An example of how to use downcasting with mockiato can be found in the downcasting example.

Contributing

Enable debug impls in codegen

cargo test --features mockiato-codegen/debug-impls

lib.rs:

Codegen for mockiato. Do not use this crate directly.

Dependencies

~2MB
~41K SLoC