Struct PathspecElement 

pub struct PathspecElement { /* private fields */ }

A parsed pathspec element: a single pattern plus its magic flags.

Mirrors git’s struct pathspec_item for the subset sley needs today. Construct with PathspecElement::parse; query with [PathspecElement::matches].

Implementations

impl PathspecElement

pub fn parse( arg: &[u8], defaults: PathspecMatchMagic, ) -> Result<Self, PathspecParseError>

Parse one pathspec argument, honoring git’s magic prefixes.

Recognizes both the long form :(magic1,magic2,...)pattern and the shorthand sigils :!/:^ (exclude), :/ (top). Defaults (literal/glob/icase from the global --*-pathspecs flags) are supplied via defaults and overridden per-element by any explicit magic. Unknown long-form magic words are an error, matching git.

pub fn is_exclude(&self) -> bool

Whether this element is an :(exclude) element.

pub fn is_top(&self) -> bool

Whether this element carries :(top) / :/ magic.

pub fn attrs(&self) -> &[Vec<u8>]

The attribute requirements carried by :(attr:...), if any.

pub fn attr_requirements(&self) -> &[PathspecAttrRequirement]

pub fn is_icase(&self) -> bool

Whether this element carries case-insensitive matching.

pub fn is_glob(&self) -> bool

Whether this element carries glob magic.

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

The bare match pattern (magic prefix stripped).

pub fn magic(&self) -> PathspecMatchMagic

The PathspecMatchMagic this element matches under.

pub fn matches_path(&self, name: &[u8]) -> bool

Whether name (a repo-relative path, no leading slash) is selected by this single element, ignoring its exclude polarity. Use Pathspec::matches for the combined include/exclude semantics.

pub fn with_pattern(self, pattern: Vec<u8>) -> Self

Trait Implementations

impl Clone for PathspecElement

fn clone(&self) -> PathspecElement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathspecElement

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

Formats the value using the given formatter.

impl Eq for PathspecElement

impl PartialEq for PathspecElement

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