Struct NormalizedPath 

pub struct NormalizedPath(/* private fields */);

A byte-first normalized virtual resource path.

NormalizedPath::new and the input From impls apply normalize_path. The normalized-byte adoption constructors require the caller to provide bytes that are already normalized. This type is intended for repeated lookups where normalizing the query every time would allocate and burn cycles for no useful reason.

Implementations

impl NormalizedPath

pub fn new(path: impl AsRef<[u8]>) -> Self

Normalize path into an owned virtual resource path.

pub fn try_from_normalized_bytes(path: Vec<u8>) -> Result<Self, Vec<u8>>

Build from bytes that are already normalized.

Returns the original bytes on rejection so callers can log, repair, or normalize them without cloning first. Use this when avoiding a second normalization pass matters and the caller can handle rejection.

Errors

Returns the original path when it does not satisfy is_normalized_path.

pub fn from_normalized_bytes_unchecked(path: Vec<u8>) -> Self

Build from bytes that are already normalized without checking them.

path should satisfy is_normalized_path. Passing non-normalized bytes breaks the logical invariant that every NormalizedPath contains normalized virtual path spelling. That can produce cache misses and duplicate keys. It is not memory-unsafe; it is just wrong, which is quite bad enough.

pub fn as_bstr(&self) -> &BStr

Return this path as a BStr.

pub fn as_bytes(&self) -> &[u8]

Return this path as raw bytes.

pub fn to_str(&self) -> Result<&str, Utf8Error>

Return this path as UTF-8 when the normalized bytes are valid UTF-8.

This is a convenience for string-oriented callers. It is not a promise that virtual resource paths are Unicode, display-safe, C-string-safe, or host filesystem paths. Valid UTF-8 paths may still contain NUL bytes.

Errors

Returns Utf8Error if the path contains invalid UTF-8 bytes.

pub fn file_name(&self) -> Option<&BStr>

Return the final non-empty component of this virtual path.

A trailing separator is ignored for component extraction, so foo/bar/ has file name bar.

pub fn parent(&self) -> Option<&BStr>

Return the parent portion of this virtual path.

This is a byte-level virtual path operation. It does not interpret ., .., drive prefixes, roots, or host filesystem rules.

pub fn extension(&self) -> Option<&BStr>

Return the extension of the final component, without the dot.

Dotfiles such as .hidden, names ending in ., and paths ending in / have no extension.

pub fn is_empty(&self) -> bool

Return true if the normalized path is empty.

pub fn len(&self) -> usize

Return the normalized path length in bytes.

Trait Implementations

impl AsRef<[u8]> for NormalizedPath

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<BStr> for NormalizedPath

fn as_ref(&self) -> &BStr

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<[u8]> for NormalizedPath

fn borrow(&self) -> &[u8]

Immutably borrows from an owned value.

impl Borrow<BStr> for NormalizedPath

fn borrow(&self) -> &BStr

Immutably borrows from an owned value.

impl Clone for NormalizedPath

fn clone(&self) -> NormalizedPath

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NormalizedPath

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

Formats the value using the given formatter.

impl Default for NormalizedPath

fn default() -> NormalizedPath

Returns the “default value” for a type.

impl From<&[u8]> for NormalizedPath

fn from(path: &[u8]) -> Self

Converts to this type from the input type.

impl From<&BStr> for NormalizedPath

fn from(path: &BStr) -> Self

Converts to this type from the input type.

impl From<&str> for NormalizedPath

fn from(path: &str) -> Self

Converts to this type from the input type.

impl From<BString> for NormalizedPath

fn from(path: BString) -> Self

Converts to this type from the input type.

impl From<NormalizedPath> for BString

fn from(path: NormalizedPath) -> Self

Converts to this type from the input type.

impl From<NormalizedPath> for Vec<u8>

fn from(path: NormalizedPath) -> Self

Converts to this type from the input type.

impl From<String> for NormalizedPath

fn from(path: String) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for NormalizedPath

fn from(path: Vec<u8>) -> Self

Converts to this type from the input type.

impl Hash for NormalizedPath

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 Ord for NormalizedPath

fn cmp(&self, other: &NormalizedPath) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for NormalizedPath

fn eq(&self, other: &NormalizedPath) -> 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 PartialOrd for NormalizedPath

fn partial_cmp(&self, other: &NormalizedPath) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for NormalizedPath

impl StructuralPartialEq for NormalizedPath