Struct TestContext 

pub struct TestContext {
    pub clock: Arc<dyn ClockProvider>,
    pub http: Arc<dyn HttpProvider>,
    pub rng: Arc<dyn RngProvider>,
    pub uuid: Arc<dyn UuidProvider>,
    pub fs: Arc<dyn FsProvider>,
    pub env: Arc<dyn EnvProvider>,
    pub secrets: Arc<dyn SecretsProvider>,
    /* private fields */
}

Test context with pluggable providers for deterministic testing.

This context provides access to all the same functionality as the regular Context, plus mock providers for external dependencies.

Example

use xerv_core::testing::{TestContextBuilder, MockClock, MockHttp};

let ctx = TestContextBuilder::new()
    .with_fixed_time("2024-01-15T10:30:00Z")
    .with_seed(42)
    .with_sequential_uuids()
    .with_recording()
    .build()
    .unwrap();

// Use providers
let time = ctx.clock.system_time_millis();
let uuid = ctx.uuid.new_v4();

Fields

clock: Arc<dyn ClockProvider>

Clock provider for time operations.

http: Arc<dyn HttpProvider>

HTTP provider for network requests.

rng: Arc<dyn RngProvider>

RNG provider for random number generation.

uuid: Arc<dyn UuidProvider>

UUID provider for UUID generation.

fs: Arc<dyn FsProvider>

Filesystem provider for file operations.

env: Arc<dyn EnvProvider>

Environment provider for environment variables.

secrets: Arc<dyn SecretsProvider>

Secrets provider for secret management.

Implementations

impl TestContext

pub fn trace_id(&self) -> TraceId

Get the trace ID.

pub fn node_id(&self) -> NodeId

Get the node ID.

pub fn read_bytes(&self, ptr: RelPtr<()>) -> Result<Vec<u8>>

Read bytes from the arena.

pub fn write_bytes(&self, bytes: &[u8]) -> Result<RelPtr<()>>

Write bytes to the arena.

pub fn read_raw(&self, offset: ArenaOffset, size: usize) -> Result<Vec<u8>>

Read raw bytes from the arena.

pub fn write_raw(&self, bytes: &[u8]) -> Result<RelPtr<()>>

Write raw bytes to the arena.

pub fn log(&self, message: impl AsRef<str>)

Log a message.

pub fn warn(&self, message: impl AsRef<str>)

Log a warning.

pub fn error(&self, message: impl AsRef<str>)

Log an error.

pub fn write_position(&self) -> ArenaOffset

Get the current write position.

pub fn wal(&self) -> &Wal

Get the WAL.

pub fn recorder(&self) -> Option<&Arc<EventRecorder>>

Get the event recorder (if recording is enabled).

pub fn record(&self, event: RecordedEvent)

Record an event (if recording is enabled).

pub fn now(&self) -> u64

Get current time in nanoseconds.

pub fn system_time_millis(&self) -> u64

Get current system time in milliseconds.

pub fn new_uuid(&self) -> Uuid

Generate a new UUID.

pub fn random_u64(&self) -> u64

Generate a random u64.

pub fn random_f64(&self) -> f64

Generate a random f64 in [0, 1).

pub fn env_var(&self, key: &str) -> Option<String>

Get an environment variable.

pub fn secret(&self, key: &str) -> Option<String>

Get a secret.