Struct globwalk::GlobWalker
[−]
[src]
pub struct GlobWalker { /* fields omitted */ }
An iterator for recursively yielding glob matches.
The order of elements yielded by this iterator is unspecified.
Methods
impl GlobWalker
[src]
pub fn new<S: AsRef<str>>(pattern: S) -> Result<Self, Error>
[src]
pub fn from_patterns<S: AsRef<str>>(pats: &[S]) -> Result<Self, Error>
[src]
Construct a new GlobWalker
from a list of patterns.
When iterated, the base directory will be recursively searched for paths
matching pats
.
pub fn from_globset(glob: GlobSet) -> Self
[src]
Construct a new GlobWalker
from a GlobSet
When iterated, the base directory will be recursively searched for paths
matching glob
.
pub fn base_dir<P: AsRef<Path>>(self, base: P) -> Self
[src]
Change the root dir of the walker.
pub fn min_depth(self, depth: usize) -> Self
[src]
Set the minimum depth of entries yielded by the iterator.
The smallest depth is 0
and always corresponds to the path given
to the new
function on this type. Its direct descendents have depth
1
, and their descendents have depth 2
, and so on.
pub fn max_depth(self, depth: usize) -> Self
[src]
Set the maximum depth of entries yield by the iterator.
The smallest depth is 0
and always corresponds to the path given
to the new
function on this type. Its direct descendents have depth
1
, and their descendents have depth 2
, and so on.
Note that this will not simply filter the entries of the iterator, but it will actually avoid descending into directories when the depth is exceeded.
pub fn follow_links(self, yes: bool) -> Self
[src]
Follow symbolic links. By default, this is disabled.
When yes
is true
, symbolic links are followed as if they were
normal directories and files. If a symbolic link is broken or is
involved in a loop, an error is yielded.
When enabled, the yielded DirEntry
values represent the target of
the link while the path corresponds to the link. See the DirEntry
type for more details.
pub fn max_open(self, n: usize) -> Self
[src]
Set the maximum number of simultaneously open file descriptors used by the iterator.
n
must be greater than or equal to 1
. If n
is 0
, then it is set
to 1
automatically. If this is not set, then it defaults to some
reasonably low number.
This setting has no impact on the results yielded by the iterator
(even when n
is 1
). Instead, this setting represents a trade off
between scarce resources (file descriptors) and memory. Namely, when
the maximum number of file descriptors is reached and a new directory
needs to be opened to continue iteration, then a previous directory
handle is closed and has its unyielded entries stored in memory. In
practice, this is a satisfying trade off because it scales with respect
to the depth of your file tree. Therefore, low values (even 1
) are
acceptable.
Note that this value does not impact the number of system calls made by an exhausted iterator.
Platform behavior
On Windows, if follow_links
is enabled, then this limit is not
respected. In particular, the maximum number of file descriptors opened
is proportional to the depth of the directory tree traversed.
pub fn contents_first(self, yes: bool) -> Self
[src]
Yield a directory's contents before the directory itself. By default, this is disabled.
When yes
is false
(as is the default), the directory is yielded
before its contents are read. This is useful when, e.g. you want to
skip processing of some directories.
When yes
is true
, the iterator yields the contents of a directory
before yielding the directory itself. This is useful when, e.g. you
want to recursively delete a directory.