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

//! Source trait for getting OCI images from different container sources

pub mod docker;
pub mod nerdctl;
pub mod tar;

// Naming utilities for branch name generation
pub mod naming;

// Source trait
mod source;
pub use source::Source;

pub use docker::DockerSource;
pub use nerdctl::NerdctlSource;
pub use tar::TarSource;

/// Sanitizes a string to be safe for Git branch naming
/// Removes/replaces characters that are problematic in Git branch names
pub fn sanitize_branch_name(name: &str) -> String {
    name.chars()
        .map(|c| match c {
            // Replace whitespace with hyphens
            ' ' | '\t' | '\n' | '\r' => '-',
            // Replace problematic characters with hyphens
            '/' | '\\' | ':' | '*' | '?' | '"' | '<' | '>' | '|' => '-',
            // Replace dots with hyphens (except when used in version numbers)
            '.' => '-',
            // Keep alphanumeric, hyphens, underscores, and hash
            c if c.is_alphanumeric() || c == '-' || c == '_' || c == '#' => c,
            // Replace everything else with hyphen
            _ => '-',
        })
        .collect::<String>()
        // Remove consecutive hyphens
        .split('-')
        .filter(|s| !s.is_empty())
        .collect::<Vec<_>>()
        .join("-")
        // Ensure it doesn't start or end with hyphen
        .trim_matches('-')
        .to_string()
}

/// Extracts a short digest from an image ID
/// Takes the first 12 characters after "sha256:"
pub fn extract_short_digest(image_id: &str) -> Option<String> {
    image_id
        .strip_prefix("sha256:")
        .map(|digest| digest.chars().take(12).collect())
}

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

    #[test]
    fn test_extract_short_digest() {
        assert_eq!(
            extract_short_digest("sha256:1234567890abcdef1234567890abcdef12345678"),
            Some("1234567890ab".to_string())
        );
        assert_eq!(
            extract_short_digest("sha256:abcdef123456"),
            Some("abcdef123456".to_string())
        );
        assert_eq!(extract_short_digest("invalid-id"), None);
        assert_eq!(extract_short_digest(""), None);
    }

    #[test]
    fn test_sanitize_branch_name() {
        assert_eq!(sanitize_branch_name("hello-world"), "hello-world");
        assert_eq!(sanitize_branch_name("hello world"), "hello-world");
        assert_eq!(sanitize_branch_name("my:app/v1.0"), "my-app-v1-0");
        assert_eq!(
            sanitize_branch_name("file with spaces & symbols!"),
            "file-with-spaces-symbols"
        );
        assert_eq!(sanitize_branch_name("---test---"), "test");
        assert_eq!(sanitize_branch_name("a..b..c"), "a-b-c");
        assert_eq!(
            sanitize_branch_name("nginx_1.21-alpine"),
            "nginx_1-21-alpine"
        );
    }
}