atomr-core 0.3.0

Actors, supervision, dispatch, mailboxes, scheduler, FSM, event stream, and coordinated shutdown — the core of the atomr actor runtime.
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

//! Backoff supervisor — restart child with exponential backoff.

use std::time::Duration;

#[derive(Debug, Clone)]
pub struct BackoffOptions {
    pub min_backoff: Duration,
    pub max_backoff: Duration,
    pub random_factor: f64,
    pub max_restarts: Option<u32>,
}

impl Default for BackoffOptions {
    fn default() -> Self {
        Self {
            min_backoff: Duration::from_millis(200),
            max_backoff: Duration::from_secs(30),
            random_factor: 0.2,
            max_restarts: Some(10),
        }
    }
}

impl BackoffOptions {
    pub fn next_delay(&self, attempt: u32) -> Duration {
        let base = self.min_backoff.as_secs_f64() * 2f64.powi(attempt as i32);
        let capped = base.min(self.max_backoff.as_secs_f64());
        let jitter = 1.0 + (pseudo_random_01(attempt) * self.random_factor);
        Duration::from_secs_f64(capped * jitter)
    }
}

fn pseudo_random_01(seed: u32) -> f64 {
    // Deterministic stand-in — tests don't depend on true randomness.

    ((seed.wrapping_mul(2654435761)) % 10_000) as f64 / 10_000.0
}

/// Wrapper around the supervisor logic — held by tests and demonstrations.
pub struct BackoffSupervisor {
    pub options: BackoffOptions,
}

impl BackoffSupervisor {
    pub fn new(options: BackoffOptions) -> Self {
        Self { options }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn backoff_grows_but_capped() {
        let o = BackoffOptions::default();
        let d0 = o.next_delay(0);
        let d1 = o.next_delay(1);
        let huge = o.next_delay(30);
        assert!(d0 < d1);
        assert!(huge <= o.max_backoff.mul_f64(1.0 + o.random_factor));
    }
}