up 0.18.1

up is a tool to help you keep your machine up to date.
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

//! macOS specific functions.

use crate::cmd_debug;
use color_eyre::Result;
use color_eyre::eyre::eyre;
use serde_derive::Deserialize;
use serde_derive::Serialize;

/// Get the hardware UUID of the current Mac.
/// You can get the Hardware UUID from:
/// <https://apple.stackexchange.com/questions/342042/how-can-i-query-the-hardware-uuid-of-a-mac-programmatically-from-a-command-line>
pub(crate) fn get_hardware_uuid() -> Result<String> {
    let raw_output = cmd_debug!("ioreg", "-d2", "-a", "-c", "IOPlatformExpertDevice").read()?;
    let ioreg_output: IoregOutput = plist::from_bytes(raw_output.as_bytes())?;
    Ok(ioreg_output
        .io_registry_entry_children
        .into_iter()
        .next()
        .ok_or_else(|| eyre!("Failed to get the Hardware UUID for the current Mac."))?
        .io_platform_uuid)
}

/// XML output returned by `ioreg -d2 -a -c IOPlatformExpertDevice`
#[derive(Debug, Clone, Deserialize, Serialize)]
struct IoregOutput {
    /// The set of `IORegistry` entries.
    #[serde(rename = "IORegistryEntryChildren")]
    io_registry_entry_children: Vec<IoRegistryEntryChildren>,
}

/// A specific `IORegistry` entry.
#[derive(Debug, Clone, Deserialize, Serialize)]
struct IoRegistryEntryChildren {
    /// The platform UUID.
    #[serde(rename = "IOPlatformUUID")]
    io_platform_uuid: String,
}

#[cfg(target_os = "macos")]
#[cfg(test)]
mod tests {
    use color_eyre::Result;
    use testutils::ensure_eq;

    #[test]
    fn test_get_hardware_uuid() -> Result<()> {
        use crate::cmd;
        use crate::utils::mac::get_hardware_uuid;

        let system_profiler_output = cmd!("system_profiler", "SPHardwareDataType").read()?;
        let expected_value = system_profiler_output
            .lines()
            .find_map(|line| {
                line.contains("UUID")
                    .then(|| line.split_whitespace().last().unwrap())
            })
            .unwrap();
        let actual_value = get_hardware_uuid()?;
        ensure_eq!(expected_value, actual_value);
        Ok(())
    }
}