Expand description
§Dowser
Dowser is a(nother) fast, recursive file-finding library for Unix/Rust. It differs from Walkdir and kin in a number of ways:
- It is not limited to one root; any number of file and directory paths can be loaded and traversed en masse;
- Symlinks are followed by default, but can be disabled using
Dowser::without_symlinks; - Hidden paths and mount points are traversed like anything else;
- Matching file paths are canonicalized and deduped before yielding;
If those things sound nice, this library might be a good fit.
On the other hand, Dowser is optimized for file searching; the iterator crawls but does not yield directory paths, which could be bad if you need those too. Haha.
§Example
All you need to do is chain Dowser::default with one or more of the following seed methods:
From there, you can apply any Iterator methods you want.
use dowser::Dowser;
use std::path::PathBuf;
// Return all files under "/usr/share/man".
let files1: Vec::<PathBuf> = Dowser::default()
.with_path("/usr/share/man")
.collect();
// Return only Gzipped files using callback filter.
let files1: Vec::<PathBuf> = Dowser::default()
.with_path("/usr/share/man")
.filter(|p|
p.extension().is_some_and(|e| e.eq_ignore_ascii_case("gz"))
)
.collect();