xtra 0.6.0

A tiny actor framework
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

use std::future::Future;

pub use tracing::Span;

#[derive(Clone)]
pub struct Instrumentation {
    pub parent: Span,
    _waiting_for_actor: Span,
}

impl Instrumentation {
    pub fn empty() -> Self {
        Instrumentation {
            parent: Span::none(),
            _waiting_for_actor: Span::none(),
        }
    }

    pub fn started<A, M>() -> Self {
        let parent = tracing::debug_span!(
            "xtra_actor_request",
            actor_type = %std::any::type_name::<A>(),
            message_type = %std::any::type_name::<M>(),
        )
        .or_current();

        let _waiting_for_actor =
            tracing::debug_span!(parent: &parent, "xtra_message_waiting_for_actor",).or_current();

        Instrumentation {
            parent,
            _waiting_for_actor,
        }
    }

    pub fn is_parent_none(&self) -> bool {
        self.parent.is_none()
    }

    pub fn apply<F>(self, fut: F) -> (impl Future<Output = F::Output>, Span)
    where
        F: Future,
    {
        let executing = self.parent.in_scope(|| {
            tracing::debug_span!("xtra_message_handler", interrupted = tracing::field::Empty)
                .or_current()
        });

        (
            tracing::Instrument::instrument(fut, executing.clone()),
            executing,
        )
    }
}