bromine 0.22.1

A flexible ipc protocol (previously rmp-ipc)
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

use crate::error::Result;
use crate::events::event::Event;
use crate::ipc::context::Context;
use crate::payload::{BytePayload, IntoPayload};
use bytes::Bytes;
use std::collections::HashMap;
use std::fmt::{Debug, Formatter};
use std::future::Future;
use std::pin::Pin;
use std::sync::Arc;

pub struct Response(Bytes);

impl Response {
    /// Creates a new response with a given payload
    pub fn payload<P: IntoPayload>(ctx: &Context, payload: P) -> Result<Self> {
        let bytes = payload.into_payload(ctx)?;

        Ok(Self(bytes))
    }

    /// Creates an empty response
    pub fn empty() -> Self {
        Self(Bytes::new())
    }

    pub(crate) fn into_byte_payload(self) -> BytePayload {
        BytePayload::from(self.0)
    }
}

type EventCallback = Arc<
    dyn for<'a> Fn(
            &'a Context,
            Event,
        ) -> Pin<Box<(dyn Future<Output = Result<Response>> + Send + 'a)>>
        + Send
        + Sync,
>;

/// Handler for events
#[derive(Clone, Default)]
pub struct EventHandler {
    callbacks: HashMap<String, EventCallback>,
}

impl Debug for EventHandler {
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
        let callback_names: String = self
            .callbacks
            .keys()
            .cloned()
            .collect::<Vec<String>>()
            .join(", ");
        format!("EventHandler {{callbacks: [{}]}}", callback_names).fmt(f)
    }
}

impl EventHandler {
    /// Creates a new event handler
    pub fn new() -> Self {
        Self::default()
    }

    /// Adds a new event callback
    #[tracing::instrument(skip(self, callback))]
    pub fn on<F: 'static>(&mut self, name: &str, callback: F)
    where
        F: for<'a> Fn(
                &'a Context,
                Event,
            ) -> Pin<Box<(dyn Future<Output = Result<Response>> + Send + 'a)>>
            + Send
            + Sync,
    {
        self.callbacks.insert(name.to_string(), Arc::new(callback));
    }

    /// Handles a received event
    #[inline]
    #[tracing::instrument(level = "debug", skip(self, ctx, event))]
    pub async fn handle_event(&self, ctx: &Context, event: Event) -> Result<Response> {
        if let Some(cb) = self.callbacks.get(event.name()) {
            cb.as_ref()(ctx, event).await
        } else {
            Ok(Response::empty())
        }
    }
}