eztry 0.0.1

easy-to-use utilities to add retry logic to async functions
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

use crate::policy::RetryPolicy;
use crate::retry_result::RetryResult;
use crate::retryer::Retryer;
use crate::util;
use async_trait::async_trait;

#[async_trait]
pub trait Executor<T, E>: Send + Sync {
    async fn execute(&self) -> RetryResult<T, E>;

    /// Prepare the executor to be retried with the default policy. See eztry::policy::DEFAULT_POLICY.
    /// Does not begin the retry process until run() is called on the Retryer. The policy can be updated with set_policy().
    fn prepare(&self) -> Retryer<T, E>
    where
        Self: Sized,
    {
        let pol = crate::global::get_default_policy();
        Retryer {
            policy: util::OwnedOrRef::Ref(pol),
            count: 0,
            function: Box::new(self),
        }
    }

    /// Attempts to execute and retry the executor with a policy.
    async fn retry_with_policy(&self, policy: RetryPolicy) -> Result<T, E>
    where
        Self: Sized + 'static,
        T: Send + Sync,
        E: Send + Sync,
    {
        Retryer {
            policy: util::OwnedOrRef::Owned(policy),
            count: 0,
            function: Box::new(self),
        }
        .run()
        .await
    }

    /// Attempts to execute and retry the executor with a borrowed policy
    fn retry_with_policy_ref<'a>(&'a self, policy: &'a RetryPolicy) -> Retryer<'a, T, E>
    where
        Self: Sized + 'static,
    {
        Retryer {
            policy: util::OwnedOrRef::Ref(policy),
            count: 0,
            function: Box::new(self),
        }
    }

    /// Attempts to execute and retry the executor with the default policy. See eztry::policy::DEFAULT_POLICY.
    async fn retry_with_default_policy(&self) -> Result<T, E>
    where
        Self: Sized + 'static,
        T: Send + Sync,
        E: Send + Sync,
    {
        let pol = crate::global::get_default_policy();

        Retryer {
            policy: util::OwnedOrRef::Ref(pol),
            count: 0,
            function: Box::new(self),
        }
        .run()
        .await
    }
}

pub type AsyncFunction<'a, T, E> = Box<&'a dyn Executor<T, E>>;