atticus 0.3.0

A mimimal API to create asynchronous actors
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

mod common;

mod request {
    use atticus::actor;

    use super::common::*;

    #[tokio::test]
    async fn echo() {
        let actor_handle = actor::run(TestActor::default(), 1);
        let response = actor_handle
            .requestor
            .request(Message::Echo("ping".to_owned()))
            .await
            .unwrap();
        assert_eq!(response.unwrap(), ResponseMsg::Echo("ping".to_owned()));
    }

    #[tokio::test]
    async fn add_one() {
        const NUMBER: i32 = 6;
        let actor_handle = actor::run(TestActor::default(), 1);
        let response = actor_handle
            .requestor
            .request(Message::AddOne(NUMBER))
            .await
            .unwrap();
        assert_eq!(response.unwrap(), ResponseMsg::Number(NUMBER + 1));
    }

    #[tokio::test]
    async fn respond_with_none() {
        let actor_handle = actor::run(TestActor::default(), 1);
        let response = actor_handle
            .requestor
            .request(Message::IgnoreThis)
            .await
            .unwrap();
        assert_eq!(response, None);
    }

    #[tokio::test]
    async fn multiple_requestors() {
        const NUMBER: i32 = 6;
        let actor_handle = actor::run(TestActor::default(), 1);

        let requestor2 = actor_handle.requestor.clone();

        let req2 =
            tokio::spawn(async move { requestor2.request(Message::AddOne(NUMBER)).await.unwrap() });

        let response = actor_handle
            .requestor
            .request(Message::Echo("ping!".to_string()))
            .await
            .unwrap();

        assert_eq!(response, Some(ResponseMsg::Echo("ping!".to_string())));
        assert_eq!(req2.await.unwrap(), Some(ResponseMsg::Number(7)));
    }

    #[tokio::test]
    async fn send_an_event() {
        let actor_handle = actor::run(TestActor::default(), 1);
        let event_task_handle = actor_handle.requestor.send_event(Message::IgnoreThis);

        // Let's do an await here to make sure that the actor has received the event before
        // proceding with the next request.
        // In actual practice, this is not really needed but may be used for niche cases.
        event_task_handle.await.unwrap().unwrap();

        let last_request = actor_handle
            .requestor
            .request(Message::GetLastRequest)
            .await
            .unwrap();

        assert_eq!(
            last_request.unwrap(),
            ResponseMsg::LastRequest(Some(Message::IgnoreThis))
        );
    }
}