2 unstable releases

Uses old Rust 2015

0.2.0 Mar 21, 2018
0.1.0 Mar 19, 2018

#63 in #snapshot

MIT/Apache

260KB
387 lines

snaptest

CircleCI branch AppVeyor branch Crates.io

Dead simple snapshot testing (inspired by jest).

Documentation (including this README) is a work in progress. Feel free to submit an issue if you have a question about usage.

Features

  • Any type that implements Debug can be returned from a test.
  • First class integration with failure.
  • The snapshot store is thread safe so your tests can run in parallel.
  • Beautiful diffs are printed when a snapshot test fails.
  • A single small binary file is used to store snapshots.

TODO

Installation

First, add snaptest to the dependencies section of your Cargo.toml:

[dependencies]
snaptest = "0.1"

Next, add the following snippet to the entry point of your crate (lib.rs or main.rs):

#[macro_use]
extern crate snaptest;

Usage

Derive Debug on types that you want to use with snaptest:

use std::str::FromStr;

#[derive(Debug)]
pub struct User {
    connection: Connection,
    name: String,
}

#[derive(Debug)]
pub enum Connection {
    Online,
    Offline,
}

impl FromStr for User {
  // ...
}

Now, in the test module for the User struct:

snaptest!{
    fn parse_user() -> Result<User, Error> {
        "Zak:online".parse()
    }
}

Next time your test runs, a snapshot will be added to a local .snapfile to compare against future test results. If you get a different result back than what matches the snapshot, the test will fail and the diff will be printed to the console.

Snaptest Example

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.5–1MB
~16K SLoC