Struct DeterminismEngine 

pub struct DeterminismEngine { /* private fields */ }

Determinism engine for reproducible test execution

This engine provides:

• Seeded random number generation
• Frozen clock timestamps
• Deterministic port allocation
• Hash-based volume naming
• Digest generation for trace verification

Implementations

impl DeterminismEngine

pub fn new(config: DeterminismConfig) -> Result<Self>

Create new determinism engine from configuration

Arguments

• config - Determinism configuration with optional seed and freeze_clock

Returns

• Result<Self> - Initialized engine or error

Errors

• Returns error if freeze_clock is not valid RFC3339 format

pub fn get_timestamp(&self) -> DateTime<Utc>

Get current timestamp (frozen or actual)

If freeze_clock is configured, returns the frozen timestamp. Otherwise, returns the current system time.

pub fn get_timestamp_rfc3339(&self) -> String

Get timestamp as RFC3339 string

pub fn next_u64(&self) -> Result<u64>

Generate next random u64 value

If seed is configured, uses seeded RNG for deterministic values. Otherwise, uses system randomness.

Returns

• Random u64 value

Errors

• Returns error if RNG mutex is poisoned (indicates panic in another thread)

pub fn next_u32(&self) -> Result<u32>

Generate next random u32 value

Errors

• Returns error if RNG mutex is poisoned (indicates panic in another thread)

pub fn fill_bytes(&self, dest: &mut [u8]) -> Result<()>

Fill buffer with random bytes

Errors

• Returns error if RNG mutex is poisoned (indicates panic in another thread)

pub fn is_deterministic(&self) -> bool

Check if determinism is enabled

pub fn has_seed(&self) -> bool

Check if seed is configured

pub fn has_frozen_clock(&self) -> bool

Check if clock is frozen

pub fn get_seed(&self) -> Option<u64>

Get the seed value if configured

pub fn get_frozen_clock(&self) -> Option<&str>

Get the frozen clock timestamp string if configured

pub fn config(&self) -> &DeterminismConfig

Get reference to configuration

pub fn allocate_port(&self) -> Result<u16>

Allocate next deterministic port

Returns

• Result<u16> - Next port from the deterministic pool

Errors

• Returns error if deterministic ports not enabled
• Returns error if no ports available

pub fn release_port(&self, port: u16) -> Result<()>

Release port back to the pool

Arguments

• port - Port to release

Errors

• Returns error if deterministic ports not enabled
• Returns error if port was not allocated

pub fn allocated_ports(&self) -> Result<Vec<u16>>

Get list of allocated ports

Returns

• Result<Vec<u16>> - List of currently allocated ports

Errors

• Returns error if deterministic ports not enabled

pub fn generate_volume_name(&self, test_name: &str) -> String

Generate deterministic volume name

Uses hash-based naming with test name and seed

Arguments

• test_name - Name of the test

Returns

• String - Deterministic volume name

pub fn generate_container_name( &self, test_name: &str, step_name: &str, ) -> String

Generate deterministic container name

Arguments

• test_name - Name of the test
• step_name - Name of the step

Returns

• String - Deterministic container name

pub fn generate_network_name(&self, test_name: &str) -> String

Generate deterministic network name

Arguments

• test_name - Name of the test

Returns

• String - Deterministic network name

pub fn get_port_pool_env(&self) -> Result<String>

Get port pool as environment variable string

Returns comma-separated list of ports for CLEANROOM_ALLOWED_PORTS

Returns

• Result<String> - Comma-separated port list

Errors

• Returns error if deterministic ports not enabled

Trait Implementations

impl Clone for DeterminismEngine

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeterminismEngine

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

Formats the value using the given formatter.