Struct Pathspec 

pub struct Pathspec { /* private fields */ }

A full pathspec: an ordered list of PathspecElements combining positive (include) and :(exclude) patterns.

Semantics (git match_pathspec): a path matches when at least one non-exclude element selects it AND no exclude element selects it. An all-exclude (or empty) pathspec matches everything not excluded — matching git, where git log -- ':(exclude)foo' keeps every path but foo.

Implementations

impl Pathspec

pub fn parse<I, S>( args: I, defaults: PathspecMatchMagic, ) -> Result<Self, PathspecParseError>

where I: IntoIterator<Item = S>, S: AsRef<[u8]>,

Parse a list of raw pathspec arguments under the given global magic defaults (from --{glob,noglob,literal,icase}-pathspecs).

pub fn is_empty(&self) -> bool

An empty pathspec matches every path.

pub fn elements(&self) -> &[PathspecElement]

The parsed elements, in order.

pub fn matches(&self, path: &[u8]) -> bool

Whether path (repo-relative, no leading slash) is selected.

An empty pathspec, or one with only excludes, matches any path the excludes don’t subtract — exactly git’s match_pathspec behavior.

Trait Implementations

impl Clone for Pathspec

fn clone(&self) -> Pathspec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Pathspec

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

Formats the value using the given formatter.

impl Default for Pathspec

fn default() -> Pathspec

Returns the “default value” for a type.

impl Eq for Pathspec

impl PartialEq for Pathspec

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