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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
use ;
use ;
/// A portability bound for futures returned by [`Transport`] and [`Sleep`].
///
/// Use it on custom implementation return types so native futures are `Send`
/// without imposing that requirement on WebAssembly.
/// A portability bound for futures returned by [`Transport`] and [`Sleep`].
///
/// Use it on custom implementation return types so native futures are `Send`
/// without imposing that requirement on WebAssembly.
/// Sends fully framed HTTP requests for the Jev client.
///
/// Implement this trait to use an HTTP stack that `jevrs` does not provide.
///
/// ```
/// use std::{convert::Infallible, future::Future};
/// use http::{Request, Response};
/// use jevrs::{MaybeSend, Transport};
///
/// struct ToyTransport;
///
/// impl Transport for ToyTransport {
/// type Error = Infallible;
///
/// fn send(
/// &self,
/// _request: Request<Vec<u8>>,
/// ) -> impl Future<Output = Result<Response<Vec<u8>>, Self::Error>> + MaybeSend {
/// async { Ok(Response::new(Vec::new())) }
/// }
/// }
/// ```
/// Pauses a retry loop without prescribing an async runtime.
///
/// Implement this beside a custom [`Transport`] when retries should use your
/// runtime's timer. Use [`NoSleep`] when retries must remain disabled.
///
/// ```
/// use std::{future::Future, time::Duration};
/// use jevrs::{MaybeSend, Sleep};
///
/// struct Immediate;
///
/// impl Sleep for Immediate {
/// fn sleep(&self, _duration: Duration) -> impl Future<Output = ()> + MaybeSend {
/// async {}
/// }
/// }
/// ```
/// Disables waiting and, when used by a client builder, all retries.
///
/// Use this for a custom transport when the application must return the first
/// failure immediately. Supply a real [`Sleep`] implementation to retry.
;