Struct TestLogger 

pub struct TestLogger { /* private fields */ }

Test logger that captures logs for per-test isolation and assertions.

Use TestLogger::capture to run a test with isolated log capture, then examine captured logs for assertions.

Example

use fastapi_core::testing::TestLogger;
use fastapi_core::logging::LogLevel;

let capture = TestLogger::capture(|| {
    let ctx = RequestContext::for_testing();
    log_info!(ctx, "Hello from test");
    log_debug!(ctx, "Debug info");
});

// Assert on captured logs
assert!(capture.contains_message("Hello from test"));
assert_eq!(capture.count_by_level(LogLevel::Info), 1);

// Get failure context (last N logs)
let context = capture.failure_context(5);

Implementations

impl TestLogger

pub fn new() -> Self

Creates a new test logger.

pub fn with_echo() -> Self

Creates a logger that echoes logs to stderr.

pub fn log(&self, entry: CapturedLog)

Captures a log entry.

pub fn log_entry(&self, entry: &LogEntry)

Captures a log from a LogEntry.

pub fn log_message( &self, level: LogLevel, message: impl Into<String>, request_id: u64, )

Logs a message directly (convenience method).

pub fn logs(&self) -> Vec<CapturedLog>

Gets all captured logs.

pub fn count(&self) -> usize

Gets the number of captured logs.

pub fn clear(&self)

Clears all captured logs.

pub fn contains_message(&self, text: &str) -> bool

Checks if any log contains the given message substring.

pub fn count_by_level(&self, level: LogLevel) -> usize

Counts logs by level.

pub fn logs_at_level(&self, level: LogLevel) -> Vec<CapturedLog>

Gets logs at a specific level.

pub fn failure_context(&self, n: usize) -> String

Gets the last N logs for failure context.

pub fn timings(&self) -> TestTimings

Gets timing breakdown.

pub fn start_phase(&self)

Starts timing a phase.

pub fn end_setup(&self)

Marks end of setup phase.

pub fn end_execute(&self)

Marks end of execute phase.

pub fn end_teardown(&self)

Marks end of teardown phase.

pub fn capture<F, T>(f: F) -> LogCapture<T>

where F: FnOnce(&TestLogger) -> T,

Runs a closure with log capture, returning a LogCapture result.

This is the primary API for isolated test logging.

pub fn capture_phased<S, E, D, T>( setup: S, execute: E, teardown: D, ) -> LogCapture<T>

where S: FnOnce(&TestLogger), E: FnOnce(&TestLogger) -> T, D: FnOnce(&TestLogger),

Runs a test with setup, execute, and teardown phases.

Trait Implementations

impl Clone for TestLogger

fn clone(&self) -> TestLogger

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

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.