19 unstable releases (3 breaking)

0.4.5 Sep 13, 2020
0.4.4 Sep 13, 2020
0.4.1 Aug 5, 2020
0.3.2 Aug 3, 2020
0.1.0 Jul 23, 2020

#117 in Testing

Download history 64/week @ 2021-07-03 58/week @ 2021-07-10 83/week @ 2021-07-17 146/week @ 2021-07-24 199/week @ 2021-07-31 30/week @ 2021-08-07 39/week @ 2021-08-14 47/week @ 2021-08-21 48/week @ 2021-08-28 17/week @ 2021-09-04 52/week @ 2021-09-11 35/week @ 2021-09-18 64/week @ 2021-09-25 72/week @ 2021-10-02 59/week @ 2021-10-09 66/week @ 2021-10-16

183 downloads per month

MIT license

25KB
337 lines

Declarative Testing Framework

github crates.io docs.rs build status

Demonstrate allows tests to be written without as a much repetitive code within the demonstrate! macro, which will generate the corresponding full tests.

This testing library is highly influenced by speculate.rs and ruspec which both take inspiration from RSpec.

The following new block definitions are utilized by Demonstrate:

  • before/after — A block of source code that will be included at the start or end of each test respectively in the current and nested describe/context blocks.

  • describe/contextdescribe and context are aliases for eachother. Specifies a new scope of tests which can contain a before and/or after block, nested describe/context blocks, and it/test blocks. These translate to Rust mod blocks, but also allow for shared test properties to be defined such as tests having outer attributes, being async, and having Return<()> types.

  • it/testit and test are aliases for eachother. Represents one test that translate to a Rust unit test.


Example

use demonstrate::demonstrate;

fn is_4() -> u8 {
    4
}

demonstrate! {
    describe "module" {
        use super::*;

        before {
            let four = 4;
        }

        #[should_panic]
        it "can fail" {
            assert!(four != 4)
        }

        test "is returnable" -> Result<(), &'static str> {
            if is_4() == four {
                Ok(())
            } else {
                Err("It isn't 4! :o")
            }
        }

        #[async_attributes::test]
        async context "asynchronous" {
            before {
                let is_4_task = async_std::task::spawn(async {
                    is_4()
                });
            }

            it "awaits" {
                assert_eq!(four, is_4_task.await)
            }
        }
    }
}

License

Licensed under MIT license.

Dependencies

~4.5MB
~130K SLoC