blob: 418f4614a4cfcd92f537036f1c5af65cd1db2958 (
plain)
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
|
# 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](https://gitlab.torproject.org/tpo/core/arti/), a project to
implement [Tor](https://www.torproject.org/) in Rust.
It's used by higher-level crates that retry
operations.
### Example
```rust
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
|
