Struct fast_walker::WalkPlan

pub struct WalkPlan {
    pub check_list: Vec<PathBuf>,
    pub follow_symlinks: bool,
    pub depth_first: bool,
    pub threads: usize,
    pub reject_when: fn(_: &Path, _: usize) -> bool,
    pub ignore_when: fn(_: OsString) -> bool,
    pub finish_when: fn(_: &WalkItem) -> bool,
}

Fields

check_list: Vec<PathBuf>

Initial paths to search

follow_symlinks: bool

Follow symlinks

depth_first: bool

Depth first search or breadth first search

threads: usize

Number of threads to use

reject_when: fn(_: &Path, _: usize) -> bool

Check if a directory should be rejected

ignore_when: fn(_: OsString) -> bool

finish_when: fn(_: &WalkItem) -> bool

Stop if a item matches the condition

Implementations

impl WalkPlan

pub fn new<P: AsRef<Path>>(path: P) -> Self

Create a new plan with initial path

pub fn roots<I>(roots: I) -> Selfwhere I: IntoIterator, I::Item: AsRef<Path>,

Create a new plan with initial paths

pub fn breadth_first_search(self) -> Self

Search all subdirectories with breadth first

pub fn depth_first_search(self) -> Self

Search all subdirectories with depth first

pub fn with_threads(self, threads: usize) -> Self

Search with threads

pub fn reject_if(self, f: fn(_: &Path, _: usize) -> bool) -> Self

Reject directories if it matches the condition

Examples

• ignore hidden directories

let plan = WalkPlan::new(".").reject_if(|path, _| path.starts_with("."));

pub fn ignore_if(self, f: fn(_: OsString) -> bool) -> Self

Ignore files if it’s name matches the condition

Notice that it does not ignore directories whose name matches the condition

Examples

• ignore non-ascii files

let plan = WalkPlan::new(".").ignore_if(|path| !path.is_ascii());

pub fn finish_if(self, f: fn(_: &WalkItem) -> bool) -> Self

Trait Implementations

impl Default for WalkPlan

fn default() -> Self

Returns the “default value” for a type.

impl<'i> IntoIterator for &'i WalkPlan

type Item = WalkItem

The type of the elements being iterated over.

type IntoIter = WalkSearcher

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.