声明式测试框架

Demonstrate 允许在 demonstrate! 宏中编写测试，而无需重复代码，该宏将生成相应的完整测试。

此测试库深受 speculate.rs 和 ruspec 的影响，这两个库都受到了 RSpec 的启发。

Demonstrate 使用以下新的代码块定义：

• before/after — 在当前和嵌套的 describe/context 块的开始或结束时包含的源代码块。

• describe/context — describe 和 context 是彼此的别名。指定一个新的测试范围，可以包含一个 before 和/或 after 块，嵌套的 describe/context 块，以及 it/test 块。这些转换为 Rust mod 块，但还可以定义共享的测试属性，例如测试具有外部属性、异步执行以及具有 Return<()> 类型。

• it/test — it 和 test 是彼此的别名。代表一个测试，转换为 Rust 单元测试。

示例

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)
            }
        }
    }
}

许可证