Struct TestLogger 

pub struct TestLogger { /* private fields */ }

Comprehensive test logger that captures typed events with timestamps.

Example

let logger = TestLogger::new(TestLogLevel::Debug);

// Log events during test
logger.log(TestEvent::TaskSpawn { task_id: 1, name: None });
logger.log(TestEvent::TaskComplete { task_id: 1, outcome: "ok" });

// Generate report
println!("{}", logger.report());

// Assert no busy loops
logger.assert_no_busy_loop(5);

Implementations

impl TestLogger

pub fn new(level: TestLogLevel) -> Self

Creates a new logger with the specified level.

pub fn from_env() -> Self

Creates a logger using the TEST_LOG_LEVEL environment variable.

pub fn verbose(self, verbose: bool) -> Self

Sets whether to print events immediately.

pub fn level(&self) -> TestLogLevel

Returns the configured log level.

pub fn elapsed(&self) -> Duration

Returns the elapsed time since logger creation.

pub fn should_log(&self, level: TestLogLevel) -> bool

Returns whether the logger should capture events at the given level.

pub fn log(&self, event: TestEvent)

Logs an event if it meets the configured level.

pub fn custom(&self, category: &'static str, message: impl Into<String>)

Logs a custom event.

pub fn error(&self, category: &'static str, message: impl Into<String>)

Logs an error event.

pub fn warn(&self, category: &'static str, message: impl Into<String>)

Logs a warning event.

pub fn event_count(&self) -> usize

Returns the number of captured events.

pub fn events(&self) -> Vec<LogRecord>

Returns a snapshot of all captured events.

pub fn report(&self) -> String

Generates a detailed report of all captured events.

pub fn assert_no_busy_loop(&self, max_empty_polls: usize)

Asserts that the test did not have excessive empty reactor polls (busy loops).

Panics

Panics if the number of empty polls exceeds max_empty_polls.

pub fn assert_no_errors(&self)

Asserts that no errors were logged.

Panics

Panics if any error events were logged.

pub fn assert_all_tasks_completed(&self)

Asserts that all spawned tasks completed.

Panics

Panics if any spawned task did not have a corresponding completion event.

pub fn clear(&self)

Clears all captured events.

Trait Implementations

impl Debug for TestLogger

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TestLogger

fn default() -> Self

Returns the “default value” for a type.