retry_macro 0.1.1

A set of declarative macros which retrys executing a function upon failure
Documentation 
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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

# retry_macro


A library which provides macros that automatically re-execute both synchronous and asynchronous (tokio with sleep) functions upon failure.

## Examples


Here are two simple examples using both the synchronous and asynchronous macros.

### Synchronous


```rust
use retry_macro::{retry, retry_sleep, RetryError};

fn can_fail(input: &str) -> Result<i32, std::num::ParseIntError> {
    input.parse::<i32>()
}

fn main() {
    // Retry the can_fail function 5 times with the input "not_a_number"
    let res = retry!(5, can_fail, "not_a_number");
    assert!(res.is_err());
    assert_eq!(res.unwrap_err().retries.len(), 5);

    // Retry the can_fail function 5 times with the input "not_a_number", sleep for 100 milliseconds between retries
    let res = retry_sleep!(5, 100, can_fail, "not_a_number");
    assert!(res.is_err());
    assert_eq!(res.unwrap_err().retries.len(), 5);
}
```

### Asynchronous


```rust
use retry_macro::{retry_async, retry_async_sleep, RetryError};

async fn can_fail_async(input: &str) -> Result<i32, std::num::ParseIntError> {
    tokio::time::sleep(tokio::time::Duration::from_millis(1)).await;
    input.parse::<i32>()
}

#[tokio::main]

async fn main() {
    // Retry the can_fail function 5 times with the input "not_a_number"
    let res = retry_async!(5, can_fail_async, "not_a_number");
    assert!(res.is_err());
    assert_eq!(res.unwrap_err().retries.len(), 5);

    // Retry the can_fail function 5 times with the input "not_a_number", sleep for 100 milliseconds between retries
    let res = retry_async_sleep!(5, 100, can_fail_async, "not_a_number");
    assert!(res.is_err());
    assert_eq!(res.unwrap_err().retries.len(), 5);
}
```

### License


`retry_macro` is distributed under the [MIT](https://choosealicense.com/licenses/mit/) and [Apache-2.0](https://choosealicense.com/licenses/apache-2.0/) licenses.