orsomafo 0.3.3

Event dispatcher crate
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

#![allow(dead_code)]
use crate::{
    closure_handler_wrapper::ClosureHandlerWrapper,
    dispatched_event::DispatchedEvent,
    event::{Dispatchable, EventHandler},
    event_dispatcher::{EventDispatcher, EVENT_DISPATCHER},
    event_listener::{merge_subscribers, EventListener, Subscriber, SubscriberList, LOG_TITLE},
};
use std::{future::Future, sync::Arc};
use tokio::sync::mpsc::{self};

#[derive(Default)]
pub struct EventDispatcherBuilder {
    subscribers: SubscriberList,
}

impl EventDispatcherBuilder {
    pub fn new() -> Self {
        Self {
            subscribers: SubscriberList::new(),
        }
    }

    // TODO: complete implementation that will allow closure to be used as a handler
    fn listen_fn<F, Fut>(self, event: String, handler: F) -> Self
    where
        F: Fn(&DispatchedEvent) -> Fut + Clone + Send + Sync + 'static,
        Fut: Future + Send + Sync + 'static,
    {
        let wrapper = ClosureHandlerWrapper(Some(handler));

        self.register(event, wrapper.to_handler())
    }

    pub fn listen<E: Dispatchable, H: EventHandler + Default>(self) -> Self {
        let event = E::event();
        let the_handler = H::default().to_handler();
        self.register(event, the_handler)
    }

    pub fn listen_with<E: Dispatchable>(self, instance: impl EventHandler) -> Self {
        let event = E::event();
        let the_handler = instance.to_handler();
        self.register(event, the_handler)
    }

    pub fn subscribe(mut self, subscriber: Subscriber) -> Self {
        for name_and_handlers in subscriber.subscribers {
            log::trace!(
                target: LOG_TITLE,
                "subscriber event: {:?}",
                &name_and_handlers.0,
            );

            if let Some(collection) = self.subscribers.get_mut(&name_and_handlers.0) {
                collection.extend(name_and_handlers.1);
            } else {
                self.subscribers
                    .insert(name_and_handlers.0, name_and_handlers.1);
            }
        }
        self
    }

    pub async fn build(self) -> Arc<EventDispatcher> {
        if let Some(dispatcher) = EVENT_DISPATCHER.get() {
            let subscribers = self.subscribers;
            merge_subscribers(subscribers).await;
            dispatcher.clone()
        } else {
            let (tx, rx) = mpsc::unbounded_channel::<DispatchedEvent>();
            let subscribers = self.subscribers;

            tokio::spawn(async move {
                let mut handler = EventListener::new(subscribers, rx).await;
                handler.receive().await;
            });

            let dispatcher = Arc::new(EventDispatcher::new(tx));

            _ = EVENT_DISPATCHER.set(dispatcher.clone());

            dispatcher
        }
    }

    fn register(mut self, event: String, handler: Box<dyn EventHandler>) -> Self {
        if self.subscribers.get(&event).is_none() {
            self.subscribers.insert(event.clone(), Vec::new());
        }

        if let Some(collection) = self.subscribers.get_mut(&event) {
            log::trace!(
                target: LOG_TITLE,
                "registered handler: {:?}, for event: {:?}",
                &event,
                &handler.handler_id()
            );

            collection.push(handler);
        } else {
            log::error!(
                "could not register handler: {:?}, for event: {:?}",
                &event,
                &handler.handler_id()
            );
        }

        self
    }
}