Struct Path 

pub struct Path { /* private fields */ }

A path through a type structure, recorded as a series of steps.

This is a lightweight representation that only stores indices. The actual field names and type information can be reconstructed by replaying these steps against the original Shape.

Implementations

impl Path

pub const fn new() -> Self

Create a new empty path.

pub fn with_capacity(capacity: usize) -> Self

Create a path with pre-allocated capacity.

pub fn push(&mut self, step: PathStep)

Push a step onto the path.

pub fn pop(&mut self) -> Option<PathStep>

Pop the last step from the path.

pub fn steps(&self) -> &[PathStep]

Get the steps in this path.

pub fn len(&self) -> usize

Get the length of this path.

pub fn is_empty(&self) -> bool

Check if this path is empty.

pub fn format_with_shape(&self, shape: &'static Shape) -> String

Format this path as a human-readable string by walking the given shape.

Returns a path like outer.inner.items[3].name.

pub fn resolve_leaf_field( &self, shape: &'static Shape, ) -> Option<&'static Field>

Resolve the field at the end of this path, if the path ends at a struct field.

This navigates through the given shape following each step in the path, and returns the Field if the final step is a PathStep::Field.

This is useful for accessing field metadata like attributes when handling errors that occur at a specific field location.

Returns

• Some(&Field) if the path ends at a struct field
• None if the path is empty, doesn’t end at a field, or navigation fails

Trait Implementations

impl Clone for Path

fn clone(&self) -> Path

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Path

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

Formats the value using the given formatter.

impl Default for Path

fn default() -> Path

Returns the “default value” for a type.