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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

use std::path::PathBuf;

/// Converts a Docker/Nerdctl image name to a Git branch name
/// Replaces problematic characters according to Git branch naming rules
/// If no tag is specified, adds "latest" as the default tag
pub fn container_image_to_branch(image_name: &str) -> String {
    let normalized = if !image_name.contains(':') && !image_name.contains('@') {
        format!("{image_name}:latest")
    } else {
        image_name.to_string()
    };

    normalized
        .replace(":", "#")
        .replace("/", "-")
        .replace("@", "-")
}

/// Extracts filename from a tar path and sanitizes it for Git branch naming
/// Removes file extension and sanitizes problematic characters
pub fn tar_path_to_branch(tar_path: &str) -> String {
    let path = PathBuf::from(tar_path);
    let filename = path
        .file_stem()
        .and_then(|name| name.to_str())
        .unwrap_or("tar-image");

    super::sanitize_branch_name(filename)
}

/// Combines a base branch name with os-arch and a digest to create the final branch name
/// Extracts short digest (first 12 characters after "sha256:")
pub fn combine_branch_with_digest(base_branch: &str, os_arch: &str, image_digest: &str) -> String {
    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_container_image_to_branch() {
        // Test Docker/Nerdctl naming with explicit tags
        assert_eq!(
            container_image_to_branch("hello-world:latest"),
            "hello-world#latest"
        );
        assert_eq!(
            container_image_to_branch("nginx/nginx:1.21"),
            "nginx-nginx#1.21"
        );
        assert_eq!(
            container_image_to_branch("registry.example.com/my-app:v1.0"),
            "registry.example.com-my-app#v1.0"
        );
        assert_eq!(
            container_image_to_branch("alpine@sha256:abc123"),
            "alpine-sha256#abc123"
        );
        assert_eq!(
            container_image_to_branch("library/ubuntu:20.04"),
            "library-ubuntu#20.04"
        );

        // Test automatic "latest" tag addition
        assert_eq!(
            container_image_to_branch("hello-world"),
            "hello-world#latest"
        );
        assert_eq!(container_image_to_branch("nginx"), "nginx#latest");
        assert_eq!(
            container_image_to_branch("library/ubuntu"),
            "library-ubuntu#latest"
        );
    }

    #[test]
    fn test_tar_path_to_branch() {
        assert_eq!(tar_path_to_branch("/path/to/my-image.tar"), "my-image");
        assert_eq!(
            tar_path_to_branch("./nginx-latest.tar.gz"),
            "nginx-latest-tar"
        );
        assert_eq!(tar_path_to_branch("ubuntu 20.04.tar"), "ubuntu-20-04");
        assert_eq!(tar_path_to_branch("my:app@v1.0.tar"), "my-app-v1-0");
        assert_eq!(tar_path_to_branch("hello world.tar"), "hello-world");
        assert_eq!(
            tar_path_to_branch("file with spaces & symbols!.tar"),
            "file-with-spaces-symbols"
        );
    }

    #[test]
    fn test_combine_branch_with_digest() {
        // Test with proper SHA256 prefix
        assert_eq!(
            combine_branch_with_digest(
                "hello-world#latest",
                "linux-amd64",
                "sha256:1234567890abcdef"
            ),
            "hello-world#latest#linux-amd64#1234567890ab"
        );
        assert_eq!(
            combine_branch_with_digest("nginx#1.21", "linux-arm64", "sha256:9876543210fedcba"),
            "nginx#1.21#linux-arm64#9876543210fe"
        );

        // Test fallback without SHA256 prefix
        assert_eq!(
            combine_branch_with_digest("my-image", "windows-amd64", "abcdef123456789"),
            "my-image#windows-amd64#abcdef123456789"
        );
    }
}