defmt-test

https://docs.rs/crate/defmt-test/
Admin
defmt-test is a test harness for embedded devices, enabling developers to write and run unit tests...
Tokens:191,395
Snippets:395
Trust Score:9.7
Update:1 year ago
Show doc for...
Tokens:
Raw
### Basic Usage Example

Source: https://docs.rs/crate/defmt-test/0.2.2/source/README

Demonstrates the basic usage of defmt-test by running unit tests on an embedded device. It shows the expected console output, including test execution and potential panics.

```console
$ cargo test -p testsuite
(..)
0.000000 INFO  (1/2) running `assert_true`...
└─ test::tests::__defmt_test_entry @ tests/test.rs:7
0.000001 INFO  (2/2) running `assert_false`...
└─ test::tests::__defmt_test_entry @ tests/test.rs:7
0.000002 ERROR panicked at 'TODO: write actual tests', testsuite/tests/test.rs:16:9
└─ panic_probe::print_defmt::print @ (..omitted..)
stack backtrace:
   0: HardFaultTrampoline
      <exception entry>
   1: __udf
      <exception entry>
   2: cortex_m::asm::udf
        at (..omitted..)
   3: rust_begin_unwind
        at (..omitted..)
   4: core::panicking::panic_fmt
        at (..omitted..)
   5: core::panicking::panic
        at (..omitted..)
   6: test::tests::assert_false
        at tests/test.rs:16
   7: main
        at tests/test.rs:7
   8: ResetTrampoline
        at (..omitted..)
   9: Reset
        at (..omitted..)

```

--------------------------------

### Run defmt-test Documentation Build

Source: https://docs.rs/crate/defmt-test/0.4.0/builds/2395151/i686-pc-windows-msvc

This snippet demonstrates starting a Docker container to execute the previously created build command. It ensures the build process runs within a controlled environment, capturing standard output and error streams.

```Shell
docker start -a fb91c860db5f539afd48687c45bc7cc005432f670dbf28e0f2c79672535522f7
```

--------------------------------

### Running Integration Tests with defmt-test

Source: https://docs.rs/crate/defmt-test/0.4.0/source/README

Illustrates how to execute integration tests using `cargo test --test integration`. The example output includes test execution, error reporting for failed tests, and a stack trace.

```console
$ cargo test --test integration
(..)
0.000000 INFO  (1/2) running `assert_true`...
└─ test::tests::__defmt_test_entry @ tests/test.rs:7
0.000001 INFO  (2/2) running `assert_false`...
└─ test::tests::__defmt_test_entry @ tests/test.rs:7
0.000002 ERROR panicked at 'TODO: write actual tests', testsuite/tests/test.rs:16:9
└─ panic_probe::print_defmt::print @ (..omitted..)
stack backtrace:
   0: HardFaultTrampoline
      <exception entry>
   1: __udf
   2: cortex_m::asm::udf
        at (..omitted..)
   3: rust_begin_unwind
        at (..omitted..)
   4: core::panicking::panic_fmt
        at (..omitted..)
   5: core::panicking::panic
        at (..omitted..)
   6: test::tests::assert_false
        at tests/test.rs:16
   7: main
        at tests/test.rs:7
   8: ResetTrampoline
        at (..omitted..)
   9: Reset
        at (..omitted..)
```

--------------------------------

### Running Integration Tests with defmt-test

Source: https://docs.rs/crate/defmt-test/latest/source/README

Illustrates how to execute integration tests using `cargo test --test integration`. The example output includes test execution, error reporting for failed tests, and a stack trace.

```console
$ cargo test --test integration
(..)
0.000000 INFO  (1/2) running `assert_true`...
└─ test::tests::__defmt_test_entry @ tests/test.rs:7
0.000001 INFO  (2/2) running `assert_false`...
└─ test::tests::__defmt_test_entry @ tests/test.rs:7
0.000002 ERROR panicked at 'TODO: write actual tests', testsuite/tests/test.rs:16:9
└─ panic_probe::print_defmt::print @ (..omitted..)
stack backtrace:
   0: HardFaultTrampoline
      <exception entry>
   1: __udf
   2: cortex_m::asm::udf
        at (..omitted..)
   3: rust_begin_unwind
        at (..omitted..)
   4: core::panicking::panic_fmt
        at (..omitted..)
   5: core::panicking::panic
        at (..omitted..)
   6: test::tests::assert_false
        at tests/test.rs:16
   7: main
        at tests/test.rs:7
   8: ResetTrampoline
        at (..omitted..)
   9: Reset
        at (..omitted..)
```

--------------------------------

### Console: Defmt-test Execution Output

Source: https://docs.rs/crate/defmt-test/latest/source/README

Example output from running defmt-test with cargo. Shows the execution of tests, including the before_each and after_each hooks, and the final test results.

```console
$ 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
```

--------------------------------

### Console: Defmt-test Execution Output

Source: https://docs.rs/crate/defmt-test/0.4.0/source/README

Example output from running defmt-test with cargo. Shows the execution of tests, including the before_each and after_each hooks, and the final test results.

```console
$ 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
```

--------------------------------

### Running Integration Tests with defmt-test

Source: https://docs.rs/crate/defmt-test/latest

Illustrates running integration tests using `cargo test --test integration`. This example includes output for both successful test execution and a test that panics, showing the stack trace and error messages.

```bash
$ cargo test --test integration
(..)
0.000000 INFO  (1/2) running `assert_true`...
└─ test::tests::__defmt_test_entry @ tests/test.rs:7
0.000001 INFO  (2/2) running `assert_false`...
└─ test::tests::__defmt_test_entry @ tests/test.rs:7
0.000002 ERROR panicked at 'TODO: write actual tests', testsuite/tests/test.rs:16:9
└─ panic_probe::print_defmt::print @ (..omitted..)
stack backtrace:
   0: HardFaultTrampoline
      <exception entry>
   1: __udf
   2: cortex_m::asm::udf
        at (..omitted..)
   3: rust_begin_unwind
        at (..omitted..)
   4: core::panicking::panic_fmt
        at (..omitted..)
   5: core::panicking::panic
        at (..omitted..)
   6: test::tests::assert_false
        at tests/test.rs:16
   7: main
        at tests/test.rs:7
   8: ResetTrampoline
        at (..omitted..)
   9: Reset
        at (..omitted..)


```

--------------------------------

### Console: Defmt-test Execution Output

Source: https://docs.rs/crate/defmt-test/0.3.3/source/README

Example output from running defmt-test with cargo. Shows the execution of tests, including the before_each and after_each hooks, and the final test results.

```console
$ 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
```

--------------------------------

### Running Integration Tests with defmt-test

Source: https://docs.rs/crate/defmt-test/index

Illustrates running integration tests using `cargo test --test integration`. This example includes output for both successful test execution and a test that panics, showing the stack trace and error messages.

```bash
$ cargo test --test integration
(..)
0.000000 INFO  (1/2) running `assert_true`...
└─ test::tests::__defmt_test_entry @ tests/test.rs:7
0.000001 INFO  (2/2) running `assert_false`...
└─ test::tests::__defmt_test_entry @ tests/test.rs:7
0.000002 ERROR panicked at 'TODO: write actual tests', testsuite/tests/test.rs:16:9
└─ panic_probe::print_defmt::print @ (..omitted..)
stack backtrace:
   0: HardFaultTrampoline
      <exception entry>
   1: __udf
   2: cortex_m::asm::udf
        at (..omitted..)
   3: rust_begin_unwind
        at (..omitted..)
   4: core::panicking::panic_fmt
        at (..omitted..)
   5: core::panicking::panic
        at (..omitted..)
   6: test::tests::assert_false
        at tests/test.rs:16
   7: main
        at tests/test.rs:7
   8: ResetTrampoline
        at (..omitted..)
   9: Reset
        at (..omitted..)


```

--------------------------------

### Running Integration Tests with Cargo

Source: https://docs.rs/crate/defmt-test/0.3.2/source/README

Shows how to run integration tests using `cargo test --test integration`. This command targets tests in files like `tests/integration.rs` and includes example output with test results and a panic traceback.

```console
$ cargo test --test integration
(..)
0.000000 INFO  (1/2) running `assert_true`...
└─ test::tests::__defmt_test_entry @ tests/test.rs:7
0.000001 INFO  (2/2) running `assert_false`...
└─ test::tests::__defmt_test_entry @ tests/test.rs:7
0.000002 ERROR panicked at 'TODO: write actual tests', testsuite/tests/test.rs:16:9
└─ panic_probe::print_defmt::print @ (..omitted..)
stack backtrace:
   0: HardFaultTrampoline
      <exception entry>
   1: __udf
   2: cortex_m::asm::udf
        at (..omitted..)
   3: rust_begin_unwind
        at (..omitted..)
   4: core::panicking::panic_fmt
        at (..omitted..)
   5: core::panicking::panic
        at (..omitted..)
   6: test::tests::assert_false
        at tests/test.rs:16
   7: main
        at tests/test.rs:7
   8: ResetTrampoline
        at (..omitted..)
   9: Reset
        at (..omitted..)
```

--------------------------------

### Run Integration Tests with defmt-test

Source: https://docs.rs/crate/defmt-test/0.3.3/source/README

Illustrates how to execute integration tests using `cargo test --test integration`. The example output includes test execution, assertion results, and a panic with a stack trace, showcasing error handling.

```console
$ cargo test --test integration
(..)
0.000000 INFO  (1/2) running `assert_true`...
└─ test::tests::__defmt_test_entry @ tests/test.rs:7
0.000001 INFO  (2/2) running `assert_false`...
└─ test::tests::__defmt_test_entry @ tests/test.rs:7
0.000002 ERROR panicked at 'TODO: write actual tests', testsuite/tests/test.rs:16:9
└─ panic_probe::print_defmt::print @ (..omitted..)
stack backtrace:
   0: HardFaultTrampoline
      <exception entry>
   1: __udf
   2: cortex_m::asm::udf
        at (..omitted..)
   3: rust_begin_unwind
        at (..omitted..)
   4: core::panicking::panic_fmt
        at (..omitted..)
   5: core::panicking::panic
        at (..omitted..)
   6: test::tests::assert_false
        at tests/test.rs:16
   7: main
        at tests/test.rs:7
   8: ResetTrampoline
        at (..omitted..)
   9: Reset
        at (..omitted..)
```

--------------------------------

### Running Library Unit Tests with Cargo

Source: https://docs.rs/crate/defmt-test/0.3.2/source/README

Demonstrates how to execute library unit tests using `cargo test --lib`. This command runs tests defined in `src/lib.rs` and shows example output indicating test execution and success.

```console
$ cargo test --lib
(..)
(1/1) running `it_works`...
└─ app::unit_tests::__defmt_test_entry @ src/lib.rs:33
all tests passed!
└─ app::unit_tests::__defmt_test_entry @ src/lib.rs:28
(..)
(HOST) INFO  device halted without error
```

--------------------------------

### Build and Document defmt-test Crate

Source: https://docs.rs/crate/defmt-test/0.1.1/builds/321968

This snippet shows the command executed to build and document the defmt-test crate using Rust nightly. It involves Docker commands for environment setup and execution, including specifying target directories, source code, and Cargo home.

```Shell
docker create -v /home/cratesfyi/workspace/builds/defmt-test-0.1.1/target:/opt/rustwide/target:rw,Z -v /home/cratesfyi/workspace/builds/defmt-test-0.1.1/source:/opt/rustwide/workdir:ro,Z -v /home/cratesfyi/workspace/cargo-home:/opt/rustwide/cargo-home:ro,Z -v /home/cratesfyi/workspace/rustup-home:/opt/rustwide/rustup-home:ro,Z -e SOURCE_DIR=/opt/rustwide/workdir -e CARGO_TARGET_DIR=/opt/rustwide/target -e DOCS_RS=1 -e CARGO_HOME=/opt/rustwide/cargo-home -e RUSTUP_HOME=/opt/rustwide/rustup-home -w /opt/rustwide/workdir -m 3221225472 --cpus 2 --user 1001:1001 --network none rustops/crates-build-env@sha256:6eabd152ff4036248d66efda456a36cb33d24b7291b33f25f75140726c88da35 /opt/rustwide/cargo-home/bin/cargo +nightly rustdoc --lib -Zrustdoc-map -Zunstable-options --config=doc.extern-map.registries.crates-io="https://docs.rs" -j2 -- -Z unstable-options --resource-suffix -20201124-1.50.0-nightly-1c389ffef --static-root-path / --cap-lints warn --disable-per-crate-search
```

```Shell
docker start -a 40a6de00f9cd8650a1bd794f3e6b150aeb33d3a4cf582a2f7f677f284cc70470
```

```Shell
docker inspect 40a6de00f9cd8650a1bd794f3e6b150aeb33d3a4cf582a2f7f677f284cc70470
```

```Shell
docker rm -f 40a6de00f9cd8650a1bd794f3e6b150aeb33d3a4cf582a2f7f677f284cc70470
```

--------------------------------

### Rust: Setup Test Suite with State Management

Source: https://docs.rs/crate/defmt-test/index

This Rust code demonstrates setting up a test suite using `defmt_test::tests`. It includes an `#[init]` function to initialize shared state, `#[before_each]` and `#[after_each]` hooks to modify state before and after each test, and example tests that utilize this state.

```rust
// 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;
    }
}

```

--------------------------------

### defmt-test 0.1.0 - Example Code

Source: https://docs.rs/crate/defmt-test/0.1.0/source/LICENSE-MIT

This snippet appears to be a placeholder or an example of line numbering within a code block, commonly seen in documentation. It does not represent executable code but rather a structural element.

```text
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
```

--------------------------------

### Build Log for defmt-test 0.3.3

Source: https://docs.rs/crate/defmt-test/0.3.3/builds/1775107/i686-pc-windows-msvc

This snippet contains the build log for the defmt-test crate, version 0.3.3. It shows the execution of Docker commands for building the documentation on the i686-pc-windows-msvc target, including rustc and docs.rs versions, and the steps involved in container creation, execution, and cleanup.

```Shell
# rustc version
rustc 1.87.0-nightly (ce36a966c 2025-02-17)# docs.rs version
docsrs 0.6.0 (35977596 2025-02-09)# build log
[INFO] running `Command { std: "docker" "create" "-v" "/home/cratesfyi/workspace-builder/builds/defmt-test-0.3.3/target:/opt/rustwide/target:rw,Z" "-v" "/home/cratesfyi/workspace-builder/builds/defmt-test-0.3.3/source:/opt/rustwide/workdir:ro,Z" "-v" "/home/cratesfyi/workspace-builder/cargo-home:/opt/rustwide/cargo-home:ro,Z" "-v" "/home/cratesfyi/workspace-builder/rustup-home:/opt/rustwide/rustup-home:ro,Z" "-e" "SOURCE_DIR=/opt/rustwide/workdir" "-e" "CARGO_TARGET_DIR=/opt/rustwide/target" "-e" "DOCS_RS=1" "-e" "CARGO_HOME=/opt/rustwide/cargo-home" "-e" "RUSTUP_HOME=/opt/rustwide/rustup-home" "-w" "/opt/rustwide/workdir" "-m" "6442450944" "--cpus" "6" "--user" "1001:1001" "--network" "none" "ghcr.io/rust-lang/crates-build-env/linux@sha256:3959728d45483eb673ba100a951a6b9f5012970368db2a9e08e0ac9b67c8a5ad" "/opt/rustwide/cargo-home/bin/cargo" "+nightly" "rustdoc" "--lib" "-Zrustdoc-map" "--config" "build.rustdocflags=[\"--cfg\", \"docsrs\", \"-Z\", \"unstable-options\", \"--emit=invocation-specific\", \"--resource-suffix\", \"-20250217-1.87.0-nightly-ce36a966c\", \"--static-root-path\", \"/-/rustdoc.static/\", \"--cap-lints\", \"warn\", \"--extern-html-root-takes-precedence\"]" "--offline" "-Zunstable-options" "--config=doc.extern-map.registries.crates-io=\"https://docs.rs/{pkg_name}/{version}/i686-pc-windows-msvc\"" "-Zrustdoc-scrape-examples" "-j6" "--target" "i686-pc-windows-msvc", kill_on_drop: false }
[INFO] [stderr] WARNING: Your kernel does not support swap limit capabilities or the cgroup is not mounted. Memory limited without swap.
[INFO] [stdout] 76633ed60a3e7d4159a60137cbb9740395071f673bd88a59e8168cbbed0d87b8
[INFO] running `Command { std: "docker" "start" "-a" "76633ed60a3e7d4159a60137cbb9740395071f673bd88a59e8168cbbed0d87b8", kill_on_drop: false }
[INFO] [stderr] warning: target filter specified, but no targets matched; this is a no-op
[INFO] [stderr]  Documenting defmt-test v0.3.3 (/opt/rustwide/workdir)
[INFO] [stderr]     Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.26s
[INFO] [stderr]    Generated /opt/rustwide/target/i686-pc-windows-msvc/doc/defmt_test/index.html
[INFO] running `Command { std: "docker" "inspect" "76633ed60a3e7d4159a60137cbb9740395071f673bd88a59e8168cbbed0d87b8", kill_on_drop: false }
[INFO] running `Command { std: "docker" "rm" "-f" "76633ed60a3e7d4159a60137cbb9740395071f673bd88a59e8168cbbed0d87b8", kill_on_drop: false }
[INFO] [stdout] 76633ed60a3e7d4159a60137cbb9740395071f673bd88a59e8168cbbed0d87b8

```

--------------------------------

### Adding State to defmt-test

Source: https://docs.rs/crate/defmt-test/0.3.0/source/README

Illustrates how to add shared state to unit tests in defmt-test using an `#[init]` function. The example shows defining a state struct, initializing it, and accessing it within a test function.

```rust
// 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 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)
    }
}
```

--------------------------------

### Running Library Unit Tests with defmt-test

Source: https://docs.rs/crate/defmt-test/latest

Demonstrates how to execute library unit tests using `cargo test --lib` after setting up defmt-test in a project. It shows the expected output, including test execution and device halt messages.

```bash
$ cargo test --lib
(..)
(1/1) running `it_works`...
└─ app::unit_tests::__defmt_test_entry @ src/lib.rs:33
all tests passed!
└─ app::unit_tests::__defmt_test_entry @ src/lib.rs:28
(..)
(HOST) INFO  device halted without error

```

--------------------------------

### Running Library Unit Tests with defmt-test

Source: https://docs.rs/crate/defmt-test/index

Demonstrates how to execute library unit tests using `cargo test --lib` after setting up defmt-test in a project. It shows the expected output, including test execution and device halt messages.

```bash
$ cargo test --lib
(..)
(1/1) running `it_works`...
└─ app::unit_tests::__defmt_test_entry @ src/lib.rs:33
all tests passed!
└─ app::unit_tests::__defmt_test_entry @ src/lib.rs:28
(..)
(HOST) INFO  device halted without error

```

--------------------------------

### Build Log for defmt-test 0.4.0

Source: https://docs.rs/crate/defmt-test/0.4.0/builds/1938161/i686-unknown-linux-gnu

This snippet shows the build log for the defmt-test crate, including rustc and docs.rs versions, and the Docker command used for building. It details the steps taken to compile and generate documentation for the crate on the i686-unknown-linux-gnu target.

```Shell
# rustc version
rustc 1.88.0-nightly (0b45675cf 2025-03-31)# docs.rs version
docsrs 0.6.0 (ee9a3fe6 2025-03-28)# build log
[INFO] running `Command { std: "docker" "create" "-v" "/home/cratesfyi/workspace-builder/builds/defmt-test-0.4.0/target:/opt/rustwide/target:rw,Z" "-v" "/home/cratesfyi/workspace-builder/builds/defmt-test-0.4.0/source:/opt/rustwide/workdir:ro,Z" "-v" "/home/cratesfyi/workspace-builder/cargo-home:/opt/rustwide/cargo-home:ro,Z" "-v" "/home/cratesfyi/workspace-builder/rustup-home:/opt/rustwide/rustup-home:ro,Z" "-e" "SOURCE_DIR=/opt/rustwide/workdir" "-e" "CARGO_TARGET_DIR=/opt/rustwide/target" "-e" "DOCS_RS=1" "-e" "CARGO_HOME=/opt/rustwide/cargo-home" "-e" "RUSTUP_HOME=/opt/rustwide/rustup-home" "-w" "/opt/rustwide/workdir" "-m" "6442450944" "--cpus" "6" "--user" "1001:1001" "--network" "none" "ghcr.io/rust-lang/crates-build-env/linux@sha256:4b26683ee3c49f365255c425c23003cbf4366de097804722c29c5bbbee3624d2" "/opt/rustwide/cargo-home/bin/cargo" "+nightly" "rustdoc" "--lib" "-Zrustdoc-map" "--config" "build.rustdocflags=[\"--cfg\", \"docsrs\", \"-Z\", \"unstable-options\", \"--emit=invocation-specific\", \"--resource-suffix\", \"-20250331-1.88.0-nightly-0b45675cf\", \"--static-root-path\", \"/-/rustdoc.static/\", \"--cap-lints\", \"warn\", \"--extern-html-root-takes-precedence\"]" "--offline" "-Zunstable-options" "--config=doc.extern-map.registries.crates-io=\"https://docs.rs/{pkg_name}/{version}/i686-unknown-linux-gnu\"" "-Zrustdoc-scrape-examples" "-j6" "--target" "i686-unknown-linux-gnu", kill_on_drop: false }`
[INFO] [stdout] dec4f2d2f5ebc81a274dc17bf67bf45ea30355e5a504d8e25481200cb9bd09b6
[INFO] [stderr] WARNING: Your kernel does not support swap limit capabilities or the cgroup is not mounted. Memory limited without swap.
[INFO] running `Command { std: "docker" "start" "-a" "dec4f2d2f5ebc81a274dc17bf67bf45ea30355e5a504d8e25481200cb9bd09b6", kill_on_drop: false }`
[INFO] [stderr] warning: target filter specified, but no targets matched; this is a no-op
[INFO] [stderr]  Documenting defmt-test v0.4.0 (/opt/rustwide/workdir)
[INFO] [stderr]     Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.21s
[INFO] [stderr]    Generated /opt/rustwide/target/i686-unknown-linux-gnu/doc/defmt_test/index.html
[INFO] running `Command { std: "docker" "inspect" "dec4f2d2f5ebc81a274dc17bf67bf45ea30355e5a504d8e25481200cb9bd09b6", kill_on_drop: false }`
[INFO] running `Command { std: "docker" "rm" "-f" "dec4f2d2f5ebc81a274dc17bf67bf45ea30355e5a504d8e25481200cb9bd09b6", kill_on_drop: false }`
[INFO] [stdout] dec4f2d2f5ebc81a274dc17bf67bf45ea30355e5a504d8e25481200cb9bd09b6
```

--------------------------------

### Rust Build Log and Configuration

Source: https://docs.rs/crate/defmt-test/0.3.2/builds/1685779/i686-unknown-linux-gnu

This snippet shows the build log for the defmt-test crate, including the rustc and docs.rs versions, and the Docker command used for building. It details the compilation process and the generation of documentation for the i686-unknown-linux-gnu target.

```bash
# rustc version
rustc 1.86.0-nightly (bf1b174e7 2025-01-28)# docs.rs version
docsrs 0.6.0 (29a0e81b 2025-01-22)# build log
[INFO] running `Command { std: "docker" "create" "-v" "/home/cratesfyi/workspace/builds/defmt-test-0.3.2/target:/opt/rustwide/target:rw,Z" "-v" "/home/cratesfyi/workspace/builds/defmt-test-0.3.2/source:/opt/rustwide/workdir:ro,Z" "-v" "/home/cratesfyi/workspace/cargo-home:/opt/rustwide/cargo-home:ro,Z" "-v" "/home/cratesfyi/workspace/rustup-home:/opt/rustwide/rustup-home:ro,Z" "-e" "SOURCE_DIR=/opt/rustwide/workdir" "-e" "CARGO_TARGET_DIR=/opt/rustwide/target" "-e" "DOCS_RS=1" "-e" "CARGO_HOME=/opt/rustwide/cargo-home" "-e" "RUSTUP_HOME=/opt/rustwide/rustup-home" "-w" "/opt/rustwide/workdir" "-m" "6442450944" "--cpus" "6" "--user" "1001:1001" "--network" "none" "ghcr.io/rust-lang/crates-build-env/linux@sha256:c80049f3b88b82089a44e0f06d0d6029d44b96b7257e55a1cd63dbc9f4c33334" "/opt/rustwide/cargo-home/bin/cargo" "+nightly" "rustdoc" "--lib" "-Zrustdoc-map" "--config" "build.rustdocflags=[\"--cfg\", \"docsrs\", \"-Z\", \"unstable-options\", \"--emit=invocation-specific\", \"--resource-suffix\", \"-20250128-1.86.0-nightly-bf1b174e7\", \"--static-root-path\", \"/-/rustdoc.static/\", \"--cap-lints\", \"warn\", \"--extern-html-root-takes-precedence\"]" "--offline" "-Zunstable-options" "--config=doc.extern-map.registries.crates-io=\"https://docs.rs/{pkg_name}/{version}/i686-unknown-linux-gnu\"" "-Zrustdoc-scrape-examples" "-j6" "--target" "i686-unknown-linux-gnu", kill_on_drop: false }
[INFO] [stdout] 46a4dca090bab3c0a280df856be9b7285b02f144dc144dd54391f5f821a35eb6
[INFO] [stderr] WARNING: Your kernel does not support swap limit capabilities or the cgroup is not mounted. Memory limited without swap.
[INFO] running `Command { std: "docker" "start" "-a" "46a4dca090bab3c0a280df856be9b7285b02f144dc144dd54391f5f821a35eb6", kill_on_drop: false }
[INFO] [stderr] warning: target filter specified, but no targets matched; this is a no-op
[INFO] [stderr]  Documenting defmt-test v0.3.2 (/opt/rustwide/workdir)
[INFO] [stderr]     Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.21s
[INFO] [stderr]    Generated /opt/rustwide/target/i686-unknown-linux-gnu/doc/defmt_test/index.html
[INFO] running `Command { std: "docker" "inspect" "46a4dca090bab3c0a280df856be9b7285b02f144dc144dd54391f5f821a35eb6", kill_on_drop: false }
[INFO] running `Command { std: "docker" "rm" "-f" "46a4dca090bab3c0a280df856be9b7285b02f144dc144dd54391f5f821a35eb6", kill_on_drop: false }
[INFO] [stdout] 46a4dca090bab3c0a280df856be9b7285b02f144dc144dd54391f5f821a35eb6

```

--------------------------------

### Build Log for defmt-test 0.4.0

Source: https://docs.rs/crate/defmt-test/0.4.0/builds/1938161/i686-pc-windows-msvc

This snippet shows the build log for the defmt-test crate, including rustc and docs.rs versions, and the Docker command used for building. It details the process of generating documentation for the i686-pc-windows-msvc target.

```bash
# rustc version
rustc 1.88.0-nightly (0b45675cf 2025-03-31)# docs.rs version
docsrs 0.6.0 (ee9a3fe6 2025-03-28)# build log
[INFO] running `Command { std: "docker" "create" "-v" "/home/cratesfyi/workspace-builder/builds/defmt-test-0.4.0/target:/opt/rustwide/target:rw,Z" "-v" "/home/cratesfyi/workspace-builder/builds/defmt-test-0.4.0/source:/opt/rustwide/workdir:ro,Z" "-v" "/home/cratesfyi/workspace-builder/cargo-home:/opt/rustwide/cargo-home:ro,Z" "-v" "/home/cratesfyi/workspace-builder/rustup-home:/opt/rustwide/rustup-home:ro,Z" "-e" "SOURCE_DIR=/opt/rustwide/workdir" "-e" "CARGO_TARGET_DIR=/opt/rustwide/target" "-e" "DOCS_RS=1" "-e" "CARGO_HOME=/opt/rustwide/cargo-home" "-e" "RUSTUP_HOME=/opt/rustwide/rustup-home" "-w" "/opt/rustwide/workdir" "-m" "6442450944" "--cpus" "6" "--user" "1001:1001" "--network" "none" "ghcr.io/rust-lang/crates-build-env/linux@sha256:4b26683ee3c49f365255c425c23003cbf4366de097804722c29c5bbbee3624d2" "/opt/rustwide/cargo-home/bin/cargo" "+nightly" "rustdoc" "--lib" "-Zrustdoc-map" "--config" "build.rustdocflags=[\"--cfg\", \"docsrs\", \"-Z\", \"unstable-options\", \"--emit=invocation-specific\", \"--resource-suffix\", \"-20250331-1.88.0-nightly-0b45675cf\", \"--static-root-path\", \"/-/rustdoc.static/\", \"--cap-lints\", \"warn\", \"--extern-html-root-takes-precedence\"]" "--offline" "-Zunstable-options" "--config=doc.extern-map.registries.crates-io=\"https://docs.rs/{pkg_name}/{version}/i686-pc-windows-msvc\"" "-Zrustdoc-scrape-examples" "-j6" "--target" "i686-pc-windows-msvc", kill_on_drop: false }
[INFO] [stderr] WARNING: Your kernel does not support swap limit capabilities or the cgroup is not mounted. Memory limited without swap.
[INFO] [stdout] d54d2f8a04bc552372947c32179ab284966a947b7c35c23df08d18d3a6358652
[INFO] running `Command { std: "docker" "start" "-a" "d54d2f8a04bc552372947c32179ab284966a947b7c35c23df08d18d3a6358652", kill_on_drop: false }
[INFO] [stderr] warning: target filter specified, but no targets matched; this is a no-op
[INFO] [stderr]  Documenting defmt-test v0.4.0 (/opt/rustwide/workdir)
[INFO] [stderr]     Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.21s
[INFO] [stderr]    Generated /opt/rustwide/target/i686-pc-windows-msvc/doc/defmt_test/index.html
[INFO] running `Command { std: "docker" "inspect" "d54d2f8a04bc552372947c32179ab284966a947b7c35c23df08d18d3a6358652", kill_on_drop: false }
[INFO] running `Command { std: "docker" "rm" "-f" "d54d2f8a04bc552372947c32179ab284966a947b7c35c23df08d18d3a6358652", kill_on_drop: false }
[INFO] [stdout] d54d2f8a04bc552372947c32179ab284966a947b7c35c23df08d18d3a6358652

```

--------------------------------

### Running Library Unit Tests with defmt-test

Source: https://docs.rs/crate/defmt-test/latest/source/README

Demonstrates how to run library unit tests using `cargo test --lib`. It shows the expected output, including test execution and device status, when using `defmt-test`.

```console
$ cargo test --lib
(..)
(1/1) running `it_works`...
└─ app::unit_tests::__defmt_test_entry @ src/lib.rs:33
all tests passed!
└─ app::unit_tests::__defmt_test_entry @ src/lib.rs:28
(..)
(HOST) INFO  device halted without error
```

--------------------------------

### Disable Tests for a Crate in Cargo.toml

Source: https://docs.rs/crate/defmt-test/latest

This example shows how to disable tests for a specific binary crate within a Cargo.toml file. By adding a `[[bin]]` section and setting `test = false`, you prevent `cargo test` from compiling and running tests for that particular binary.

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

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

```
Tokens:
Raw