Struct SimConfig 

pub struct SimConfig {
    pub seed: u64,
    pub fail_rate: f64,
    pub repair_rate: f64,
    pub tcp_capacity: u64,
    pub udp_capacity: u64,
    pub enable_random_order: bool,
    pub min_message_latency: Duration,
    pub max_message_latency: Duration,
    pub duration: Duration,
    pub tick_duration: Duration,
}

Configuration for a simulation run.

Controls various aspects of the simulation environment including randomness, failure rates, network properties, and timing.

Fields

seed: u64

Random seed for reproducible simulations.

fail_rate: f64

Probability (0.0 to 1.0) that a component will fail.

repair_rate: f64

Probability (0.0 to 1.0) that a failed component will be repaired.

tcp_capacity: u64

Maximum number of TCP messages in flight.

udp_capacity: u64

Maximum number of UDP messages in flight.

enable_random_order: bool

Whether to randomize the order of actor execution.

min_message_latency: Duration

Minimum simulated network latency.

max_message_latency: Duration

Maximum simulated network latency.

duration: Duration

How long the simulation should run (Duration::MAX for unlimited).

tick_duration: Duration

Duration of each simulation tick.

Implementations

impl SimConfig

pub const fn new() -> Self

Creates a new SimConfig with default values.

Returns a configuration with reasonable defaults for testing.

pub fn from_rng() -> Self

Creates a new SimConfig with randomized values.

Uses the current RNG to generate configuration values suitable for testing. The SIMULATOR_DURATION environment variable can be used to override the duration.

Panics

• If SIMULATOR_DURATION is set but cannot be parsed as a supported duration format.

Examples

use simvar_harness::SimConfig;

let config = SimConfig::from_rng();
assert!(config.max_message_latency >= config.min_message_latency);

pub const fn fail_rate(&mut self, fail_rate: f64) -> &mut Self

Sets the failure rate (0.0 to 1.0) and returns a mutable reference to self.

pub const fn repair_rate(&mut self, repair_rate: f64) -> &mut Self

Sets the repair rate (0.0 to 1.0) and returns a mutable reference to self.

pub const fn tcp_capacity(&mut self, tcp_capacity: u64) -> &mut Self

Sets the TCP capacity and returns a mutable reference to self.

pub const fn udp_capacity(&mut self, udp_capacity: u64) -> &mut Self

Sets the UDP capacity and returns a mutable reference to self.

pub const fn enable_random_order( &mut self, enable_random_order: bool, ) -> &mut Self

Sets whether to enable random actor execution order and returns a mutable reference to self.

pub const fn min_message_latency( &mut self, min_message_latency: Duration, ) -> &mut Self

Sets the minimum message latency and returns a mutable reference to self.

pub const fn max_message_latency( &mut self, max_message_latency: Duration, ) -> &mut Self

Sets the maximum message latency and returns a mutable reference to self.

pub const fn duration(&mut self, duration: Duration) -> &mut Self

Sets the simulation duration and returns a mutable reference to self.

pub const fn tick_duration(&mut self, tick_duration: Duration) -> &mut Self

Sets the tick duration and returns a mutable reference to self.

Trait Implementations

impl Clone for SimConfig

fn clone(&self) -> SimConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SimConfig

impl Debug for SimConfig

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

Formats the value using the given formatter.

impl Default for SimConfig

fn default() -> Self

Returns the “default value” for a type.