recv-dir 0.2.2

Recursive directory walker
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

# recv-dir

Simple recursive directory traversal.

## Description

Traverse directories recursively and conditionally using iterators.

## Example

### Visit all directories

```rust
fn main() {
    use recv_dir::RecursiveDirIterator;
    let dir = RecursiveDirIterator::from_root("test_dir").unwrap();

    for entry in dir {
        println!("{:?}", entry);
    }
}
```

### Ignore symlinks

```rust
fn main() {
    use std::path::Path;
    use recv_dir::RecursiveDirIterator;
    let dir = RecursiveDirIterator::with_closure_filter("test_dir", |dir: &Path| !dir.is_symlink()).unwrap();

    for entry in dir {
        println!("{:?}", entry);
    }
}
```

### Control depth

Visits only the files in `test_dir`:

```rust
fn main() {
    use std::path::{Path, PathBuf};
    use recv_dir::RecursiveDirIterator;
    let root = PathBuf::from("test_dir");
    let ancestors = root.ancestors().count();
    let dir = RecursiveDirIterator::with_closure_filter(root, |dir: &Path| dir.ancestors().count() - ancestors <= 1).unwrap();

    for entry in dir {
        println!("{:?}", entry);
    }
}
```

Visits the files in `test_dir` and in first-level subdirectories:

```rust
fn main() {
    use std::path::{Path, PathBuf};
    use recv_dir::RecursiveDirIterator;
    let root = PathBuf::from("test_dir");
    let ancestors = root.ancestors().count();
    let dir = RecursiveDirIterator::with_closure_filter(root, |dir: &Path| dir.ancestors().count() - ancestors <= 2).unwrap();

    for entry in dir {
        println!("{:?}", entry);
    }
}
```

You can also compose the filters:

```rust
fn main() {
    use std::num::NonZeroUsize;
    use std::path::{Path, PathBuf};
    use recv_dir::{Filter, MaxDepth, NoSymlink, RecursiveDirIterator};
    let root = PathBuf::from("test_dir");
    let dir = RecursiveDirIterator::with_filter(
        &root,
        NoSymlink.and(MaxDepth::new(&root, NonZeroUsize::new(2).unwrap())),
    ).unwrap();

    for entry in dir {
        println!("{:?}", entry);
    }
}
```

**Read the [documentation](https://docs.rs/recv-dir) for more information**