Enum PathError 

pub enum PathError {
    Empty,
    BadSegment(String),
    DescendScalar(String),
    IndexOutOfBounds {
        index: usize,
        len: usize,
        at: String,
    },
    KeyOnSequence {
        key: String,
        at: String,
    },
    IndexOnMapping {
        index: usize,
        at: String,
    },
}

Failure cases for parse_path and the apply helpers. Each variant carries a short, user-facing message so the CLI can render the same diagnostic across get/set/delete without reformatting.

Variants

Empty

Empty input — pakx manifest get "" and friends.

BadSegment(String)

Malformed bracket syntax: missing closer, non-numeric body, or the bracket opening before a key segment (e.g. [0].name is allowed and means “index into the top-level sequence”, but the top-level is always a mapping in agents.yml so this is still rejected at the apply layer rather than the parser).

DescendScalar(String)

Caller asked to descend through a scalar (description.foo). The set/delete paths can’t intuit what to overwrite, so we bail rather than silently clobbering.

IndexOutOfBounds

Index out of bounds for the sequence at this point in the path. Surfaced for get/delete; set may extend a sequence by exactly one (push-on-end) and only raises this for any further gap.

Fields

index: usize

len: usize

at: String

KeyOnSequence

A key segment was applied to a sequence (skills.0 instead of skills[0]). Surfaced explicitly so the user knows to use bracket syntax for indexing rather than guessing.

Fields

key: String

at: String

IndexOnMapping

An index segment was applied to a mapping. Mirror of KeyOnSequence for the opposite mismatch.

Fields

index: usize

at: String

Trait Implementations

impl Clone for PathError

fn clone(&self) -> PathError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PathError

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

Formats the value using the given formatter.

impl Display for PathError

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

Formats the value using the given formatter.

impl Error for PathError

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 PartialEq for PathError

fn eq(&self, other: &PathError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for PathError

impl StructuralPartialEq for PathError