udevrs 0.5.0

Pure Rust implementation of the user-land udev library
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

use std::fmt;

/// Convenience alias for the `udev` library `Result` type.
pub type Result<T> = std::result::Result<T, Error>;

/// Error types for the `udev` library.
#[repr(C)]
#[derive(Clone, Debug, PartialEq)]
pub enum Error {
    InvalidLen(usize),
    Udev(String),
    UdevDevice(String),
    UdevHwdb(String),
    UdevMonitor(String),
    UdevEnumerate(String),
    UdevQueue(String),
    UdevUtil(String),
    Io {
        kind: std::io::ErrorKind,
        err: String,
    },
}

impl Error {
    /// Convenience function to create a I/O error.
    pub fn io<S: Into<String>>(kind: std::io::ErrorKind, err: S) -> Self {
        Self::Io {
            kind,
            err: err.into(),
        }
    }

    /// Convenience function to create a I/O error.
    pub fn io_other<S: Into<String>>(err: S) -> Self {
        Self::Io {
            kind: std::io::ErrorKind::Other,
            err: err.into(),
        }
    }

    /// Gets the [ErrorKind](std::io::ErrorKind).
    pub fn kind(&self) -> std::io::ErrorKind {
        match self {
            Self::Io { kind, .. } => *kind,
            _ => std::io::ErrorKind::Other,
        }
    }
}

impl From<std::io::Error> for Error {
    fn from(err: std::io::Error) -> Self {
        Self::io(err.kind(), format!("{err}"))
    }
}

impl From<Error> for std::io::Error {
    fn from(err: Error) -> Self {
        match err {
            Error::Io { kind, err } => Self::new(kind, err),
            err => Self::new(err.kind(), format!("{err}")),
        }
    }
}

impl From<Error> for std::io::ErrorKind {
    fn from(err: Error) -> Self {
        err.kind()
    }
}

impl From<std::array::TryFromSliceError> for Error {
    fn from(err: std::array::TryFromSliceError) -> Self {
        Self::io_other(format!("{err}"))
    }
}

impl From<glob::PatternError> for Error {
    fn from(err: glob::PatternError) -> Self {
        Self::io_other(format!("invalid glob pattern: {err}"))
    }
}

impl From<std::ffi::NulError> for Error {
    fn from(err: std::ffi::NulError) -> Self {
        Self::io_other(format!("invalid FFI C-String: {err}"))
    }
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Self::InvalidLen(err) => write!(f, "udev invalid length: {err}"),
            Self::Udev(err) => write!(f, "udev: {err}"),
            Self::UdevDevice(err) => write!(f, "udev device: {err}"),
            Self::UdevHwdb(err) => write!(f, "udev hwdb: {err}"),
            Self::UdevMonitor(err) => write!(f, "udev monitor: {err}"),
            Self::UdevEnumerate(err) => write!(f, "udev enumerate: {err}"),
            Self::UdevQueue(err) => write!(f, "udev queue: {err}"),
            Self::UdevUtil(err) => write!(f, "udev util: {err}"),
            Self::Io { kind, err } => write!(f, "I/O: kind: {kind}, error: {err}"),
        }
    }
}

impl std::error::Error for Error {}