sherpack-core 0.4.0

Core types and utilities for Sherpack - the Kubernetes package manager
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

//! Core error types

use thiserror::Error;

/// Information about a single validation error
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub struct ValidationErrorInfo {
    /// JSON path where the error occurred (e.g., "/image/tag")
    pub path: String,
    /// Human-readable error message
    pub message: String,
    /// Expected value/type (if applicable)
    pub expected: Option<String>,
    /// Actual value/type (if applicable)
    pub actual: Option<String>,
}

#[derive(Error, Debug)]
pub enum CoreError {
    #[error("Pack not found: {path}")]
    PackNotFound { path: String },

    #[error("Invalid Pack.yaml: {message}")]
    InvalidPack { message: String },

    #[error("Failed to parse Pack.yaml: {0}")]
    YamlParse(#[from] serde_yaml::Error),

    #[error("Failed to parse JSON: {0}")]
    JsonParse(#[from] serde_json::Error),

    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    #[error("Invalid version: {0}")]
    InvalidVersion(#[from] semver::Error),

    #[error("Values merge error: {message}")]
    ValuesMerge { message: String },

    #[error("Missing required field: {field}")]
    MissingField { field: String },

    #[error("Invalid schema: {message}")]
    InvalidSchema { message: String },

    #[error("Schema validation failed")]
    SchemaValidation { errors: Vec<ValidationErrorInfo> },

    #[error("Schema file not found: {path}")]
    SchemaNotFound { path: String },

    #[error("Invalid manifest: {message}")]
    InvalidManifest { message: String },

    #[error("Archive error: {message}")]
    Archive { message: String },

    #[error("File access error for '{path}': {message}")]
    FileAccess { path: String, message: String },

    #[error("Glob pattern error: {message}")]
    GlobPattern { message: String },
}

impl CoreError {
    /// Format validation errors for display
    #[must_use]
    pub fn format_validation_errors(errors: &[ValidationErrorInfo]) -> String {
        errors
            .iter()
            .map(|e| format!("  - {}: {}", e.path, e.message))
            .collect::<Vec<_>>()
            .join("\n")
    }
}

pub type Result<T> = std::result::Result<T, CoreError>;