#retry #tor #arti #async #record

retry-error

An error type for an operation that can fail more than once

18 releases

0.5.3 Jun 5, 2024
0.5.1 Sep 5, 2023
0.4.2 Jun 30, 2023
0.3.1 Feb 1, 2023
0.0.0 Jun 24, 2021

#356 in Rust patterns

Download history 1709/week @ 2024-03-24 1158/week @ 2024-03-31 1280/week @ 2024-04-07 398/week @ 2024-04-14 284/week @ 2024-04-21 533/week @ 2024-04-28 473/week @ 2024-05-05 386/week @ 2024-05-12 696/week @ 2024-05-19 867/week @ 2024-05-26 543/week @ 2024-06-02 563/week @ 2024-06-09 1483/week @ 2024-06-16 1104/week @ 2024-06-23 1492/week @ 2024-06-30 284/week @ 2024-07-07

4,574 downloads per month
Used in 43 crates (4 directly)

MIT/Apache

17KB
300 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

No runtime deps