tower-http 0.6.9

Tower middleware and utilities for HTTP clients and servers
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
73
74
75
76
77
78
79
80
81
82

//! Tower [`Layer`] for the on-early-drop middleware.

use crate::on_early_drop::service::OnEarlyDropService;
use tower_layer::Layer;

/// [`Layer`] that applies [`OnEarlyDropService`].
///
/// See the [module docs](super) for details and examples.
#[derive(Clone, Copy)]
pub struct OnEarlyDropLayer<OFD, OBD> {
    on_future_drop: OFD,
    on_body_drop: OBD,
}

impl<OFD, OBD> std::fmt::Debug for OnEarlyDropLayer<OFD, OBD> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("OnEarlyDropLayer")
            .field("on_future_drop", &format_args!(".."))
            .field("on_body_drop", &format_args!(".."))
            .finish()
    }
}

impl OnEarlyDropLayer<(), ()> {
    /// Start with both slots set to no-op. Chain
    /// [`on_future_drop`](Self::on_future_drop) and
    /// [`on_body_drop`](Self::on_body_drop) to install hooks.
    pub fn builder() -> Self {
        Self {
            on_future_drop: (),
            on_body_drop: (),
        }
    }
}

impl<H: Clone> OnEarlyDropLayer<H, H> {
    /// Install the same hook in both slots.
    ///
    /// Typical choice is
    /// [`EarlyDropsAsFailures`](crate::on_early_drop::EarlyDropsAsFailures);
    /// see the [module docs](super) for the example.
    pub fn new(hook: H) -> Self {
        Self {
            on_future_drop: hook.clone(),
            on_body_drop: hook,
        }
    }
}

impl<OFD, OBD> OnEarlyDropLayer<OFD, OBD> {
    /// Replace the future-drop slot.
    pub fn on_future_drop<T>(self, hook: T) -> OnEarlyDropLayer<T, OBD> {
        OnEarlyDropLayer {
            on_future_drop: hook,
            on_body_drop: self.on_body_drop,
        }
    }

    /// Replace the body-drop slot.
    pub fn on_body_drop<T>(self, hook: T) -> OnEarlyDropLayer<OFD, T> {
        OnEarlyDropLayer {
            on_future_drop: self.on_future_drop,
            on_body_drop: hook,
        }
    }
}

impl<S, OFD, OBD> Layer<S> for OnEarlyDropLayer<OFD, OBD>
where
    OFD: Clone,
    OBD: Clone,
{
    type Service = OnEarlyDropService<S, OFD, OBD>;

    fn layer(&self, inner: S) -> Self::Service {
        OnEarlyDropService::new(
            inner,
            self.on_future_drop.clone(),
            self.on_body_drop.clone(),
        )
    }
}