Enum PackParseError 

#[non_exhaustive]
pub enum PackParseError {
    InvalidSchemaVersion {
        got: String,
    },
    InvalidName {
        got: String,
    },
    YamlAliasRejected,
    UnknownTopLevelKey {
        key: String,
    },
    UnknownActionKey {
        key: String,
    },
    EmptyActionEntry,
    MultipleActionKeys {
        keys: Vec<String>,
    },
    RequireCombinerArity {
        count: usize,
    },
    InvalidPredicate {
        detail: String,
    },
    ExecCmdMutex {
        shell: bool,
        cmd_present: bool,
        cmd_shell_present: bool,
    },
    RequireDepthExceeded {
        depth: usize,
        max: usize,
    },
    WithPath {
        path: String,
        source: Box<PackParseError>,
    },
    Inner(Error),
}

Errors produced by crate::pack::parse and related entry points.

Each variant is designed to be self-describing when rendered through Display (via thiserror), so eprintln!("{err}") is sufficient for a CLI diagnostic. File-path context, when available, is attached by the caller using PackParseError::with_source_path.

Marked #[non_exhaustive] so new diagnostic variants can land without breaking external match sites.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidSchemaVersion

schema_version is present but not the supported literal "1".

Fields

got: String

Raw value seen in the manifest.

InvalidName

name does not match ^[a-z][a-z0-9-]*$.

Fields

got: String

Raw value seen in the manifest.

YamlAliasRejected

The raw YAML contains an anchor (&) or alias (*) node. grex rejects these at parse time as a security policy (cycle / billion- laughs mitigation).

UnknownTopLevelKey

A top-level key was present that is neither a known manifest field nor prefixed with x- (reserved-for-extension namespace).

Fields

key: String

Offending key name.

UnknownActionKey

An action entry’s single-key map names an action not in the Tier-1 registry.

Fields

key: String

Offending key name.

EmptyActionEntry

An action entry is an empty map (- {}).

MultipleActionKeys

An action entry has more than one top-level key, e.g. - { symlink: ..., env: ... }.

Fields

keys: Vec<String>

All keys seen on the entry, in iteration order.

RequireCombinerArity

A require (or when) spec declares zero combiners when at least one is required, or more than one combiner at the same level.

Fields

count: usize

Number of combiner keys seen.

InvalidPredicate

A predicate entry is shaped wrong (not a single-key map, or the key names an unknown predicate).

Fields

detail: String

Human-readable detail.

ExecCmdMutex

An exec spec violates the cmd XOR cmd_shell invariant.

Fields

shell: bool

Value of the shell flag (default false).

cmd_present: bool

Whether cmd was present in the parsed spec.

cmd_shell_present: bool

Whether cmd_shell was present in the parsed spec.

RequireDepthExceeded

The recursive predicate tree exceeded MAX_REQUIRE_DEPTH.

Fields

depth: usize

Observed depth.

max: usize

Configured maximum.

WithPath

Wrap an inner error with the offending source-file path so CLI callers can present path: error diagnostics.

Fields

path: String

Source file path (display form — may be non-UTF-8 lossy).

source: Box<PackParseError>

Underlying error.

Inner(Error)

Underlying serde_yaml deserialization error (malformed YAML, type mismatch, etc.).

Implementations

impl PackParseError

pub fn with_source_path(self, path: impl Into<String>) -> Self

Attach source-file context to an error. Intended for the entry point that reads a file from disk; Stage A’s pure-parse API does not use it directly but surfaces it for consumers.

Trait Implementations

impl Debug for PackParseError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for PackParseError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for PackParseError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for PackParseError

fn from(source: Error) -> Self

Converts to this type from the input type.