15 releases (8 breaking)

0.9.1 Jan 6, 2024
0.9.0 Dec 20, 2023
0.8.1 Dec 8, 2020
0.8.0 Mar 7, 2020
0.1.0 Feb 20, 2018

#25 in Filesystem

Download history 208224/week @ 2024-08-18 188233/week @ 2024-08-25 175889/week @ 2024-09-01 188098/week @ 2024-09-08 180373/week @ 2024-09-15 193183/week @ 2024-09-22 204239/week @ 2024-09-29 186678/week @ 2024-10-06 202026/week @ 2024-10-13 208747/week @ 2024-10-20 260164/week @ 2024-10-27 345509/week @ 2024-11-03 381641/week @ 2024-11-10 371903/week @ 2024-11-17 270728/week @ 2024-11-24 306735/week @ 2024-12-01

1,344,791 downloads per month
Used in 1,375 crates (80 directly)

MIT license

32KB
538 lines

GlobWalk

License crates.io

Recursively find files in a directory using globs.

This crate is now in a perpetual maintnance mode and new users should probably cosider using glob.

Comparison to the glob crate

This crate was origially written years ago, when glob was a very differet crate, before it was adopted by the rust-lang org.

Nowadays glob is much better, and overall better maintained, but there are a few features that it does not seem to have (based on glob 0.3.1):

  • The glob crate does not support having {a,b} in patterns.
  • globwalk can match several glob-patterns at the same time.
  • globwalk supports excluding results with !. (negative patterns)
  • glob searches for files in the current working directory, whereas globwalk starts at a specified base-dir.

Usage

To use this crate, add globwalk as a dependency to your project's Cargo.toml:

[dependencies]
globwalk = "0.9.1"

The following piece of code recursively find all png, jpg, or gif files:

extern crate globwalk;

use std::fs;

for img in globwalk::glob("*.{png,jpg,gif}").unwrap() {
    if let Ok(img) = img {
        println!("{:?}", img.path());
    }
}

See the documentation for more details.

Dependencies

~4–12MB
~130K SLoC