doido-core 0.0.12

Core errors (thiserror), anyhow Result, serde, tracing, and regex helpers for the Doido 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

//! A lightweight instrumentation bus (Rails `ActiveSupport::Notifications`).
//!
//! Subscribe to an event-name prefix and `instrument` events to notify matching
//! subscribers. Synchronous and dependency-free (payloads are strings).

type Subscriber = Box<dyn Fn(&str, &str) + Send + Sync>;

/// A registry of event subscribers.
#[derive(Default)]
pub struct Notifications {
    subscribers: Vec<(String, Subscriber)>,
}

impl Notifications {
    pub fn new() -> Self {
        Self::default()
    }

    /// Subscribe to events whose name starts with `prefix` (e.g. `"sql."`).
    pub fn subscribe(
        &mut self,
        prefix: &str,
        handler: impl Fn(&str, &str) + Send + Sync + 'static,
    ) {
        self.subscribers
            .push((prefix.to_string(), Box::new(handler)));
    }

    /// Fire `name` with `payload`, invoking every subscriber whose prefix matches.
    pub fn instrument(&self, name: &str, payload: &str) {
        for (prefix, handler) in &self.subscribers {
            if name.starts_with(prefix.as_str()) {
                handler(name, payload);
            }
        }
    }
}