Struct CircuitBreaker 

pub struct CircuitBreaker { /* private fields */ }

Thread-safe three-state circuit breaker.

Implementations

impl CircuitBreaker

pub fn new(config: CircuitBreakerConfig) -> CircuitBreaker

Create a new breaker with the given configuration and the default (TokioClock) clock.

pub fn with_clock( config: CircuitBreakerConfig, clock: Arc<dyn Clock>, ) -> CircuitBreaker

Create a breaker with a custom clock (primarily for tests).

pub fn config(&self) -> &CircuitBreakerConfig

Current configuration.

pub fn current_state(&self) -> CircuitState

Current state. Transitions from Open to HalfOpen happen lazily on observation, so this call also advances state when appropriate.

pub fn allow_call(&self) -> bool

Ask whether a call is currently allowed through. true means the caller should invoke the downstream service; false means the breaker is Open and the caller must fail fast.

pub fn record_success(&self)

Record a successful downstream call.

pub fn record_failure(&self)

Record a failed downstream call.

pub fn reset(&self)

Reset to Closed with no recorded failures. Useful for explicit operator intervention or tests.