Enum PathPattern 

pub enum PathPattern {
    Literal(HazPath),
    Glob(GlobPattern),
}

A validated path pattern: either a literal HazPath or a GlobPattern.

Construction is via PathPattern::parse. The fmt::Display implementation produces the canonical text, which round-trips through PathPattern::parse.

Examples

use haz_domain::path::PathPattern;

let p = PathPattern::parse("src/lib.rs").unwrap();
assert!(matches!(p, PathPattern::Literal(_)));

let g = PathPattern::parse("src/**/*.rs").unwrap();
assert!(matches!(g, PathPattern::Glob(_)));

Variants

Literal(HazPath)

A literal path (no wildcards, no \ escapes).

Glob(GlobPattern)

A glob pattern.

Implementations

impl PathPattern

pub fn parse(s: &str) -> Result<Self, PathPatternError>

Parse s as a PathPattern.

Classification rule: if s contains any of *, ?, [, {, or \, the input is a glob; otherwise it is parsed as a literal HazPath. The escape character \ is glob syntax (PATH-015), so its mere presence is enough to classify the input as a glob.

Errors

Returns a PathPatternError when s violates path or glob rules:

• PathPatternError::EmptyInput if s is the empty string.
• PathPatternError::OnlySlash if s is "/".
• PathPatternError::EmptySegment if s contains //.
• PathPatternError::TrailingSlash if s ends with /.
• PathPatternError::LiteralPath if the literal sub-form (HazPath) rejects the input.
• PathPatternError::InvalidGlobSegment if a glob segment violates PATH-002 or PATH-011.
• PathPatternError::InvalidGlob if globset rejects the structural form (for example, an unclosed [ or nested {}).

Examples

use haz_domain::path::PathPattern;

assert!(PathPattern::parse("src/lib.rs").is_ok());
assert!(PathPattern::parse("/lib_core/src/main.rs").is_ok());
assert!(PathPattern::parse("src/**/*.rs").is_ok());
assert!(PathPattern::parse("/lib_core/src/**/*.rs").is_ok());
assert!(PathPattern::parse("with\\*literal.txt").is_ok());

assert!(PathPattern::parse("").is_err());
assert!(PathPattern::parse("a**b/foo.rs").is_err());

pub fn is_literal(&self) -> bool

true if this pattern is a literal path (no wildcards).

pub fn is_glob(&self) -> bool

true if this pattern is a glob.

pub fn anchor(&self) -> PathAnchor

The anchor (workspace-absolute or project-relative).

Trait Implementations

impl Clone for PathPattern

fn clone(&self) -> PathPattern

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathPattern

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

Formats the value using the given formatter.

impl Display for PathPattern

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

Formats the value using the given formatter.

impl Hash for PathPattern

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 PathPattern

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

impl StructuralPartialEq for PathPattern