将 defmt-test 添加到现有项目中

如果您想将 defmt-test 添加到现有的 Cargo 项目/包中，对于您想要测试的每个 crate，您需要在 Cargo.toml 中进行以下更改

• 将 defmt-test 添加为 dev-dependency
• 对于您想要测试的每个 crate，将 harness 设置为 false 以禁用默认测试 harness，即依赖于 std 的 test crate。以下是一些示例

# Cargo.toml

# for the library crate (src/lib.rs)
[lib]
harness = false

# for each crate in the `tests` directory
[[test]]
name = "test-name" # tests/test-name.rs
harness = false

[[test]]
name = "second" # tests/second.rs
harness = false

需要注意的是，cargo test 会编译包或 workspace 中的 所有 crate。这可能包括您不想测试的 crate，例如 src/main.rs 或 src/bin 或 examples 中的每个 crate。要确定 cargo test 正在编译哪些 crate，请运行 cargo test -j1 -v 并查找每个 rustc 调用传递的 --crate-name 标志。

要仅测试包/工作空间中的一部分 crate，您有两个选择

• 您可以在调用 cargo test 时指定每个 crate。例如，cargo test --lib --test integration 测试了两个 crate：库 crate（《code>src/lib.rs）和 tests/integration.rs
• 您还可以禁用您不想测试的 crate 的测试 - 以下是一个示例 - 然后您可以使用 cargo test 来测试所有未禁用的 crate。

如果您有这种项目结构

$ tree .
.
├── Cargo.toml
├── src
│  ├── lib.rs
│  └── main.rs
└── tests
   └── integration.rs

并且已将 src/lib.rs 设置为测试，但不想测试 src/main.rs，您需要禁用 src/main.rs 的测试

# Cargo.toml
[package]
# ..
name = "app"

[[bin]] # <- add this section
name = "app" # src/main.rs
test = false

添加状态

可以在 #[tests] 模块中编写 #[init] 函数。此函数将在所有单元测试之前执行，其返回值（测试套件 状态）可以作为参数传递给单元测试。

// state shared across unit tests
struct MyState {
    flag: bool,
}

#[defmt_test::tests]
mod tests {
    #[init]
    fn init() -> super::MyState {
        // state initial value
        super::MyState {
            flag: true,
        }
    }

    // This function is called before each test case.
    // It accesses the state created in `init`,
    // though like with `test`, state access is optional.
    #[before_each]
    fn before_each(state: &mut super::MyState) {
        defmt::println!("State flag before is {}", state.flag);
    }

    // This function is called after each test
    #[after_each]
    fn after_each(state: &mut super::MyState) {
        defmt::println!("State flag after is {}", state.flag);
    }

    // this unit test doesn't access the state
    #[test]
    fn assert_true() {
        assert!(true);
    }

    // but this test does
    #[test]
    fn assert_flag(state: &mut super::MyState) {
        assert!(state.flag)
        state.flag = false;
    }
}

$ cargo test -p testsuite
0.000000 (1/2) running `assert_true`...
└─ integration::tests::__defmt_test_entry @ tests/integration.rs:37
0.000001 State flag before is true
└─ integration::tests::before_each @ tests/integration.rs:26
0.000002 State flag after is true
└─ integration::tests::after_each @ tests/integration.rs:32
0.000003 (2/2) running `assert_flag`...
└─ integration::tests::__defmt_test_entry @ tests/integration.rs:43
0.000004 State flag before is true
└─ integration::tests::before_each @ tests/integration.rs:26
0.000005 State flag after is false
└─ integration::tests::after_each @ tests/integration.rs:32
0.000006 all tests passed!
└─ integration::tests::__defmt_test_entry @ tests/integration.rs:11

测试结果

测试函数可以返回 () 并在失败时 panic，或者返回任何实现了 TestOutcome 特性的类型，例如 Result。