qubit-retry 0.3.1

Retry module, providing a feature-complete, type-safe retry management system with support for multiple delay strategies and event listeners
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
40
41
42
43
44
45

/*******************************************************************************
 *
 *    Copyright (c) 2025 - 2026.
 *    Haixing Hu, Qubit Co. Ltd.
 *
 *    All rights reserved.
 *
 ******************************************************************************/
//! Type-preserving retry executors for synchronous and asynchronous operations.
//!
//! `RetryExecutor<E>` binds only the operation error type. The success type `T`
//! is introduced on `run` / `run_async`, so normal error retry does not require
//! `T: Clone + Eq + Hash`.
//!
//! The default error type is `BoxError` from the `qubit-common` crate. It is not
//! re-exported by this crate; callers that need the boxed error alias should
//! import it from `qubit-common` directly.

pub mod delay;
pub mod error;
pub mod events;
pub mod jitter;

mod failure_action;
mod retry_executor;
mod retry_executor_builder;
mod retry_options;

pub use delay::Delay;
pub use error::{AttemptFailure, ErrorClassifier, RetryConfigError, RetryError};
pub use events::{
    AbortContext, AbortListener, AttemptContext, FailureContext, FailureListener, RetryContext,
    RetryDecision, RetryListener, SuccessContext, SuccessListener,
};
pub use jitter::Jitter;
pub use retry_executor::RetryExecutor;
pub use retry_executor_builder::RetryExecutorBuilder;
pub use retry_options::RetryOptions;

/// Result alias returned by retry executor execution.
///
/// The success type `T` is chosen by each operation. The error type `E`
/// remains the caller's original application error and is wrapped by
/// [`RetryError`] only when retry execution terminates unsuccessfully.
pub type RetryResult<T, E> = Result<T, RetryError<E>>;