rama-core 0.2.0

rama service core code, used by rama and service authors
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

use crate::{Context, Layer, Service};
use rama_utils::macros::define_inner_service_accessors;
use std::fmt;

/// Service which traces the error using [`tracing`],
/// of the inner [`Service`].
pub struct TraceErr<S> {
    inner: S,
    level: tracing::Level,
}

impl<S> fmt::Debug for TraceErr<S>
where
    S: fmt::Debug,
{
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.debug_struct("TraceErr")
            .field("inner", &self.inner)
            .field("level", &self.level)
            .finish()
    }
}

impl<S> Clone for TraceErr<S>
where
    S: Clone,
{
    fn clone(&self) -> Self {
        Self {
            inner: self.inner.clone(),
            level: self.level,
        }
    }
}

/// A [`Layer`] that produces [`TraceErr`] services.
///
/// [`Layer`]: crate::Layer
#[derive(Clone, Debug)]
pub struct TraceErrLayer {
    level: tracing::Level,
}

impl<S> TraceErr<S> {
    /// Creates a new [`TraceErr`] service.
    pub const fn new(inner: S) -> Self {
        Self::with_level(inner, tracing::Level::ERROR)
    }

    /// Crates a new [`TraceErr`] service with the given [`tracing::Level`].
    pub const fn with_level(inner: S, level: tracing::Level) -> Self {
        TraceErr { inner, level }
    }

    define_inner_service_accessors!();
}

impl<S, State, Request> Service<State, Request> for TraceErr<S>
where
    Request: Send + 'static,
    S: Service<State, Request, Error: std::fmt::Display + Send + Sync + 'static>,
    State: Clone + Send + Sync + 'static,
{
    type Response = S::Response;
    type Error = S::Error;

    #[inline]
    async fn serve(
        &self,
        ctx: Context<State>,
        req: Request,
    ) -> Result<Self::Response, Self::Error> {
        let level = self.level;
        let res = self.inner.serve(ctx, req).await;
        if let Err(ref err) = res {
            match level {
                tracing::Level::TRACE => tracing::trace!(error = %err, "rama service failed"),
                tracing::Level::DEBUG => tracing::debug!(error = %err, "rama service failed"),
                tracing::Level::INFO => tracing::info!(error = %err, "rama service failed"),
                tracing::Level::WARN => tracing::warn!(error = %err, "rama service failed"),
                tracing::Level::ERROR => tracing::error!(error = %err, "rama service failed"),
            }
        }
        res
    }
}

impl TraceErrLayer {
    /// Creates a new [`TraceErrLayer`].
    pub const fn new() -> Self {
        Self::with_level(tracing::Level::ERROR)
    }

    /// Creates a new [`TraceErrLayer`] with the given [`tracing::Level`].
    pub const fn with_level(level: tracing::Level) -> Self {
        TraceErrLayer { level }
    }
}

impl Default for TraceErrLayer {
    fn default() -> Self {
        Self::new()
    }
}

impl<S> Layer<S> for TraceErrLayer {
    type Service = TraceErr<S>;

    fn layer(&self, inner: S) -> Self::Service {
        TraceErr::with_level(inner, self.level)
    }
}