mm1-core 0.7.23

An Erlang-style actor runtime for Rust.
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

use std::fmt;

use rand::RngCore;
use tokio::task_local;
use tracing::{Instrument, Level, Span, span};

task_local! {
    static TRACE_ID: TraceId;
}

#[derive(
    Default,
    Debug,
    Clone,
    Copy,
    PartialEq,
    Eq,
    PartialOrd,
    Ord,
    Hash,
    serde::Serialize,
    serde::Deserialize,
)]
pub struct TraceId(u64);

pub trait WithTraceIdExt: Future + Sized {
    fn with_trace_id(self, trace_id: TraceId) -> impl Future<Output = Self::Output> {
        trace_id.scope_async(self)
    }
}

impl<F> WithTraceIdExt for F where F: Future + Sized {}

impl TraceId {
    pub fn random() -> Self {
        rand::rng().next_u64().into()
    }

    pub fn current() -> Self {
        TRACE_ID.try_get().ok().unwrap_or_default()
    }

    pub fn scope_async<F>(self, fut: F) -> impl Future<Output = F::Output>
    where
        F: Future,
    {
        TRACE_ID.scope(self, fut.instrument(self.span()))
    }

    pub fn scope_sync<F, R>(self, func: F) -> R
    where
        F: FnOnce() -> R,
    {
        TRACE_ID.sync_scope(self, || self.span().in_scope(func))
    }

    pub fn span(self) -> Span {
        span!(
            Level::TRACE,
            "trace-id-async-scope",
            _trace_id = tracing::field::display(self)
        )
    }
}

impl From<u64> for TraceId {
    fn from(value: u64) -> Self {
        Self(value)
    }
}
impl From<TraceId> for u64 {
    fn from(value: TraceId) -> Self {
        let TraceId(value) = value;
        value
    }
}

impl fmt::Display for TraceId {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "T#{}", self.0)
    }
}

#[cfg(test)]
mod tests {
    use crate::tracing::TraceId;

    #[tokio::test]
    async fn scopes() {
        let t_0 = TraceId::current();
        let t_1 = TraceId::random();

        assert_ne!(t_0, t_1);

        assert_eq!(t_0, t_0.scope_async(async { TraceId::current() }).await);
        assert_eq!(t_0, t_0.scope_sync(TraceId::current));

        assert_eq!(t_1, t_1.scope_async(async { TraceId::current() }).await);
        assert_eq!(t_1, t_1.scope_sync(TraceId::current));
    }
}