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

//! Error types for image operations.

use std::path::PathBuf;

use crate::platform::{Arch, Os};

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

/// Errors that can occur during image operations.
#[derive(Debug, thiserror::Error)]
pub enum ImageError {
    /// Network or registry communication error.
    #[error("registry error: {0}")]
    Registry(#[from] oci_client::errors::OciDistributionError),

    /// No manifest found matching the requested platform.
    #[error("no manifest for platform {os}/{arch} in {reference}")]
    PlatformNotFound {
        /// The image reference.
        reference: String,
        /// Requested OS.
        os: Os,
        /// Requested architecture.
        arch: Arch,
    },

    /// OCI manifest or index parsing failed.
    #[error("manifest parse error: {0}")]
    ManifestParse(String),

    /// OCI image config parsing failed.
    #[error("config parse error: {0}")]
    ConfigParse(String),

    /// Layer download hash mismatch (possible corruption or tampering).
    #[error("digest mismatch for layer {digest}: expected {expected}, got {actual}")]
    DigestMismatch {
        /// The layer digest.
        digest: String,
        /// Expected hash.
        expected: String,
        /// Actual computed hash.
        actual: String,
    },

    /// Layer extraction failed.
    #[error("extraction failed for layer {digest}: {message}")]
    Extraction {
        /// The layer digest.
        digest: String,
        /// Error detail.
        message: String,
        /// The underlying error.
        #[source]
        source: Option<Box<dyn std::error::Error + Send + Sync>>,
    },

    /// Sidecar index generation failed.
    #[error("index generation failed for layer {0}: {1}")]
    IndexBuild(String, #[source] std::io::Error),

    /// Cache I/O error.
    #[error("cache error at {}: {source}", path.display())]
    Cache {
        /// The path that caused the error.
        path: PathBuf,
        /// The underlying I/O error.
        #[source]
        source: std::io::Error,
    },

    /// Image not found in local cache (PullPolicy::Never).
    #[error("image not cached: {reference}")]
    NotCached {
        /// The image reference.
        reference: String,
    },

    /// General I/O error.
    #[error(transparent)]
    Io(#[from] std::io::Error),
}

//--------------------------------------------------------------------------------------------------
// Type Aliases
//--------------------------------------------------------------------------------------------------

/// Result type for image operations.
pub type ImageResult<T> = Result<T, ImageError>;