Struct NetworkCircuitBreaker 

pub struct NetworkCircuitBreaker { /* private fields */ }

Production-quality circuit breaker for network connections.

Thread Safety

This type is deliberately not Send + Sync — wrap it in a Mutex or RwLock if you need shared mutable access from multiple threads or tasks.

Timestamps

All current_ts parameters are in microseconds on a caller-supplied monotonic clock. The implementation never calls SystemTime or any other OS API for time.

Implementations

impl NetworkCircuitBreaker

pub fn new(config: CircuitConfig) -> Result<Self, BreakerError>

Create a new circuit breaker with the given configuration.

Returns a BreakerError::ConfigurationError if the configuration is logically inconsistent.

pub fn call( &mut self, current_ts: u64, ) -> Result<CircuitCallGuard, BreakerError>

Try to acquire a call slot.

• Closed → always succeeds.
• Open → fails with BreakerError::CircuitOpen unless current_ts >= opened_at + retry_after_us, in which case the circuit automatically transitions to HalfOpen.
• HalfOpen → succeeds if probe_count < half_open_probes, otherwise fails with BreakerError::MaxProbesExceeded.

pub fn record_outcome( &mut self, outcome: CircuitOutcome, response_time_us: u64, current_ts: u64, ) -> Option<CircuitEvent>

Record the outcome of a permitted call and advance the state machine.

Returns a CircuitEvent if a notable state transition occurred.

response_time_us is the elapsed time in microseconds; it is used only for metrics and does not affect the state machine directly.

pub fn force_open(&mut self, current_ts: u64)

Force the circuit into the Open state regardless of current state.

pub fn force_close(&mut self)

Force the circuit into the Closed state regardless of current state.

pub fn state(&self) -> &CircuitState

Return a reference to the current circuit state.

pub fn reset_metrics(&mut self)

Reset all accumulated metrics (success/failure/rejection counters and response-time average). The state machine and event history are unaffected.

pub fn metrics(&self, _current_ts: u64) -> CircuitMetrics

Return a point-in-time metrics snapshot.

pub fn event_history(&self) -> Vec<CircuitEvent>

Return the last up-to-50 circuit events.

Trait Implementations

impl Debug for NetworkCircuitBreaker

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

Formats the value using the given formatter.