hey_listen 0.5.0

An event-dispatcher-collection offering async, sync, parallel, and prioritised solutions!
Documentation

ci-badge docs-badge rust version badge crates.io version

Hey! Listen!

Hey_listen is a collection of event-dispatchers aiming to suit all needs!
Currently covering:

  • Priority dispatch
  • Threadpool dispatch
  • Async dispatch

View the examples-folder on how to use each dispatcher.

Everyone is welcome to contribute, check out the CONTRIBUTING.md for further guidance.

Example

Here is a quick example on how to use the event-dispatcher:

use hey_listen::sync::{
    ParallelDispatcher, ParallelListener, ParallelDispatchResult,
};

#[derive(Clone, Eq, Hash, PartialEq)]
enum Event {
    Variant,
}

struct Listener {}

impl ParallelListener<Event> for Listener {
    fn on_event(&self, _event: &Event) -> Option<ParallelDispatchResult> {
        println!("I'm listening! :)");

        None
    }
}

fn main() {
    let listener = Listener {};
    let mut dispatcher = ParallelDispatcher::<Event>::new(4).expect("Could not construct threadpool");

    dispatcher.add_listener(Event::Variant, listener);
    dispatcher.dispatch_event(&Event::Variant);
}

Installation

Add this to your Cargo.toml:

[dependencies]
hey_listen = "0.5"