error-forge 0.9.7

A comprehensive Rust error management framework with async support, error recovery patterns, and resilience features for building robust, fault-tolerant applications with rich error handling, formatting, and tracing capabilities.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

//! Error recovery patterns for handling transient errors
//!
//! This module provides various error recovery strategies that can be used to make
//! applications more resilient to transient failures.
//!
//! # Features
//!
//! - Backoff strategies for controlling retry timing
//! - Circuit breaker pattern to prevent cascading failures
//! - Retry policies for flexible retry behaviors
//! - `ForgeError`-aware retry executors for sync workloads
//!
//! # Examples
//!
//! ```rust,ignore
//! use error_forge::recovery::RetryPolicy;
//!
//! let policy = RetryPolicy::new_exponential()
//!     .with_max_retries(3);
//!
//! let result = policy.retry(|| {
//!     // Operation that might fail
//!     Ok(())
//! });
//! ```

mod backoff;
mod circuit_breaker;
mod forge_extensions;
mod retry;

pub use backoff::{Backoff, ExponentialBackoff, FixedBackoff, LinearBackoff};
pub use circuit_breaker::{CircuitBreaker, CircuitBreakerConfig, CircuitOpenError, CircuitState};
pub use forge_extensions::ForgeErrorRecovery;
pub use retry::{RetryExecutor, RetryPolicy};

/// Result type for recovery operations
pub type RecoveryResult<T> =
    std::result::Result<T, Box<dyn std::error::Error + Send + Sync + 'static>>;