insta 0.1.0

A snapshot testing library for Rust

Insta

Insta is a simple snapshot testing library for Rust.

This crate exports two basic macros for snapshot testing: assert_snapshot_matches! for comparing basic string snapshots and assert_debug_snapshot_matches! for snapshotting the debug print output of a type. Additionally if the serialization feature is enabled the assert_serialized_snapshot_matches! macro becomes available which serializes an object with serde to yaml before snapshotting.

Snapshots are stored in the snapshots folder right next to the test file where this is used. The name of the file is <module>__<name>.snap where the name of the snapshot has to be provided to the assertion macro.

To update the snapshots export the INSTA_UPDATE environment variable and set it to 1. The snapshots can then be committed.

Example

use insta::assert_debug_snapshot_matches;

#[test]
fn test_snapshots() {
    let value = vec![1, 2, 3];
    assert_debug_snapshot_matches!("snapshot_name", value);
}

The recommended flow is to run the tests once, have them fail and check if the result is okay. Once you are satisifed run the tests again with INSTA_UPDATE set to 1 and updates will be stored:

$ INSTA_UPDATE=1 cargo test