Struct MountPathCodec 

pub struct MountPathCodec { /* private fields */ }

Prefix-mapping codec: readable shadow namespaces backed by real subtrees.

Each entry maps a shadow prefix to a real prefix (canonical relative form, no leading/trailing /, root is ""):

use libfw_core::pathmap::{MountPathCodec, PathCodec};

let codec = MountPathCodec::new(vec![
    ("home/alice".to_string(), "data/vol-3/alice".to_string()),
]);

// real → shadow: the real subtree is aliased under the shadow prefix
assert_eq!(
    codec.encode("data/vol-3/alice/report.pdf"),
    "home/alice/report.pdf"
);
// shadow → real
assert_eq!(
    codec.decode("home/alice/report.pdf").unwrap(),
    "data/vol-3/alice/report.pdf"
);
// a shadow outside every mapping is rejected …
assert!(codec.decode("other/thing.txt").is_err());
// … while a real path outside every mapping passes through unchanged
assert_eq!(codec.encode("public/readme.md"), "public/readme.md");

Matching is on segment boundaries: home/alice matches home/alice/x but not home/alice2/x. When several entries match, the longest shadow prefix wins (most specific mapping).

Implementations

impl MountPathCodec

pub fn new(entries: Vec<(String, String)>) -> Self

Build a codec from (shadow_prefix, real_prefix) pairs.

Prefixes are normalized (leading/trailing / and empty segments stripped). A fully empty pair (root↔root) is ignored — use IdentityPathCodec for that.

Trait Implementations

impl Clone for MountPathCodec

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MountPathCodec

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

Formats the value using the given formatter.

impl Default for MountPathCodec

fn default() -> Self

Returns the “default value” for a type.

impl PathCodec for MountPathCodec

fn encode(&self, real: &str) -> String

Real path → shadow path.

fn decode(&self, shadow: &str) -> Result<String, PathCodecError>

Shadow path → real path.