Crate retry_error 

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

Structs

FormatDuration 🔒

A wrapper for formatting a Duration in a human-readable way. Produces output like “2m 30s”, “5h 12m”, “45s”, “500ms”.

FormatTimeAgo 🔒

A wrapper for formatting a Duration with “ago” suffix.

RetryError

An error type for use when we’re going to do something a few times, and they might all fail.

Enums

Attempt 🔒

Represents which attempts, in sequence, failed to complete.

Functions

current_instant 🔒

Return the current Instant.

current_system_time 🔒

Return the current system time.

fmt_duration_impl 🔒

Internal helper to format a duration.

fmt_error_with_sources

Helper: formats a std::error::Error and its sources (as "error: source")