assay - 一款强大的 Rust 测试宏

as·say /ˈaˌsā,aˈsā/ 名词 - 对金属或矿石进行试验，以确定其成分和品质。

Rust 语言很棒，但有时测试功能还有待完善。由于自定义测试框架不稳定，且自2018年以来只有eRFC，我们很难扩展测试功能，对吧？那么，这就是assay出现的地方。它旨在解决 Rust 测试中的几个问题

• 所有测试都在同一个进程中运行，这意味着设置环境变量或更改工作目录会影响所有测试，因此你必须求助于像 cargo test -- --test-threads=1 这样的方法，或者使用某种互斥锁，这会导致你失去并行运行测试套件的能力
• 设置临时文件系统以运行测试，并在其中运行测试，设置起来很麻烦，并且使用 std::env::set_working_dir 设置工作目录很容易遇到上述问题
• 在测试中包含设置，更不用说多个设置了，会变得有点冗长
• 为每个测试设置和拆除相同的东西会花费很多时间
• 想要运行 async 测试吗？没有运行时，你不得不进行设置才能运行它。
• 在测试中使用 ? 意味着在每次测试中都放置 -> Result<(), Box<dyn std::error::Error>>，这可能会很繁琐
• assert_eq/assert_ne 的输出可能难以理解，难以看到为什么某物相等或不相等

assay 通过以下方式解决这些问题：

• 如果您使用 cargo test 或 cargo nextest 运行测试，则会自动将每个测试作为单独的进程运行。这意味着您可以为每个进程状态进行任意修改，而不会影响其他测试，并且始终可以并行运行测试。
• 设置每个进程的 env 变量
• 为测试设置一个临时目录（类似于 chroot，但没有监狱方面的问题，也不需要 sudo 权限）
• 通过指定文件将您想要的文件包含到临时目录中
• 允许您通过在测试函数中添加 async 来运行异步测试
• 使所有测试都表现得像返回 Result<(), Box<dyn std::error::Error>>。您可以使用 ?，无需为每个测试添加 Eye of Sauron (Ok(()))。
• 自动导入 pretty_assertions 包，以便您可以为 assert_eq 和 assert_ne 获得格式化的输出
• 允许您定义设置和清理函数以在测试中调用