rifts 0.3.4

Rift Realtime Protocol / 1.0 — server + client implementation
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

use std::collections::HashMap;

use crate::message::SubscribeMode;

/// Tracks which topics the client is subscribed to so they can be
/// re-sent after a reconnect.
#[derive(Debug)]
pub(super) struct SubscriptionTracker {
    topics: HashMap<String, SubscribeMode>,
}

impl SubscriptionTracker {
    pub(super) fn new() -> Self {
        Self {
            topics: HashMap::new(),
        }
    }

    /// Record a new subscription (or update the mode of an existing one).
    pub(super) fn add(&mut self, topic: &str, mode: SubscribeMode) {
        self.topics.insert(topic.to_string(), mode);
    }

    /// Remove a subscription. Returns `true` if it existed.
    pub(super) fn remove(&mut self, topic: &str) -> bool {
        self.topics.remove(topic).is_some()
    }

    /// Returns the mode for a topic, if subscribed.
    #[allow(dead_code)]
    pub(super) fn get(&self, topic: &str) -> Option<SubscribeMode> {
        self.topics.get(topic).copied()
    }

    /// Iterate all tracked subscriptions.
    pub(super) fn iter(&self) -> impl Iterator<Item = (&String, &SubscribeMode)> {
        self.topics.iter()
    }

    /// Returns the number of tracked subscriptions.
    #[allow(dead_code)]
    pub(super) fn len(&self) -> usize {
        self.topics.len()
    }

    #[allow(dead_code)]
    pub(super) fn is_empty(&self) -> bool {
        self.topics.is_empty()
    }
}

impl Default for SubscriptionTracker {
    fn default() -> Self {
        Self::new()
    }
}

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

    #[test]
    fn add_and_get() {
        let mut t = SubscriptionTracker::new();
        t.add("room/1", SubscribeMode::Live);
        assert_eq!(t.get("room/1"), Some(SubscribeMode::Live));
        assert_eq!(t.get("room/2"), None);
    }

    #[test]
    fn remove() {
        let mut t = SubscriptionTracker::new();
        t.add("a", SubscribeMode::Replay);
        assert!(t.remove("a"));
        assert!(!t.remove("a"));
        assert_eq!(t.len(), 0);
    }

    #[test]
    fn update_mode() {
        let mut t = SubscriptionTracker::new();
        t.add("x", SubscribeMode::Live);
        t.add("x", SubscribeMode::Replay);
        assert_eq!(t.get("x"), Some(SubscribeMode::Replay));
    }

    #[test]
    fn iter_yields_all() {
        let mut t = SubscriptionTracker::new();
        t.add("a", SubscribeMode::Live);
        t.add("b", SubscribeMode::Ephemeral);
        let names: Vec<&str> = t.iter().map(|(k, _)| k.as_str()).collect();
        assert!(names.contains(&"a"));
        assert!(names.contains(&"b"));
    }
}