Struct TestGuard 

pub struct TestGuard { /* private fields */ }

Zero-boilerplate test logger that auto-logs pass/fail on drop.

Unlike TestLogger, this guard automatically logs TEST PASS when dropped normally, or TEST FAIL when dropped during a panic. This eliminates the need to explicitly call .pass() or .fail().

Usage

use rch_common::testing::TestGuard;

#[test]
fn test_example() {
    let _guard = TestGuard::new("test_example");
    // ... test logic ...
    // TEST PASS logged automatically when _guard drops
}

Environment Variables

• RCH_TEST_LOGGING=1: Enable logging (default: enabled in CI, disabled locally)
• RCH_TEST_LOGGING=0: Disable logging

When disabled, the guard is a no-op for maximum performance.

Implementations

impl TestGuard

pub fn new(test_name: &str) -> Self

Create a new test guard.

If test logging is enabled (see environment variables), this creates a TestLogger and logs TEST START. Otherwise, it’s a no-op.

pub fn log(&self, phase: TestPhase, message: impl Into<String>)

Log a message during test execution.

pub fn log_with_data( &self, phase: TestPhase, message: impl Into<String>, data: Value, )

Log a message with structured data.

Trait Implementations

impl Drop for TestGuard

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.