Dowser
Dowser
is a(nother) fast, multi-threaded, 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 and hidden directories are followed like any other, including across devices;
- 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.
Additionally, path deduping relies on Unix metadata; this library is not compatible with Windows;
Depending on your needs, those limitations could be bad, in which case something like Walkdir
would make more sense.
Installation
Add dowser
to your dependencies
in Cargo.toml
, like:
[dependencies]
dowser = "0.4.*"
Features
Feature | Description | Default |
---|---|---|
parking_lot_mutex |
Use parking_lot::Mutex instead of std::sync::Mutex . |
Y |
To use this feature, alter the Cargo.toml
bit to read:
[dependencies.dowser]
version = "0.4.*"
features = [ "parking_lot_mutex" ]
Example
All you need to do is chain Dowser::default
with one or more of the
following seed methods:
Dowser::with_path
/Dowser::with_paths
Dowser::without_path
/Dowser::without_paths
From there, you can use whatever Iterator
methods you want.
use Dowser;
use OsStrExt;
use PathBuf;
// Return all files under "/usr/share/man".
let files: Vec:: = default
.with_path
.collect;
// Return only Gzipped files using callback filter.
let files: Vec:: = default
.with_path
.filter
.collect;
License
See also: CREDITS.md
Copyright © 2022 Blobfolio, LLC <hello@blobfolio.com>
This work is free. You can redistribute it and/or modify it under the terms of the Do What The Fuck You Want To Public License, Version 2.
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
Version 2, December 2004
Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
Everyone is permitted to copy and distribute verbatim or modified
copies of this license document, and changing it is allowed as long
as the name is changed.
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. You just DO WHAT THE FUCK YOU WANT TO.