Struct Override

impl Override

fn empty() -> Override

Returns an empty matcher that never matches any file path.

fn path(&self) -> &Path

Returns the directory of this override set.

All matches are done relative to this path.

fn is_empty(&self) -> bool

Returns true if and only if this matcher is empty.

When a matcher is empty, it will never match any file path.

fn num_ignores(&self) -> u64

Returns the total number of ignore globs.

fn num_whitelists(&self) -> u64

Returns the total number of whitelisted globs.

fn matched<'a, P: AsRef<Path>>(&'a self, path: P, is_dir: bool) -> Match<Glob<'a>>

Returns whether the given file path matched a pattern in this override matcher.

is_dir should be true if the path refers to a directory and false otherwise.

If there are no overrides, then this always returns Match::None.

If there is at least one whitelist override and is_dir is false, then this never returns Match::None, since non-matches are interpreted as ignored.

The given path is matched to the globs relative to the path given when building the override matcher. Specifically, before matching path, its prefix (as determined by a common suffix of the directory given) is stripped. If there is no common suffix/prefix overlap, then path is assumed to reside in the same directory as the root path for this set of overrides.