测试每个文件

轻松为指定目录中的文件生成测试，实现全面测试。

以下是一个宏的简单示例

test_each_file! { in "./resources" => test }

fn test(content: &str) {
    // Make assertions on the `content` of the file here.
}

假设以下文件结构

- resources
  - a.txt
  - b.txt
  - extra
    - c.txt
- src
  - main.rs

宏展开为

#[test]
fn a() {
    // The macro actually uses an absolute path for `a.txt` behind the scenes
    test(include_str!("../resources/a.txt"))
}

#[test]
fn b() {
    test(include_str!("../resources/b.txt"))
}

mod extra {
    use super::*;

    #[test]
    fn c() {
        test(include_str!("../resources/extra/c.txt"))
    }
}

生成子模块

可以使用 as 关键字将测试自动插入模块中。例如

test_each_file! { in "./resources" as example => test }

这将把上面的测试包装在额外的 mod example { ... } 中。当在单个文件中多次使用 test_each_file! 时，此功能很有用，以防止生成的测试具有相同的名称。

文件分组

有时可能更希望编写一个测试，该测试以多个文件的内容作为输入。这种情况的一个常见用例是测试一个将给定输入（.in 文件）转换为输出（.out 文件）的函数。

test_each_file! { for ["in", "out"] in "./resources" => test }

fn test([input, output]: [&str; 2]) {
    // Make assertions on the content of the `input` and `output` files here.
}

`.in` 和 `.out` 文件都必须存在，并且位于同一目录中，如下所示

- resources
  - a.in
  - a.out
  - b.in
  - b.out
  - extra
    - c.in
    - c.out
- src
  - main.rs

请注意，`.in` 和 `.out` 在这里只是示例 - 可以提供任意类型的任意数量的唯一扩展名。

测试每个路径

存在一个类似的宏，用于传递给定目录中的所有路径。该宏的行为与 `test_each_file!` 相同，但它传递文件的路径而不是内容。通常，使用 `test_each_file!` 更好，因为它将文件包含在二进制文件中，而 `test_each_path!` 在运行时仍然需要路径。

test_each_path! { for ["in", "out"] in "./resources" => test }

fn test([input, output]: [&Path; 2]) {
    // Make assertions on the path of `input` and `output` here.
}

更多示例

对每个文件调用的表达式也可以是一个闭包，例如

test_each_file! { in "./resources" => |c: &str| assert!(c.contains("Hello World")) }

所有上述选项都可以组合，例如

test_each_file! { for ["in", "out"] in "./resources" as example => |[a, b]: [&str; 2]| assert_eq!(a, b) }