Struct async_event_emitter::AsyncEventEmitter

source ·

pub struct AsyncEventEmitter {
    pub listeners: HashMap<String, Vec<AsyncListener>>,
}

Fields§

§listeners: HashMap<String, Vec<AsyncListener>>

Implementations§

source §

impl AsyncEventEmitter

source

pub fn new() -> Self

source

pub async fn emit<'a, T>(&mut self, event: &str, value: T) -> Result<()>where T: Serialize + Deserialize<'a> + Send + Sync + 'a + Debug,

Emits an event of the given parameters and executes each callback that is listening to that event asynchronously by spawning a task for each callback.

Example

use async_event_emitter::AsyncEventEmitter;
let mut event_emitter = AsyncEventEmitter::new();

// Emits the <"Some event"> event and a value <"Hello programmer">
// The value can be of any type as long as it implements the serde Serialize trait
  tokio_test::block_on(async {
   event_emitter.emit("Some event", "Hello programmer!").await;
     
   
    })

source

pub fn remove_listener(&mut self, id_to_delete: &str) -> Option<String>

Removes an event listener with the given id

Example

use async_event_emitter::AsyncEventEmitter;
let mut event_emitter = AsyncEventEmitter::new();
let listener_id = event_emitter.on("Some event", |value: ()|  async {println!("Hello world!")});
println!("{:?}", event_emitter.listeners);

// Removes the listener that we just added
event_emitter.remove_listener(&listener_id);

source

pub fn on_limited<F, T, C>( &mut self, event: &str, limit: Option<u64>, callback: C ) -> Stringwhere for<'de> T: Deserialize<'de> + Debug, C: Fn(T) -> F + Send + Sync + 'static, F: Future<Output = ()> + Send + Sync + 'static,

Adds an event listener that will only execute the listener x amount of times - Then the listener will be deleted. Returns the id of the newly added listener.

Example

use async_event_emitter::AsyncEventEmitter;
let mut event_emitter = AsyncEventEmitter::new();

// Listener will be executed 3 times. After the third time, the listener will be deleted.

event_emitter.on_limited("Some event", Some(3), |value: ()| async{ println!("Hello world!")});
tokio_test::block_on( async{
event_emitter.emit("Some event", ()).await; // 1 >> "Hello world!"
event_emitter.emit("Some event", ()).await; // 2 >> "Hello world!"
event_emitter.emit("Some event", ()).await; // 3 >> "Hello world!"
event_emitter.emit("Some event", ()).await; // 4 >> <Nothing happens here because listener was deleted after the 3rd call>

});

source

pub fn once<F, T, C>(&mut self, event: &str, callback: C) -> Stringwhere for<'de> T: Deserialize<'de> + Debug, C: Fn(T) -> F + Send + Sync + 'static, F: Future<Output = ()> + Send + Sync + 'static,

Adds an event listener that will only execute the callback once - Then the listener will be deleted. Returns the id of the newly added listener.

Example

use async_event_emitter::AsyncEventEmitter;
let mut event_emitter = AsyncEventEmitter::new();

event_emitter.once("Some event", |value: ()| async {println!("Hello world!")});
event_emitter.emit("Some event", ()); // First event is emitted and the listener's callback is called once
// >> "Hello world!"

event_emitter.emit("Some event", ());
// >> <Nothing happens here since listener was deleted>

source

pub fn on<F, T, C>(&mut self, event: &str, callback: C) -> Stringwhere for<'de> T: Deserialize<'de> + Debug, C: Fn(T) -> F + Send + Sync + 'static, F: Future<Output = ()> + Send + Sync + 'static,

Adds an event listener with a callback that will get called whenever the given event is emitted. Returns the id of the newly added listener.

Example

use async_event_emitter::AsyncEventEmitter;
let mut event_emitter = AsyncEventEmitter::new();

// This will print <"Hello world!"> whenever the <"Some event"> event is emitted
// The type of the `value` parameter for the closure MUST be specified and, if you plan to use the `value`, the `value` type
// MUST also match the type that is being emitted (here we just use a throwaway `()` type since we don't care about using the `value`)
event_emitter.on("Some event", |value: ()| async { println!("Hello world!")});