system-utils 0.1.6

Cross-platform utilities for interacting with operating system features such as audio control, power management, system information, hardware monitoring, and device enumeration.
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

#![allow(unused_imports)]
use crate::prelude::DynError;
use macron::{Display, Error, From};

#[cfg(feature = "theme")]
#[derive(Debug, Display, Error, From)]
pub enum ThemeError {
    #[cfg(target_os = "linux")]
    #[display(fmt = "Failed to execute gsettings: {0}")]
    GsettingsExecute(std::io::Error),

    #[cfg(target_os = "linux")]
    #[display(fmt = "gsettings exited with non-zero status")]
    GsettingsExitStatus,

    #[cfg(target_os = "macos")]
    #[display(fmt = "Failed to execute osascript: {0}")]
    OsascriptExecute(std::io::Error),

    #[cfg(target_os = "macos")]
    #[display(fmt = "osascript exited with non-zero status")]
    OsascriptExitStatus,

    #[display(fmt = "Unsupported operating system")]
    UnsupportedOS,
}

/// The audio error
#[cfg(feature = "audio")]
#[derive(Debug, Display, Error, From)]
pub enum AudioError {
    #[display(fmt = "Audio devices not found")]
    DevicesNotFound,

    #[from(skip)]
    #[display(fmt = "Set volume failed: {0}")]
    SetVolume(DynError),

    #[from(skip)]
    #[display(fmt = "Get volume failed: {0}")]
    GetVolume(DynError),

    #[from(skip)]
    #[display(fmt = "Get mute status failed: {0}")]
    GetMute(DynError),

    #[from(skip)]
    #[display(fmt = "Get mute volume failed: {0}")]
    SetMute(DynError),

    #[display(fmt = "Unsupported operating system")]
    UnsupportedOS,
}

/// The media error
#[cfg(feature = "media")]
#[derive(Debug, Display, Error, From)]
pub enum MediaError {
    #[display(fmt = "No active media player is available")]
    PlayerNotFound,

    #[display(fmt = "Unsupported operating system")]
    UnsupportedOS,
}

#[cfg(feature = "power")]
#[derive(Debug, Display, Error, From)]
pub enum PowerError {
    #[display(fmt = "Unsupported operating system")]
    UnsupportedOS,
}