rsys 0.5.5

Crate for system and hardware information parsing
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

#![allow(dead_code)]

use crate::{Error, Result};
use std::{fmt::Display, fs, path::PathBuf, str::FromStr};

/// SysPath is an abstraction around procfs and sysfs. Allows for easy reading and parsing
/// of values in system paths.
#[derive(Clone)]
pub(crate) enum SysPath<'p> {
    ProcHostname,
    ProcDomainName,
    ProcCpuInfo,
    ProcMemInfo,
    ProcUptime,
    ProcKernelRelease,
    ProcMounts,
    ProcNetDev,
    ProcNetArp,
    ProcPidStat(i32),
    Proc,
    SysBlock,
    SysBlockDevSize(&'p str),
    SysBlockDevStat(&'p str),
    SysBlockDevModel(&'p str),
    SysBlockDevVendor(&'p str),
    SysBlockDevState(&'p str),
    SysBlockDev(&'p str),
    SysClassBlock,
    SysClassBlockDev(&'p str),
    SysClassNet,
    SysClassNetDev(&'p str),
    SysDevMapperName(&'p str),
    SysDevMapperUuid(&'p str),
    SysDevicesSystemCpu(),
    SysDevicesSystemCpuCore(u32),
    Dev(&'p str),
    Custom(PathBuf),
}
impl<'p> SysPath<'p> {
    pub(crate) fn path(self) -> PathBuf {
        use SysPath::*;
        let s = match self {
            ProcHostname => "/proc/sys/kernel/hostname".to_string(),
            ProcDomainName => "/proc/sys/kernel/domainname".to_string(),
            ProcCpuInfo => "/proc/cpuinfo".to_string(),
            ProcMemInfo => "/proc/meminfo".to_string(),
            ProcUptime => "/proc/uptime".to_string(),
            ProcKernelRelease => "/proc/sys/kernel/osrelease".to_string(),
            ProcMounts => "/proc/mounts".to_string(),
            ProcNetDev => "/proc/net/dev".to_string(),
            ProcNetArp => "/proc/net/arp".to_string(),
            ProcPidStat(n) => format!("/proc/{}/stat", n),
            Proc => "/proc".to_string(),
            SysBlockDevSize(d) => format!("/sys/block/{}/size", d),
            SysBlockDevStat(d) => format!("/sys/block/{}/stat", d),
            SysBlockDevModel(d) => format!("/sys/block/{}/device/model", d),
            SysBlockDevVendor(d) => format!("/sys/block/{}/device/vendor", d),
            SysBlockDevState(d) => format!("/sys/block/{}/device/state", d),
            SysBlock => "/sys/block/".to_string(),
            SysBlockDev(d) => format!("/sys/block/{}", d),
            SysClassBlock => "/sys/class/block".to_string(),
            SysClassBlockDev(d) => format!("/sys/class/block/{}", d),
            SysClassNet => "/sys/class/net".to_string(),
            SysClassNetDev(d) => format!("/sys/class/net/{}", d),
            SysDevMapperName(d) => format!("/sys/block/{}/dm/name", d),
            SysDevMapperUuid(d) => format!("/sys/block/{}/dm/uuid", d),
            SysDevicesSystemCpu() => "/sys/devices/system/cpu".to_string(),
            SysDevicesSystemCpuCore(d) => format!("/sys/devices/system/cpu/cpu{}", d),
            Dev(d) => format!("/dev/{}", d),
            Custom(p) => p.to_string_lossy().to_string(),
        };
        PathBuf::from(s)
    }

    /// Reads path to a string returning FileReadError on error
    pub(crate) fn read(self) -> Result<String> {
        let path = self.path();
        fs::read_to_string(&path)
            .map_err(|e| Error::FileReadError(path.as_path().to_string_lossy().to_string(), e.to_string()))
    }

    /// Reads path and parses it as T otherwise returns FileReadError or InvalidInputError on error
    pub(crate) fn read_as<T: FromStr>(self) -> Result<T>
    where
        <T as FromStr>::Err: Display,
    {
        let path = self.path();
        let data = fs::read_to_string(&path)
            .map_err(|e| Error::FileReadError(path.as_path().to_string_lossy().to_string(), e.to_string()))?;

        T::from_str(data.trim()).map_err(|e| Error::InvalidInputError(data, e.to_string()))
    }

    /// Returns iterator over entries of this path
    pub(crate) fn read_dir(self) -> Result<fs::ReadDir> {
        let path = self.path();
        fs::read_dir(&path)
            .map_err(|e| Error::FileReadError(path.as_path().to_string_lossy().to_string(), e.to_string()))
    }

    /// Extends path with new elements returning a custom SysPath
    pub(crate) fn extend(self, p: &[&str]) -> Self {
        let mut path = self.path();
        for elem in p {
            path.push(elem);
        }
        SysPath::Custom(path)
    }
}