Struct CircuitBreaker 

pub struct CircuitBreaker { /* private fields */ }

Circuit breaker for fault tolerance

The circuit breaker monitors failures and automatically transitions between states:

• Closed: Normal operation, requests pass through
• Open: Too many failures, requests are blocked
• HalfOpen: Testing recovery, limited requests allowed

Examples

use chie_shared::CircuitBreaker;

let mut breaker = CircuitBreaker::new(5, 60_000, 30_000);

// Record successful requests
breaker.record_success();
assert!(breaker.is_closed());

// Record failures
for _ in 0..5 {
    breaker.record_failure();
}
assert!(breaker.is_open());

Implementations

impl CircuitBreaker

pub fn new( failure_threshold: u32, timeout_ms: u64, half_open_timeout_ms: u64, ) -> Self

Create a new circuit breaker

Arguments

• failure_threshold - Number of failures before opening circuit
• timeout_ms - Milliseconds to keep circuit open
• half_open_timeout_ms - Milliseconds for half-open state

pub fn with_defaults() -> Self

Create a circuit breaker with default settings

Defaults: 5 failures, 60s timeout, 30s half-open timeout

pub fn state(&self) -> CircuitState

Get the current state

pub fn is_closed(&self) -> bool

Check if circuit is closed (requests allowed)

pub fn is_open(&self) -> bool

Check if circuit is open (requests blocked)

pub fn is_half_open(&self) -> bool

Check if circuit is half-open (testing recovery)

pub fn allow_request(&self) -> bool

Check if a request is allowed through the circuit

pub fn record_success(&mut self)

Record a successful request

pub fn record_failure(&mut self)

Record a failed request

pub fn failure_count(&self) -> u32

Get failure count

pub fn time_until_half_open(&self) -> Option<Duration>

Get time remaining until circuit can transition from open to half-open

pub fn reset(&mut self)

Reset the circuit breaker to closed state

pub fn force_open(&mut self)

Force circuit to open state

Trait Implementations

impl Clone for CircuitBreaker

fn clone(&self) -> CircuitBreaker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CircuitBreaker

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

Formats the value using the given formatter.

impl Default for CircuitBreaker

fn default() -> Self

Returns the “default value” for a type.