A strict, yet friendly mocking library for Rust 2018

Mockiato

Last update: Dec 30, 2022

Related tags

Overview

Mockiato

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:

Debug
Example: cargo run --example debug
Clone
Example: cargo test --example clone
Default
Example: cargo test --example default

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

A Rust library for calculating sun positions

sun A rust port of the JS library suncalc. Install Add the following to your Cargo.toml [dependencies] sun = "0.2" Usage pub fn main() { let unixti

36 Dec 28, 2022

A cross-platform serial port library in Rust.

Introduction serialport-rs is a general-purpose cross-platform serial port library for Rust. It provides a blocking I/O interface and port enumeration

143 Nov 5, 2021

A high level diffing library for rust based on diffs

Similar: A Diffing Library Similar is a dependency free crate for Rust that implements different diffing algorithms and high level interfaces for it.

617 Dec 30, 2022

A reactive DOM library for Rust in WASM

maple A VDOM-less web library with fine-grained reactivity. Getting started The recommended build tool is Trunk. Start by adding maple-core to your Ca

1.8k Jan 3, 2023

transmute-free Rust library to work with the Arrow format

Arrow2: Transmute-free Arrow This repository contains a Rust library to work with the Arrow format. It is a re-write of the official Arrow crate using

708 Dec 30, 2022

Cross-platform Window library in Rust for Tauri. [WIP]

Cross-platform application window creation library in Rust that supports all major platforms like Windows, macOS, Linux, iOS and Android. Built for you, maintained for Tauri.

899 Jan 1, 2023

A library in Rust for theorem proving with Intuitionistic Propositional Logic.

Prop Propositional logic with types in Rust. A library in Rust for theorem proving with Intuitionistic Propositional Logic. Supports theorem proving i

48 Jan 3, 2023

A Rust library for constructing tilings of regular polygons

tiling tiling is a library for constructing tilings of regular polygons and their dual tilings. Resources Documentation Tilings by regular polygons Li

29 Sep 30, 2021

miette is a diagnostic library for Rust. It includes a series of traits/protocols that allow you to hook into its error reporting facilities, and even write your own error reports!

1.2k Jan 1, 2023

Comments

Support mocking foreign-defined traits

Seems pretty easy-- probably just an extra annotation to indicate that the trait definition itself should be omitted from the generated code, and only the mocks should be kept.
effort-13 feature

opened by cramertj 6
Release 0.4.0
Prepare the release

[x] Bump the version numbers

[x] Update dependency versions for neighbouring crates

[x] Create a pull request

Perform the release

[x] Merge the pull request

[x] Run cargo publish

[x] Tag the merge commit (e.g. '0.1.2')
opened by jeremystucki 1

Make mocks cloneable

We should make mocks cloneable to allow traits like the following to be mocked.

 pub trait Greeter: GreeterClone {
    fn greeter(&self, name: &str) -> String;
 }

 pub trait GreeterClone {
     fn clone_box(&self) -> Box<dyn Greeter>;
 }

 impl<T> GreeterClone for T
 where
     T: Greeter + Clone + 'static,
 {
     default fn clone_box(&self) -> Box<dyn Greeter> {
         Box::new(self.clone())
     }
 }

It might make sense to put everything in the mock inside an Rc. This would mean that the method calls of the cloned instances are shared and are verified only once the last instance is dropped.

enhancement effort-5

opened by bash 1

Allow references to generics

The current implementation of generics on traits (PR #118) explicitly disallows this due to issues with the generic type parameter outliving the reference.

The current Arguments / ArgumentsMatcher setup doesn't allow this as far as I can tell, so we might need to rethink that.
enhancement on hold

opened by bash 1

Releases(0.9.5)

0.9.5(Oct 12, 2019)
Fix uses of specialization for latest nightly.

Source code(tar.gz)
Source code(zip)
0.9.4(Oct 1, 2019)

No changes.
Source code(tar.gz)
Source code(zip)
0.9.3(Sep 30, 2019)

No changes.
Source code(tar.gz)
Source code(zip)
0.9.2(Sep 27, 2019)
No changes

Source code(tar.gz)
Source code(zip)
0.9.1(Aug 30, 2019)
Update syn to version 1.0

Update quote to version 1.0

Update proc-macro2 to version 1.0

Links to the repository have been updated to point to mockiato/mockiato.

Source code(tar.gz)
Source code(zip)
0.9.0(Jul 12, 2019)
Foreign-defined traits can be mocked using #[mockable(remote = "...")].

Source code(tar.gz)
Source code(zip)
0.8.0(Jun 17, 2019)
Allow specifying one-time return values (that do not need to be Clone) by using .returns_once(value).

Source code(tar.gz)
Source code(zip)
0.7.0(May 30, 2019)
Support for stable rust has been added. (See disclaimer in readme)

Dependencies have been updated.

Source code(tar.gz)
Source code(zip)
0.6.3(May 24, 2019)
A typo in the documentation has been fixed.

Source code(tar.gz)
Source code(zip)
0.6.2(May 17, 2019)
Quickstart example in the readme has been fixed.

Source code(tar.gz)
Source code(zip)
0.6.1(May 17, 2019)
Added nightly notice to readme.

Updated crate description, keywords, categories and badges.

Source code(tar.gz)
Source code(zip)
0.6.0(May 16, 2019)
Breaking: The expect_* methods now require passing a closure for each argument that receives a factory to create argument matchers. This has been changed so that crates using mocks from another crate no longer need to depend on the same version of mockiato.

Breaking: It is now a hard error when name is specified more than once in the #[mockable] attribute.

The Display implementation of some argument matchers has been improved.

A lot of documentation has been added.

Source code(tar.gz)
Source code(zip)
0.5.1(May 6, 2019)
The Debug impl for mocks of traits with generic type params no longer requires that the generic types implements Debug.

Source code(tar.gz)
Source code(zip)
0.5.0(Apr 29, 2019)
Generic type parameters on traits are now supported. Parameters with references that contain generic type parameters are explicitly disallowed.

Full ranges (..) can be passed to .times()

Source code(tar.gz)
Source code(zip)
0.4.2(Apr 22, 2019)
Fix error with parse_quote! macro when patch version of syn is too low in consumers Cargo.lock.

Source code(tar.gz)
Source code(zip)
0.4.1(Apr 22, 2019)
The Debug implementation of an argument's type is now correctly used when printing the expected calls for a method.

Internal types now have separate Debug and Display implementations.

Some unused exports have been removed from mockiato::internal. This is treated as a non-breaking change as no consumer should directly depend on these types.

Source code(tar.gz)
Source code(zip)
0.4.0(Apr 1, 2019)
Ordered expectations are now available using mock.expect_<method_name>_calls_in_order()

Source code(tar.gz)
Source code(zip)
0.3.0(Apr 1, 2019)
ExpectedCalls::any() has been removed. Use the range 0.. instead.

Support for nearly equals expectations has been added. (nearly_eq and nearly_eq_with_accuracy)

Source code(tar.gz)
Source code(zip)
0.2.1(Mar 1, 2019)

Source code(tar.gz)
Source code(zip)
0.2.0(Mar 1, 2019)
Mocks now have a lifetime ('mock) which allows mocks to contain non-static references.

To revert to the old behaviour (only static references) there is a new attribute for that: #[mockable(static_references)].

Source code(tar.gz)
Source code(zip)
0.1.0(Mar 1, 2019)

Source code(tar.gz)
Source code(zip)

Owner

Mockiato

A strict, yet friendly mocking library for Rust 2018

GitHub

A strict, yet friendly mocking library for Rust 2018

Related tags

Overview

Mockiato

⚠️ Disclaimer for working with stable rust

Quickstart

Trait Bounds

Downcasting

Contributing

Enable debug impls in codegen

You might also like...

A Rust library for calculating sun positions

A cross-platform serial port library in Rust.

A high level diffing library for rust based on diffs

A reactive DOM library for Rust in WASM

transmute-free Rust library to work with the Arrow format

Cross-platform Window library in Rust for Tauri. [WIP]

A library in Rust for theorem proving with Intuitionistic Propositional Logic.

A Rust library for constructing tilings of regular polygons

miette is a diagnostic library for Rust. It includes a series of traits/protocols that allow you to hook into its error reporting facilities, and even write your own error reports!

Comments

Support mocking foreign-defined traits

Release 0.4.0

Prepare the release

Perform the release

Make mocks cloneable

Allow references to generics

Releases(0.9.5)

0.9.5(Oct 12, 2019)

0.9.4(Oct 1, 2019)

0.9.3(Sep 30, 2019)

0.9.2(Sep 27, 2019)

0.9.1(Aug 30, 2019)

0.9.0(Jul 12, 2019)

0.8.0(Jun 17, 2019)

0.7.0(May 30, 2019)

0.6.3(May 24, 2019)

0.6.2(May 17, 2019)

0.6.1(May 17, 2019)

0.6.0(May 16, 2019)

0.5.1(May 6, 2019)

0.5.0(Apr 29, 2019)

0.4.2(Apr 22, 2019)

0.4.1(Apr 22, 2019)

0.4.0(Apr 1, 2019)

0.3.0(Apr 1, 2019)

0.2.1(Mar 1, 2019)

0.2.0(Mar 1, 2019)

0.1.0(Mar 1, 2019)

Owner

Mockiato

This library provides a stable polyfill for Rust's Strict Provenance experiment.

Watches changes in a rust project, runs test and shows friendly notification

🐦 Friendly little instrumentation profiler for Rust 🦀

Rust Util Collection, a simple and friendly error-chain

Rust Util Collection, a simple and friendly error-chain, with many useful utils as an addition.

Minimal, flexible & user-friendly X and Wayland tiling window manager with rust

Byte is a blazingly fast🚀 Discord Bot with a user-friendly design using twilight written in rust🦀.

Yet another geter/setter derive macro.

dbt Cloud™️ infrastructure-as-code that is friendly to analysts

A library to compile USDT probes into a Rust library