An RSpec inspired minimal testing framework for Rust. (This is an updated and partially rewritten fork for Rust 2021, with updated dependencies and removed unstable functionality.)
Originally developed by Utkarsh Kukreti.
Add speculate
to the dev-dependencies
section of your Cargo.toml
:
[dev-dependencies]
speculate2 = "0.2"
And add the following to the top of the Rust file you want to add tests for:
#[cfg(test)]
use speculate2::speculate; // Must be imported into the current scope.
Speculate provides the speculate!
syntax extension.
Inside speculate! { ... }
, you can have any "Item", like static
, const
,
fn
, etc, and 5 special types of blocks:
-
describe
(or its aliascontext
) - to group tests in a hierarchy, for readability. Can be arbitrarily nested. -
before
andafter
- contain setup / teardown code that's inserted before / after every sibling and nestedit
block. -
it
(or its aliastest
) - contains tests.For example:
it "can add 1 and 2" { assert_eq!(1 + 2, 3); }
You can optionally add attributes to this block:
#[ignore] test "ignore" { assert_eq!(1, 2); } #[should_panic] test "should panic" { assert_eq!(1, 2); } #[should_panic(expected = "foo")] test "should panic with foo" { panic!("foo"); }
Licensed same as the original repository, under MIT License. A copy can be found in the repo root.