jarvy 0.0.5

Jarvy is a fast, cross-platform CLI that installs and manages developer tools across macOS and Linux.
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
110

//! Git - distributed version control system
//!
//! This tool uses the ToolSpec pattern for declarative installation.

use crate::define_tool;

define_tool!(GIT, {
    command: "git",
    macos: { brew: "git" },
    linux: { uniform: "git" },
    windows: { winget: "Git.Git" },
    bsd: { pkg: "git" },
    default_hook: {
        description: "Configure sensible Git defaults (defaultBranch=main, autocrlf, rebase)",
        script: r#"
# Git configuration defaults
# Only set values if they're not already configured

# Set default branch to main (idempotent)
if ! git config --global --get init.defaultBranch >/dev/null 2>&1; then
    git config --global init.defaultBranch main
    echo "Set git init.defaultBranch to 'main'"
fi

# Set autocrlf based on platform (idempotent)
if ! git config --global --get core.autocrlf >/dev/null 2>&1; then
    if [ "$(uname)" = "Darwin" ] || [ "$(uname)" = "Linux" ]; then
        git config --global core.autocrlf input
        echo "Set git core.autocrlf to 'input' (Unix)"
    else
        git config --global core.autocrlf true
        echo "Set git core.autocrlf to 'true' (Windows)"
    fi
fi

# Set pull.rebase for cleaner history (idempotent)
if ! git config --global --get pull.rebase >/dev/null 2>&1; then
    git config --global pull.rebase true
    echo "Set git pull.rebase to 'true'"
fi
"#
    },
});

#[cfg(test)]
mod tests {
    use super::*;
    use crate::tools::common::InstallError;

    // Generic test: ensure calling Git installer path does not panic.
    // Actual OS-specific installation success is covered by e2e tests.
    #[test]
    fn ensure_git_no_panic() {
        let res = ensure("");
        // Do not assert success; environments may lack permissions or prerequisites.
        assert!(res.is_ok() || res.is_err());
    }

    // Platform-specific expectations for Git installer behavior.
    // Windows: Git is supported; ensure/install should never return Unsupported.
    #[cfg(target_os = "windows")]
    #[test]
    fn git_windows_not_unsupported() {
        let res = ensure("");
        assert!(
            !matches!(res, Err(InstallError::Unsupported)),
            "git on Windows should not return Unsupported",
        );
    }

    // macOS: Git install path requires Homebrew; if missing, expect Prereq.
    // Otherwise, it should not be Unsupported (command may fail in CI due to permissions).
    #[cfg(target_os = "macos")]
    #[test]
    fn git_macos_expected_outcome() {
        if !crate::tools::common::has("brew") {
            let res = ensure("");
            assert!(
                matches!(res, Err(InstallError::Prereq(_))),
                "Expected Prereq when Homebrew is absent"
            );
        } else {
            let res = ensure("");
            assert!(
                !matches!(res, Err(InstallError::Unsupported)),
                "git on macOS should not return Unsupported",
            );
        }
    }

    // Linux: use detected package manager; if none detected, expect Prereq.
    // Otherwise, it should not be Unsupported (commands may fail in CI due to permissions).
    #[cfg(target_os = "linux")]
    #[test]
    fn git_linux_expected_outcome() {
        let has_pm = crate::tools::common::detect_linux_pm().is_some();
        let res = ensure("");
        if !has_pm {
            assert!(
                matches!(res, Err(InstallError::Prereq(_))),
                "Expected Prereq when no supported package manager is detected"
            );
        } else {
            assert!(
                !matches!(res, Err(InstallError::Unsupported)),
                "git on Linux should not return Unsupported",
            );
        }
    }
}