hookable 0.1.1

A thread-safe hook system that allows registering and executing sync and async hooks.
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

# Hookable


A thread-safe hook system that allows registering and executing sync and async hooks.

Hooks are functions that can be attached to named events and executed when those
events are triggered.

## Usage


You can assign both async and sync to the same name. If you do that you will always have to call it using `call_async`.

```rust
use std::time::Duration;
use tokio::time::sleep;
use hookable::Hookable;

fn main() {
    let hookable = Hookable::new();

    // Register a sync hook
    hookable.hook("event", || println!("Sync hook executed"));

    // Register an async hook
    hookable.hook_async("event", || Box::pin(async {
        sleep(Duration::from_millis(200)).await;
    }));

    // ❌ This won't work because one of the events has to be run using await. 
    // `HookableError::AsyncHookCalledSync` will be returned.
    hookable.call("event").unwrap();

    // ✅ This will work.
    hookable.call_async("event").await.unwrap();
}
```

## Credits


The [JS version](https://github.com/unjs/hookable) both inspires this crate and its name