libsession 0.1.8

Session messenger core library - cryptography, config management, networking
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

//! Notification settings for Session configs.
//!
//! Port of `libsession-util/include/session/config/notify.hpp`.

/// Notification mode for a conversation or group.
#[repr(i32)]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum NotifyMode {
    /// Use the default notification setting.
    #[default]
    Default = 0,
    /// Notify for all messages.
    All = 1,
    /// Notifications are disabled.
    Disabled = 2,
    /// Notify only for mentions (groups only; for DMs this becomes `All`).
    MentionsOnly = 3,
}

impl NotifyMode {
    /// Creates a `NotifyMode` from a raw `i32` value.
    ///
    /// Returns `Default` for unrecognized values.
    pub fn from_raw(val: i32) -> Self {
        match val {
            0 => NotifyMode::Default,
            1 => NotifyMode::All,
            2 => NotifyMode::Disabled,
            3 => NotifyMode::MentionsOnly,
            _ => NotifyMode::Default,
        }
    }
}

/// What content to include in notifications.
#[repr(i32)]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum NotifyContent {
    /// Use the default content setting.
    #[default]
    Default = 0,
    /// Show sender name and message preview.
    NameAndPreview = 1,
    /// Show sender name but no message preview.
    NameNoPreview = 2,
    /// Show neither sender name nor message preview.
    NoNameNoPreview = 3,
}

impl NotifyContent {
    /// Creates a `NotifyContent` from a raw `i32` value.
    ///
    /// Returns `Default` for unrecognized values.
    pub fn from_raw(val: i32) -> Self {
        match val {
            0 => NotifyContent::Default,
            1 => NotifyContent::NameAndPreview,
            2 => NotifyContent::NameNoPreview,
            3 => NotifyContent::NoNameNoPreview,
            _ => NotifyContent::Default,
        }
    }
}

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

    #[test]
    fn test_notify_mode_repr() {
        assert_eq!(NotifyMode::Default as i32, 0);
        assert_eq!(NotifyMode::All as i32, 1);
        assert_eq!(NotifyMode::Disabled as i32, 2);
        assert_eq!(NotifyMode::MentionsOnly as i32, 3);
    }

    #[test]
    fn test_notify_mode_from_raw() {
        assert_eq!(NotifyMode::from_raw(0), NotifyMode::Default);
        assert_eq!(NotifyMode::from_raw(1), NotifyMode::All);
        assert_eq!(NotifyMode::from_raw(2), NotifyMode::Disabled);
        assert_eq!(NotifyMode::from_raw(3), NotifyMode::MentionsOnly);
        assert_eq!(NotifyMode::from_raw(99), NotifyMode::Default);
        assert_eq!(NotifyMode::from_raw(-1), NotifyMode::Default);
    }

    #[test]
    fn test_notify_content_repr() {
        assert_eq!(NotifyContent::Default as i32, 0);
        assert_eq!(NotifyContent::NameAndPreview as i32, 1);
        assert_eq!(NotifyContent::NameNoPreview as i32, 2);
        assert_eq!(NotifyContent::NoNameNoPreview as i32, 3);
    }

    #[test]
    fn test_notify_content_from_raw() {
        assert_eq!(NotifyContent::from_raw(0), NotifyContent::Default);
        assert_eq!(NotifyContent::from_raw(1), NotifyContent::NameAndPreview);
        assert_eq!(NotifyContent::from_raw(2), NotifyContent::NameNoPreview);
        assert_eq!(NotifyContent::from_raw(3), NotifyContent::NoNameNoPreview);
        assert_eq!(NotifyContent::from_raw(42), NotifyContent::Default);
    }

    #[test]
    fn test_notify_mode_default() {
        let mode: NotifyMode = Default::default();
        assert_eq!(mode, NotifyMode::Default);
    }

    #[test]
    fn test_notify_content_default() {
        let content: NotifyContent = Default::default();
        assert_eq!(content, NotifyContent::Default);
    }
}