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

#21 in Filesystem

Download history 374236/week @ 2024-11-16 275383/week @ 2024-11-23 316277/week @ 2024-11-30 408767/week @ 2024-12-07 350005/week @ 2024-12-14 128586/week @ 2024-12-21 189375/week @ 2024-12-28 373208/week @ 2025-01-04 384925/week @ 2025-01-11 330978/week @ 2025-01-18 357955/week @ 2025-01-25 381318/week @ 2025-02-01 484127/week @ 2025-02-08 462511/week @ 2025-02-15 558654/week @ 2025-02-22 481916/week @ 2025-03-01

2,055,556 downloads per month
Used in 1,517 crates (81 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
~125K SLoC