suitest

一个提供过程宏以便轻松设置测试钩子和配置测试状态的库。

示例

#![cfg(test)]

use suitest::{suite, suite_cfg};

#[suite(my_test_suite)]
#[suite_cfg(sequential = false, verbose = true)]
pub mod tests {
    use suitest::{after_all, after_each, before_all, before_each, cleanup};

    #[derive(Debug, Clone)]
    struct MyTestStruct {
        qux: usize,
    }

    #[cleanup]
    fn cleaning() {
        println!("cleaning");
    }

    #[before_all]
    async fn setup() -> (usize, MyTestStruct) {
        (420_usize, MyTestStruct { qux: 69 })
    }

    #[before_each]
    fn beach() -> (u8, String) {
        (69_u8, String::from("works"))
    }

    #[after_each]
    fn aeach(works: String) {
        assert_eq!(works, "works")
    }

    #[after_all]
    async fn teardown(bar: usize, my_stuff: MyTestStruct) {
        assert_eq!(bar, 420);
        assert_eq!(my_stuff.qux, 69);
    }

    #[test]
    fn works(works: String, foo: u8, bar: usize, my_stuff: MyTestStruct) {
        assert_eq!(works, "works");
        assert_eq!(foo, 69);
        assert_eq!(bar, 420);
        assert_eq!(my_stuff.qux, 69);
    }

    #[test]
    async fn works_too(works: String, foo: u8, bar: usize, my_stuff: MyTestStruct) {
        assert_eq!(works, "works");
        assert_eq!(foo, 69);
        assert_eq!(bar, 420);
        assert_eq!(my_stuff.qux, 69);
    }
}

工作原理

使用 suitest::suite 注解你想要作为测试套件的模块，你可以使用钩子注解其内部的函数。

使用 suitest::suite_cfg 注解并传递参数来配置套件。

像通常一样使用 #[test] 标记测试，suitest 将在测试套件结束时生成一个测试，该测试会运行整个套件。

可用的钩子有

• before_all
  • 在套件开始时运行
• before_each
  • 在套件中的每个测试之前运行
• after_each
  • 在套件中的每个测试之后运行
• after_all
  • 在套件全部通过后运行
• cleanup
  • 在测试失败后运行。理想情况下不应导致恐慌。

suitest 与异步函数一起工作，但依赖于 tokio，因此您需要在依赖项中包含它。任何钩子和测试都可以标记为异步，并且可以混合使用，即可以使用异步钩子与同步测试，反之亦然。

配置

suite_cfg 是可选的，并接受以下内容