zenops 0.13.0

Declarative system configuration management for shell config and dotfiles.
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

//! Tiny abstraction over the host's package manager.
//!
//! [`detect`] probes `PATH` and returns a [`DetectedPackageManager`] when a
//! supported manager is available. Today only Homebrew is wired up; `apt`,
//! `pacman`, and friends are flagged as expansion points in-source — adding
//! one means extending the enum, [`detect`], [`DetectedPackageManager::packages_for`],
//! [`DetectedPackageManager::install_command`], and the matching
//! `InstallHint` field.

use crate::{config::pkg::InstallHint, error::Error};

/// A package manager zenops successfully detected on the current host.
/// Today only Homebrew; the variant enumerates expansion points for
/// future managers.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum DetectedPackageManager {
    /// Homebrew (macOS or Linuxbrew).
    Brew,
    // Future package managers (apt, pacman, yum, dnf, zypper, apk, pkg, …)
    // should be added here, detected in `detect`, and wired into
    // `packages_for` / `install_command` / `InstallHint`.
}

impl DetectedPackageManager {
    /// Stable lowercase identifier, suitable for shell strings, JSON
    /// output, and serde tags (e.g. `"brew"`).
    pub fn name(self) -> &'static str {
        match self {
            Self::Brew => "brew",
        }
    }

    /// Packages this manager would install for the given install hint.
    /// Returns an empty slice when the hint has no entry for this manager.
    pub fn packages_for(self, hint: &InstallHint) -> &[String] {
        match self {
            Self::Brew => &hint.brew.packages,
        }
    }

    /// Build the one-shot command that installs the given packages via this manager.
    pub fn install_command(self, packages: &[String]) -> String {
        match self {
            Self::Brew => format!("brew install {}", packages.join(" ")),
        }
    }
}

/// Probe `PATH` for a supported package manager. Returns the first match
/// in priority order, or `None` if nothing supported is on `PATH`.
pub fn detect() -> Result<Option<DetectedPackageManager>, Error> {
    if crate::utils::which::exists("brew")? {
        return Ok(Some(DetectedPackageManager::Brew));
    }
    Ok(None)
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::config::pkg::BrewHint;

    #[test]
    fn packages_for_brew_returns_packages_list() {
        let hint = InstallHint {
            brew: BrewHint {
                packages: vec!["sk".into(), "fd".into()],
            },
        };
        assert_eq!(
            DetectedPackageManager::Brew.packages_for(&hint),
            ["sk", "fd"]
        );
    }

    #[test]
    fn packages_for_empty_returns_empty_slice() {
        let hint = InstallHint::default();
        assert!(DetectedPackageManager::Brew.packages_for(&hint).is_empty());
    }

    #[test]
    fn install_command_joins_packages_with_spaces() {
        let pkgs = vec!["sk".into(), "starship".into()];
        assert_eq!(
            DetectedPackageManager::Brew.install_command(&pkgs),
            "brew install sk starship"
        );
    }
}