oci2git 0.2.5

A tool to convert OCI images to Git repositories
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

use anyhow::{anyhow, Context, Result};
use std::path::PathBuf;
use std::process::Command;
use tempfile::TempDir;

use super::Source;
use crate::notifier::Notifier;

pub struct NerdctlSource;

impl NerdctlSource {
    pub fn new() -> Result<Self> {
        let output = Command::new("nerdctl")
            .arg("--version")
            .output()
            .context("Failed to execute nerdctl command. Is nerdctl installed?")?;

        if !output.status.success() {
            return Err(anyhow!("nerdctl is not available"));
        }

        Ok(Self)
    }
}

impl Source for NerdctlSource {
    fn name(&self) -> &str {
        "nerdctl"
    }

    fn get_image_tarball(
        &self,
        _image_name: &str,
        _notifier: &Notifier,
    ) -> Result<(PathBuf, Option<TempDir>)> {
        // This will be implemented in the future
        unimplemented!("nerdctl support is not yet implemented")
    }

    fn branch_name(&self, image_name: &str, os_arch: &str, image_digest: &str) -> String {
        // nerdctl uses docker-like naming
        // If no tag is specified, add "latest" as the default tag
        let normalized = if !image_name.contains(':') && !image_name.contains('@') {
            format!("{image_name}:latest")
        } else {
            image_name.to_string()
        };

        let base_branch = normalized
            .replace(":", "#")
            .replace("/", "-")
            .replace("@", "-");

        if let Some(short_digest) = super::extract_short_digest(image_digest) {
            format!("{base_branch}#{os_arch}#{short_digest}")
        } else {
            // Fallback: use image_digest as-is if it doesn't have sha256: prefix
            format!("{base_branch}#{os_arch}#{image_digest}")
        }
    }
}

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

    #[test]
    fn test_nerdctl_source_branch_name() {
        // Create a source directly without checking if nerdctl is available
        let source = NerdctlSource;
        // The processor always provides the os_arch and digest extracted from image metadata
        assert_eq!(
            source.branch_name(
                "hello-world:latest",
                "linux-amd64",
                "sha256:1234567890abcdef"
            ),
            "hello-world#latest#linux-amd64#1234567890ab"
        );
        assert_eq!(
            source.branch_name("hello-world", "linux-arm64", "sha256:1234567890abcdef"),
            "hello-world#latest#linux-arm64#1234567890ab"
        );
        assert_eq!(
            source.branch_name("nginx/nginx:1.21", "linux-amd64", "sha256:9876543210fedcba"),
            "nginx-nginx#1.21#linux-amd64#9876543210fe"
        );
        assert_eq!(
            source.branch_name("nginx", "windows-amd64", "sha256:abcdef123456789"),
            "nginx#latest#windows-amd64#abcdef123456"
        );
        // Test fallback for digest without sha256: prefix
        assert_eq!(
            source.branch_name("nginx", "linux-amd64", "abcdef123456789"),
            "nginx#latest#linux-amd64#abcdef123456789"
        );
    }
}