hannibal 0.16.3

A small actor library
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

use std::time::Duration;

use hannibal::{RestartableActor, error::ActorError, prelude::*, runtime::sleep};

#[derive(Debug, Default)]
struct SleepyActor(u8);

#[message]
struct Sleep(Duration);

impl Actor for SleepyActor {
    async fn started(&mut self, _ctx: &mut Context<Self>) -> DynResult<()> {
        println!("[ SleepyActor {} ] started", self.0);
        Ok(())
    }

    async fn stopped(&mut self, _ctx: &mut Context<Self>) {
        println!("[ SleepyActor {} ] stopped", self.0);
    }
}

impl Handler<Sleep> for SleepyActor {
    async fn handle(&mut self, _ctx: &mut Context<Self>, msg: Sleep) {
        println!("[ SleepyActor {} ] is resting for {:?}", self.0, msg.0);
        sleep(msg.0).await;
        println!("[ SleepyActor {} ] woke up after {:?}", self.0, msg.0);
    }
}

// TODO: can we encode the restart strategy in an associated type or as a trait function?
impl RestartableActor for SleepyActor {}

#[hannibal::main]
async fn main() {
    env_logger::init();
    color_backtrace::install();

    // normal case, tasks take long
    println!("SleepyActor 0 will take 1 second to complete");
    let mut addr = SleepyActor(0)
        .setup_actor()
        .bounded(1)
        .recreate_from_default()
        .spawn();
    addr.call(Sleep(Duration::from_millis(100))).await.unwrap();
    assert!(addr.stop().is_ok());

    // timeout and continue
    println!("SleepyActor 1 will be canceled after 1 second");
    println!("SleepyActor 1 still accepts messages after being canceled");
    let mut addr = hannibal::setup_actor(SleepyActor(1))
        .bounded(1)
        .timeout(Duration::from_millis(100))
        .fail_on_timeout(false)
        .recreate_from_default()
        .spawn_owning();
    assert!(
        addr.as_ref()
            .call(Sleep(Duration::from_secs(0)))
            .await
            .is_ok()
    );
    assert!(matches!(
        addr.call(Sleep(Duration::from_secs(4))).await.unwrap_err(),
        ActorError::Canceled(_)
    ));
    assert!(addr.call(Sleep(Duration::from_secs(0))).await.is_ok());
    eprintln!("SleepyActor 2 is still alive, stopping");
    assert!(addr.stop().is_ok());
    assert!(addr.join().await.is_some());

    // timeout and fail
    println!("SleepyActor 2 will be canceled after 1 second");
    let mut addr = hannibal::setup_actor(SleepyActor(2))
        .bounded(1)
        .timeout(Duration::from_millis(100))
        .fail_on_timeout(true)
        .recreate_from_default()
        .spawn_owning();
    assert!(
        addr.as_ref()
            .call(Sleep(Duration::from_secs(60)))
            .await
            .is_err()
    );
    println!("SleepyActor 2 nolonger accepts messages after being canceled");
    assert!(
        addr.as_ref()
            .call(Sleep(Duration::from_secs(0)))
            .await
            .is_err()
    );
    assert!(addr.join().await.is_none());
    assert!(addr.stop().is_err());
}