arti/crates/retry-error
Nick Mathewson af7c9d5a0b enable checked_conversions lint. 2021-10-09 16:53:13 -04:00
..
src enable checked_conversions lint. 2021-10-09 16:53:13 -04:00
Cargo.toml Move all crates into a `crates` subdirectory. 2021-08-27 09:53:09 -04:00
README.md Move all crates into a `crates` subdirectory. 2021-08-27 09:53:09 -04:00

README.md

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

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(val),
        Err(e) => err.push(e),
    }
}
// All attempts failed; return all the errors.
return Err(err)

License: MIT OR Apache-2.0