Enum PathError 

pub enum PathError {
    TooFewSegments {
        path: String,
        found: usize,
    },
    EmptySegment {
        path: String,
        index: usize,
    },
    BadSegment {
        path: String,
        segment: String,
        index: usize,
    },
    ReservedPrefix {
        path: String,
        prefix: String,
    },
}

Failure modes when parsing a SecretPath.

Each variant maps 1:1 onto a rule from ADR-020 §2 so callers can surface a precise message to the user (or to doctor).

Variants

TooFewSegments

Fewer than three /-separated segments.

Two-segment paths like gitlab/token are intentionally not allowed: they have no scope and silently encourage cross-context reuse of credentials that should be distinct.

Fields

path: String

The path the caller offered.

found: usize

Number of segments found.

EmptySegment

A segment was empty (e.g. team//gitlab/token).

Fields

path: String

The path the caller offered.

index: usize

Zero-based segment index that was empty.

BadSegment

A segment did not match [a-z][a-z0-9-]*.

Fields

path: String

The path the caller offered.

segment: String

The offending segment.

index: usize

Zero-based index of the bad segment.

ReservedPrefix

The first segment is one of the reserved framework prefixes (__* or _test) and the path was offered through a user-facing entry point.

Fields

path: String

The path the caller offered.

prefix: String

The reserved scope segment.

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