microsandbox-image 0.3.13

OCI image pulling, layer extraction, and caching for microsandbox.
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

//! Target platform for OCI image resolution.

//--------------------------------------------------------------------------------------------------
// Types
//--------------------------------------------------------------------------------------------------

/// Re-export of [`oci_spec::image::Os`].
pub type Os = oci_spec::image::Os;

/// Re-export of [`oci_spec::image::Arch`].
pub type Arch = oci_spec::image::Arch;

/// Target platform for OCI image resolution.
///
/// Used to select the correct manifest from a multi-platform OCI index.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Platform {
    /// Operating system (always `linux` for microsandbox).
    pub os: Os,
    /// CPU architecture (e.g., `amd64`, `arm64`).
    pub arch: Arch,
    /// Optional architecture variant (e.g., `v7` for armv7).
    pub variant: Option<String>,
}

//--------------------------------------------------------------------------------------------------
// Methods
//--------------------------------------------------------------------------------------------------

impl Platform {
    /// Create a new platform.
    pub fn new(os: impl Into<Os>, arch: impl Into<Arch>) -> Self {
        Self {
            os: os.into(),
            arch: arch.into(),
            variant: None,
        }
    }

    /// Create a new platform with variant.
    pub fn with_variant(
        os: impl Into<Os>,
        arch: impl Into<Arch>,
        variant: impl Into<String>,
    ) -> Self {
        Self {
            os: os.into(),
            arch: arch.into(),
            variant: Some(variant.into()),
        }
    }

    /// Returns the platform for the current host, with OS forced to `linux`.
    ///
    /// Architecture detected via `std::env::consts::ARCH`:
    /// `x86_64` -> `amd64`, `aarch64` -> `arm64`.
    pub fn host_linux() -> Self {
        let arch = match std::env::consts::ARCH {
            "x86_64" => "amd64",
            "aarch64" => "arm64",
            other => other,
        };
        Self::new("linux", arch)
    }
}

//--------------------------------------------------------------------------------------------------
// Trait Implementations
//--------------------------------------------------------------------------------------------------

impl Default for Platform {
    fn default() -> Self {
        Self::host_linux()
    }
}

//--------------------------------------------------------------------------------------------------
// Tests
//--------------------------------------------------------------------------------------------------

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

    #[test]
    fn test_host_linux() {
        let p = Platform::host_linux();
        assert_eq!(p.os, Os::Linux);
        assert!(p.arch == Arch::Amd64 || p.arch == Arch::ARM64);
    }

    #[test]
    fn test_default_is_host_linux() {
        let p = Platform::default();
        assert_eq!(p.os, Os::Linux);
    }
}