qubit-retry 0.5.0

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

/*******************************************************************************
 *
 *    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 error;
pub mod event;
pub mod options;

mod retry_executor;
mod retry_executor_builder;

pub use error::{RetryAttemptFailure, RetryConfigError, RetryDecider, RetryError};
pub use event::{
    RetryAbortContext, RetryAbortListener, RetryAttemptContext, RetryContext, RetryDecision,
    RetryFailureContext, RetryFailureListener, RetryListener, RetrySuccessContext,
    RetrySuccessListener,
};
pub use options::{RetryDelay, RetryJitter, RetryOptions};
pub use retry_executor::RetryExecutor;
pub use retry_executor_builder::RetryExecutorBuilder;

/// 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>>;