Struct PathSpec 

pub struct PathSpec {
    pub layer: Layer,
    pub parent: Option<Box<PathSpec>>,
}

The recursive locator. Constructed via PathSpec::os + PathSpec::push, so a new Layer variant is an additive change and callers never build the chain by hand-nesting Boxes.

Fields

layer: Layer

parent: Option<Box<PathSpec>>

Implementations

impl PathSpec

pub fn os(path: impl Into<PathBuf>) -> Self

A base spec rooted at an OS path.

pub fn root(layer: Layer) -> Self

A raw base spec for any layer (no parent). Prefer PathSpec::os for the root; this exists for tests and re-parenting.

pub fn push(self, layer: Layer) -> Self

Extend the chain: self becomes the parent of a new node carrying layer.

pub fn depth(&self) -> usize

The number of layers in the chain (the root counts as one).

pub fn base(&self) -> &PathSpec

The root (parentless) spec of this chain.

pub fn layers(&self) -> Vec<&Layer>

The chain from root to this node, root first.

impl PathSpec

pub fn to_uri(&self) -> String

The lossless canonical URI form — round-trips byte-for-byte through PathSpec::from_uri.

pub fn from_uri(s: &str) -> VfsResult<PathSpec>

Parse a canonical URI produced by PathSpec::to_uri. Loud on any malformed input (carries the offending string).

Trait Implementations

impl Clone for PathSpec

fn clone(&self) -> PathSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathSpec

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

Formats the value using the given formatter.

impl Display for PathSpec

Lossy, human-readable form — readable, explicitly non-parseable (use PathSpec::to_uri for a form that round-trips).

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

Formats the value using the given formatter.

impl Eq for PathSpec

impl Hash for PathSpec

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PathSpec

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PathSpec