user-notify 0.4.2

Show desktop notifications to end users on linux, macOS and windows.
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

//! Show desktop notifications to end users on linux, macOS and windows.
//!
//! If you want to see the platform implementation and view this on docs.rs, then make sure to select the correct platform in the header bar.

#![deny(
    unused,
    clippy::correctness,
    missing_debug_implementations,
    missing_docs,
    clippy::all,
    clippy::doc_broken_link,
    clippy::wildcard_imports,
    clippy::needless_borrow,
    clippy::cast_lossless,
    clippy::unused_async,
    clippy::explicit_iter_loop,
    clippy::explicit_into_iter_loop,
    clippy::cloned_instead_of_copied
)]
mod error;
mod notification;
mod platform_impl;
mod xdg_category;

use std::sync::Arc;

pub use error::Error;
pub use notification::*;
pub use platform_impl::*;
pub use xdg_category::*;

/// Get the notification manager for the platform
///
/// `app_id` and `notification_protocol` are only used on windows
#[allow(unused_variables)]
pub fn get_notification_manager(
    app_id: String,
    notification_protocol: Option<String>,
) -> Arc<dyn NotificationManager> {
    #[cfg(target_os = "macos")]
    {
        use objc2_foundation::NSBundle;
        if NSBundle::mainBundle().bundleIdentifier().is_none() {
            return Arc::new(platform_impl::mock::NotificationManagerMock::new())
                as Arc<dyn NotificationManager>;
        }
        Arc::new(platform_impl::mac_os::NotificationManagerMacOS::new())
            as Arc<dyn NotificationManager>
    }
    #[cfg(target_os = "windows")]
    {
        use ::windows::core::HSTRING;
        match ::windows::UI::Notifications::ToastNotificationManager::CreateToastNotifierWithId(
            &HSTRING::from(&app_id),
        ) {
            Ok(_tf) => Arc::new(platform_impl::windows::NotificationManagerWindows::new(
                app_id.clone(),
                notification_protocol,
            )) as Arc<dyn NotificationManager>,
            Err(err) => {
                log::error!(
                    "failed to get toast notifier for {app_id}, falling back to mock notifification manager: {err:?}"
                );
                Arc::new(platform_impl::mock::NotificationManagerMock::new())
                    as Arc<dyn NotificationManager>
            }
        }
    }
    #[cfg(any(
        target_os = "linux",
        target_os = "dragonfly",
        target_os = "freebsd",
        target_os = "openbsd",
        target_os = "netbsd"
    ))]
    {
        Arc::new(platform_impl::xdg::NotificationManagerXdg::new()) as Arc<dyn NotificationManager>
    }
}