16 unstable releases (5 breaking)
0.5.1 | Sep 5, 2023 |
---|---|
0.4.2 | Jun 30, 2023 |
0.3.1 | Feb 1, 2023 |
0.3.0 | Nov 30, 2022 |
0.0.0 | Jun 24, 2021 |
#385 in Rust patterns
1,161 downloads per month
Used in 35 crates
(4 directly)
17KB
298 lines
retry-error
An error attempt to represent multiple failures.
This crate implements RetryError
, a type to use when you
retry something a few times, and all those attempts can fail differently
each time. Instead of returning only a single error, it records
all of the errors received, in case they are different.
This crate is developed as part of Arti, a project to implement Tor in Rust. It's used by higher-level crates that retry operations.
Example
use retry_error::RetryError;
fn some_operation() -> anyhow::Result<bool> {
unimplemented!(); // example
}
fn example() -> Result<(), RetryError<anyhow::Error>> {
const N_ATTEMPTS: usize = 10;
let mut err = RetryError::in_attempt_to("perform an example operation");
for _ in 0..N_ATTEMPTS {
match some_operation() {
Ok(val) => return Ok(()),
Err(e) => err.push(e),
}
}
// All attempts failed; return all the errors.
return Err(err);
}
License: MIT OR Apache-2.0