Struct PathspecMatcher 

pub struct PathspecMatcher<'s> { /* private fields */ }

A resolved pathspec list bound to one repository’s matching rules, built by crate::repo::Repository::pathspec_matcher.

Holds the repository’s attributes when a spec carries :(attr:...) magic, so testing many paths reads them once. Attr requirements see [attr] macro expansion and match attribute patterns case-insensitively when core.ignorecase is set, as Git does. Paths are treated as regular files: a spec ending in / does not match a path equal to its directory, and builtin_objectmode reads as 100644. Use matches_pathspec_list_for_object when the entry mode matters.

Implementations

impl<'s> PathspecMatcher<'s>

pub fn matches(&self, path: &str) -> bool

Whether path is selected: it matches at least one positive spec (any path when there are none or the list is empty) and no :(exclude) spec.

pub fn matches_entry(&self, path: &str, mode: u32) -> bool

Like Self::matches, but uses Git tree/index entry mode for trailing-slash and submodule pathspec semantics.

Required for path-limited history walks and staging when specs include :(attr:...) magic.

pub fn matches_change(&self, path: &str, old_path: Option<&str>) -> bool

Whether a changed file is selected, checking its current path and, for a rename or copy, its old_path too (Git limits diffs on either side of a rename).

pub fn is_empty(&self) -> bool

Whether the list is empty (every path is selected).

Trait Implementations

impl<'s> Clone for PathspecMatcher<'s>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'s> Debug for PathspecMatcher<'s>

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

Formats the value using the given formatter.