Struct TestContextBuilder 

pub struct TestContextBuilder { /* private fields */ }

Builder for creating test contexts with configurable providers.

Example

use xerv_core::testing::TestContextBuilder;

let ctx = TestContextBuilder::new()
    .with_fixed_time("2024-01-15T10:30:00Z")
    .with_mock_http(
        MockHttp::new()
            .on_get("https://api.example.com/status")
            .respond_json(200, serde_json::json!({"ok": true}))
    )
    .with_seed(42)
    .with_sequential_uuids()
    .with_env_vars(&[("DEBUG", "true")])
    .with_secrets(&[("API_KEY", "test-key")])
    .with_recording()
    .build()
    .unwrap();

Implementations

impl TestContextBuilder

pub fn new() -> Self

Create a new test context builder with default settings.

pub fn with_trace_id(self, trace_id: TraceId) -> Self

Set the trace ID.

pub fn with_node_id(self, node_id: NodeId) -> Self

Set the node ID.

pub fn with_arena_config(self, config: ArenaConfig) -> Self

Set the arena configuration.

pub fn with_wal_config(self, config: WalConfig) -> Self

Set the WAL configuration.

pub fn with_fixed_time(self, iso_time: &str) -> Self

Use a fixed time.

pub fn with_mock_clock(self) -> Self

Use a mock clock starting at time zero.

pub fn with_clock(self, clock: Arc<dyn ClockProvider>) -> Self

Use a custom clock provider.

pub fn with_real_clock(self) -> Self

Use the real system clock.

pub fn with_mock_http(self, mock: MockHttp) -> Self

Use a mock HTTP provider.

pub fn with_http(self, http: Arc<dyn HttpProvider>) -> Self

Use a custom HTTP provider.

pub fn with_real_http(self) -> Self

Use the real HTTP provider.

pub fn with_seed(self, seed: u64) -> Self

Use a seeded RNG for deterministic behavior.

pub fn with_rng(self, rng: Arc<dyn RngProvider>) -> Self

Use a custom RNG provider.

pub fn with_real_rng(self) -> Self

Use the real RNG.

pub fn with_sequential_uuids(self) -> Self

Use sequential UUIDs (00000001, 00000002, …).

pub fn with_predetermined_uuids(self, uuids: &[&str]) -> Self

Use predetermined UUIDs.

pub fn with_uuid(self, uuid: Arc<dyn UuidProvider>) -> Self

Use a custom UUID provider.

pub fn with_real_uuid(self) -> Self

Use the real UUID provider.

pub fn with_memory_fs(self) -> Self

Use an in-memory filesystem.

pub fn with_mock_fs(self, mock: MockFs) -> Self

Use a mock filesystem with predefined files.

pub fn with_fs(self, fs: Arc<dyn FsProvider>) -> Self

Use a custom filesystem provider.

pub fn with_real_fs(self) -> Self

Use the real filesystem.

pub fn with_env_vars(self, vars: &[(&str, &str)]) -> Self

Use mock environment variables.

pub fn with_mock_env(self, mock: MockEnv) -> Self

Use a mock environment provider.

pub fn with_env(self, env: Arc<dyn EnvProvider>) -> Self

Use a custom environment provider.

pub fn with_real_env(self) -> Self

Use the real environment.

pub fn with_secrets(self, secrets: &[(&str, &str)]) -> Self

Use mock secrets.

pub fn with_mock_secrets(self, mock: MockSecrets) -> Self

Use a mock secrets provider.

pub fn with_secrets_provider(self, secrets: Arc<dyn SecretsProvider>) -> Self

Use a custom secrets provider.

pub fn with_recording(self) -> Self

Enable event recording.

pub fn build(self) -> Result<TestContext>

Build the test context.

Trait Implementations

impl Default for TestContextBuilder

fn default() -> Self

Returns the “default value” for a type.