hydra 0.1.40

A framework for writing fault tolerant, highly scalable applications with the Rust programming language.
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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

use std::sync::Arc;
use std::sync::atomic::AtomicBool;
use std::sync::atomic::Ordering;
use std::time::Duration;

use hydra::ExitReason;
use hydra::Message;
use hydra::Process;
use hydra::SystemMessage;

#[hydra::test]
async fn monitor_works() {
    let pid = Process::spawn(async {
        Process::sleep(Duration::from_millis(50)).await;
        panic!("we're going down!");
    });

    let reference = Process::monitor(pid);

    let message: Message<()> = Process::receive().await;

    if let Message::System(SystemMessage::ProcessDown(object, mref, exit_reason)) = message {
        assert!(object == pid);
        assert!(reference == mref);
        assert!(matches!(exit_reason, ExitReason::Custom(_)));
    } else {
        panic!("Expected process down message!");
    }
}

#[hydra::test]
async fn monitor_named_works() {
    let pid = Process::spawn(async {
        Process::sleep(Duration::from_millis(50)).await;
        panic!("we're going down!");
    });

    Process::register(pid, "monitor_me").expect("Failed to register process!");

    let reference = Process::monitor("monitor_me");

    let message: Message<()> = Process::receive().await;

    if let Message::System(SystemMessage::ProcessDown(object, mref, exit_reason)) = message {
        assert!(object == "monitor_me");
        assert!(reference == mref);
        assert!(matches!(exit_reason, ExitReason::Custom(_)));
    } else {
        panic!("Expected process down message!");
    }
}

#[hydra::test]
async fn monitor_noproc_works() {
    let pid = Process::spawn(async {
        // End immediately.
    });

    Process::sleep(Duration::from_millis(10)).await;

    let reference1 = Process::monitor("no_exists");
    let reference2 = Process::monitor(pid);

    let message1: Message<()> = Process::receive().await;
    let message2: Message<()> = Process::receive().await;

    if let Message::System(SystemMessage::ProcessDown(object, mref, exit_reason)) = message1 {
        assert!(object == "no_exists");
        assert!(reference1 == mref);
        assert!(matches!(exit_reason, ExitReason::Custom(_)));
    } else {
        panic!("Expected process down message!");
    }

    if let Message::System(SystemMessage::ProcessDown(object, mref, exit_reason)) = message2 {
        assert!(object == pid);
        assert!(reference2 == mref);
        assert!(matches!(exit_reason, ExitReason::Custom(_)));
    } else {
        panic!("Expected process down message!");
    }
}

#[hydra::test]
async fn demonitor_works() {
    let is_down: Arc<AtomicBool> = Arc::new(AtomicBool::new(false));
    let is_down_ref = is_down.clone();

    let (_, monitor) = Process::spawn_monitor(async move {
        Process::sleep(Duration::from_millis(50)).await;
        is_down_ref.store(true, Ordering::Relaxed);
        panic!("we're going down!");
    });

    Process::demonitor(monitor);

    Process::sleep(Duration::from_millis(75)).await;

    assert!(is_down.load(Ordering::Relaxed));

    Process::send(Process::current(), ());

    let message: Message<()> = Process::receive().await;

    assert!(matches!(message, Message::User(())));
}

#[hydra::test]
async fn spawn_monitor_works() {
    let (pid, reference) = Process::spawn_monitor(async {
        panic!("we're going down!");
    });

    let message: Message<()> = Process::receive().await;

    if let Message::System(SystemMessage::ProcessDown(object, mref, exit_reason)) = message {
        assert!(object == pid);
        assert!(reference == mref);
        assert!(matches!(exit_reason, ExitReason::Custom(_)));
    } else {
        panic!("Expected process down message!");
    }
}