libimagnotification 0.9.3

Library for the imag core distribution
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

//
// imag - the personal information management suite for the commandline
// Copyright (C) 2015-2019 Matthias Beyer <mail@beyermatthias.de> and contributors
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; version
// 2.1 of the License.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
//

use failure::Fallible as Result;

/// A Notificator provides a function that can be called to notify about a certain object.
///
/// # TODO
///
/// The user of the library does _not_ get access to the notification handle.
/// This is not optimal, but enough for today.
///
pub trait Notificator<T> {
    fn notify(&self, item: &T) -> Result<()>;
}

pub mod default {
    use std::fmt::Debug;
    use std::fmt::Display;

    use failure::Fallible as Result;

    use notify_rust::Notification as RustNotification;
    use notify_rust::NotificationUrgency;

    use super::Notificator;

    #[derive(Clone, PartialEq, Eq, PartialOrd, Ord, Debug)]
    pub enum Urgency {
        Low,
        Normal,
        High
    }

    impl Default for Urgency {
        fn default() -> Urgency {
            Urgency::Normal
        }
    }

    impl Into<NotificationUrgency> for Urgency {

        fn into(self) -> NotificationUrgency {
            match self {
                Urgency::Low    => NotificationUrgency::Low,
                Urgency::Normal => NotificationUrgency::Normal,
                Urgency::High   => NotificationUrgency::Critical,
            }
        }

    }

    #[derive(Debug, Default, Clone)]
    pub struct Notification {
        pub timeout: i32,
        pub message: String,
        pub summary: String,
        pub urgency: Urgency,
    }

    impl<T: Display> Notificator<T> for Notification {

        /// A default implementation for all Types that implement Display
        fn notify(&self, item: &T) -> Result<()> {
            let mut n = RustNotification::new();
            n.appname("imag");
            n.summary(&self.summary);
            n.urgency(self.urgency.clone().into());
            n.body(&format!("{}: {}", &self.message, item));
            let _ = n.finalize().show(); // Ignoring error here
            Ok(())
        }

    }

    #[derive(Debug, Default, Clone)]
    pub struct DebugNotification(Notification);

    impl From<Notification> for DebugNotification {
        fn from(n: Notification) -> DebugNotification {
            DebugNotification(n)
        }
    }

    impl<T: Debug> Notificator<T> for DebugNotification {

        /// A default implementation for all Types that implement Display
        fn notify(&self, item: &T) -> Result<()> {
            let mut n = RustNotification::new();
            n.appname("imag");
            n.summary(&self.0.summary);
            n.urgency(self.0.urgency.clone().into());
            n.body(&format!("{}: {:?}", &self.0.message, item));
            let _ = n.finalize().show(); // Ignoring error here
            Ok(())
        }

    }

}