arcbox-docker-tools 0.4.21

Docker CLI tool download, installation, and management
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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

//! Download URL construction and extraction logic for each ArcBox-managed host tool.

/// Format of the downloaded artifact.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ArtifactFormat {
    /// A `.tgz` archive; the `docker` binary lives inside at `docker/docker`.
    Tgz,
    /// A bare binary — download and use directly.
    Binary,
}

/// Returns the download URL for the given tool name, version, and architecture.
///
/// `arch` should be `"arm64"` or `"x86_64"`.
///
/// # Panics
///
/// Panics if `name` is not a known tool.
#[must_use]
pub fn download_url(name: &str, version: &str, arch: &str) -> String {
    match name {
        "docker" => {
            let docker_arch = match arch {
                "arm64" => "aarch64",
                _ => "x86_64",
            };
            format!(
                "https://download.docker.com/mac/static/stable/{docker_arch}/docker-{version}.tgz"
            )
        }
        "docker-buildx" => {
            let gh_arch = match arch {
                "arm64" => "arm64",
                _ => "amd64",
            };
            format!(
                "https://github.com/docker/buildx/releases/download/v{version}/buildx-v{version}.darwin-{gh_arch}"
            )
        }
        "docker-compose" => {
            let compose_arch = match arch {
                "arm64" => "aarch64",
                _ => "x86_64",
            };
            format!(
                "https://github.com/docker/compose/releases/download/v{version}/docker-compose-darwin-{compose_arch}"
            )
        }
        "docker-credential-osxkeychain" => {
            let gh_arch = match arch {
                "arm64" => "arm64",
                _ => "amd64",
            };
            format!(
                "https://github.com/docker/docker-credential-helpers/releases/download/v{version}/docker-credential-osxkeychain-v{version}.darwin-{gh_arch}"
            )
        }
        "kubectl" => {
            let kubectl_arch = match arch {
                "arm64" => "arm64",
                _ => "amd64",
            };
            format!("https://dl.k8s.io/release/v{version}/bin/darwin/{kubectl_arch}/kubectl")
        }
        _ => panic!("unknown host tool: {name}"),
    }
}

/// Returns the artifact format for a given tool name.
#[must_use]
pub fn artifact_format(name: &str) -> ArtifactFormat {
    match name {
        "docker" => ArtifactFormat::Tgz,
        _ => ArtifactFormat::Binary,
    }
}

/// Returns the name of the binary inside the archive for tgz artifacts.
/// For example, the `docker` tgz contains `docker/docker`.
#[must_use]
pub fn tgz_inner_path(name: &str) -> &'static str {
    match name {
        "docker" => "docker/docker",
        _ => panic!("no tgz inner path for {name}"),
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn docker_url_arm64() {
        let url = download_url("docker", "29.3.1", "arm64");
        assert_eq!(
            url,
            "https://download.docker.com/mac/static/stable/aarch64/docker-29.3.1.tgz"
        );
    }

    #[test]
    fn docker_url_x86() {
        let url = download_url("docker", "29.3.1", "x86_64");
        assert_eq!(
            url,
            "https://download.docker.com/mac/static/stable/x86_64/docker-29.3.1.tgz"
        );
    }

    #[test]
    fn buildx_url() {
        let url = download_url("docker-buildx", "0.33.0", "arm64");
        assert!(url.contains("buildx-v0.33.0.darwin-arm64"));
    }

    #[test]
    fn compose_url() {
        let url = download_url("docker-compose", "5.1.1", "arm64");
        assert!(url.contains("docker-compose-darwin-aarch64"));
    }

    #[test]
    fn credential_url() {
        let url = download_url("docker-credential-osxkeychain", "0.9.5", "x86_64");
        assert!(url.contains("docker-credential-osxkeychain-v0.9.5.darwin-amd64"));
    }

    #[test]
    fn artifact_formats() {
        assert_eq!(artifact_format("docker"), ArtifactFormat::Tgz);
        assert_eq!(artifact_format("docker-buildx"), ArtifactFormat::Binary);
        assert_eq!(artifact_format("kubectl"), ArtifactFormat::Binary);
    }

    #[test]
    fn kubectl_url_arm64() {
        let url = download_url("kubectl", "1.35.3", "arm64");
        assert_eq!(
            url,
            "https://dl.k8s.io/release/v1.35.3/bin/darwin/arm64/kubectl"
        );
    }
}