Struct PathMapper 

pub struct PathMapper { /* private fields */ }

Pure string-based path mapper. No filesystem I/O.

Implementations

impl PathMapper

pub fn from_config( config: &PathsConfig, full_config: Option<&Config>, ) -> PathResult<Self>

Create a PathMapper from configuration.

Resolves $ENV and ${config.ref} in mapping values. The root path is resolved relative to the current working directory.

pub fn new() -> PathResult<Self>

Create a PathMapper with default configuration.

pub fn normalize(&self, path: &str) -> PathResult<String>

Normalize a path to canonical internal form.

This function:

• Resolves prefixes (home:, project:, c:)
• Resolves . and ..
• Converts to forward slashes
• Validates sandbox (no escape above root)

Returns: Canonical path string (still virtual/internal)

pub fn normalize_all(&self, paths: Vec<String>) -> PathResult<Vec<String>>

Normalize multiple paths.

pub fn to_display(&self, canonical: &str) -> String

Convert canonical path to display format based on style.

pub fn to_filesystem_path(&self, canonical: &str) -> PathBuf

Convert canonical path to actual filesystem path. This is where virtual paths become real OS paths.

pub fn from_filesystem_path(&self, fs_path: &Path) -> PathResult<String>

Convert filesystem path back to canonical form.

pub fn root(&self) -> &str

Get the resolved root.

pub fn style(&self) -> PathStyle

Get the path style.

pub fn has_prefix(&self, prefix: &str) -> bool

Check if a prefix is defined in mappings.

pub fn prefixes(&self) -> Vec<&str>

Get all defined prefixes.

Trait Implementations

impl Clone for PathMapper

fn clone(&self) -> PathMapper

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathMapper

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

Formats the value using the given formatter.

impl Default for PathMapper

fn default() -> Self

Returns the “default value” for a type.