reliability-toolkit 0.1.1

Async reliability primitives for Rust: rate limiter, circuit breaker, retry with jitter, bulkhead. Optional audit-stream-py integration via the `audit-stream` feature.
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

//! Error types shared across the crate.

use std::time::Duration;

use thiserror::Error;

/// Errors that can be returned by reliability primitives themselves
/// (as opposed to errors from the wrapped operation).
#[derive(Debug, Error)]
pub enum ToolkitError {
    /// The circuit breaker is currently open and rejected the call without invoking it.
    #[error("circuit breaker is open (will retry after {retry_after:?})")]
    CircuitOpen {
        /// How long the breaker expects to remain open.
        retry_after: Duration,
    },

    /// The bulkhead has been closed and is no longer accepting permits.
    #[error("bulkhead is closed")]
    BulkheadClosed,

    /// Retry exhausted its attempt budget without a success.
    #[error("retry exhausted after {attempts} attempts")]
    RetryExhausted {
        /// How many attempts were made before giving up.
        attempts: u32,
    },
}