ferro-events 0.1.83

Event dispatcher and listener system for Ferro framework
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

# ferro-events

Event dispatcher and listener system for the Ferro framework.

## Features

- Synchronous event listeners
- Asynchronous listeners
- Queued listeners via `ShouldQueue` marker
- Automatic listener discovery via inventory

## Usage

```rust
use ferro_events::{Event, Listener, dispatch};

// Define an event
#[derive(Clone)]
struct UserRegistered {
    user_id: i64,
    email: String,
}

impl Event for UserRegistered {
    fn name(&self) -> &'static str {
        "UserRegistered"
    }
}

// Define a listener
struct SendWelcomeEmail;

#[async_trait::async_trait]
impl Listener<UserRegistered> for SendWelcomeEmail {
    async fn handle(&self, event: &UserRegistered) -> Result<(), ferro_events::Error> {
        println!("Sending welcome email to {}", event.email);
        Ok(())
    }
}

// Dispatch an event
dispatch(UserRegistered {
    user_id: 1,
    email: "test@example.com".into(),
}).await;
```

## Queued Listeners

Mark a listener to be processed in the background:

```rust
impl ShouldQueue for SendWelcomeEmail {}
```

## License

MIT