Struct TestContext 

pub struct TestContext {
    pub test_id: String,
    pub seed: u64,
    pub subsystem: Option<String>,
    pub invariant: Option<String>,
}

Standardized metadata carried through a test for structured logging.

Every test should create a TestContext to ensure consistent, machine-parseable log fields across all unit, integration, and E2E tests.

Standard Fields

Field	Purpose	Example
test_id	Unique identifier for the test run	"cancel_drain_001"
seed	Deterministic RNG seed for reproducibility	0xDEAD_BEEF
subsystem	Runtime subsystem under test	"scheduler", "raptorq"
invariant	Core invariant being verified	"no_obligation_leaks"

Example

use asupersync::test_logging::TestContext;

let ctx = TestContext::new("cancel_drain_001", 0xDEAD_BEEF)
    .with_subsystem("cancellation")
    .with_invariant("losers_drained");

// Use with TestHarness
let harness = TestHarness::with_context("my_test", ctx);

Fields

test_id: String

Unique test identifier for log correlation.

seed: u64

Deterministic seed for reproducibility.

subsystem: Option<String>

Runtime subsystem under test (e.g., “scheduler”, “raptorq”, “obligation”).

invariant: Option<String>

Core invariant being verified (e.g., “no_obligation_leaks”, “quiescence”).

Implementations

impl TestContext

pub fn new(test_id: &str, seed: u64) -> Self

Create a new context with required fields.

pub fn with_subsystem(self, subsystem: &str) -> Self

Set the subsystem under test.

pub fn with_invariant(self, invariant: &str) -> Self

Set the invariant being verified.

pub fn log_start(&self)

Emit a tracing info event with all context fields.

pub fn log_end(&self, passed: bool)

Emit a tracing info event for test completion with all context fields.

pub fn component_seed(&self, component: &str) -> u64

Derive a component-specific seed from this context’s root seed.

pub fn scenario_seed(&self, scenario: &str) -> u64

Derive a scenario-specific seed from this context’s root seed.

pub fn entropy_seed(&self, index: u64) -> u64

Derive an entropy seed for a given iteration index.

pub fn log_failure(&self, reason: &str)

Emit a structured error dump with full context for failure triage.

Trait Implementations

impl Clone for TestContext

fn clone(&self) -> TestContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TestContext

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

Formats the value using the given formatter.

impl Display for TestContext

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

Formats the value using the given formatter.

impl Serialize for TestContext

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.