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 311128/week @ 2024-10-30 354410/week @ 2024-11-06 389985/week @ 2024-11-13 366152/week @ 2024-11-20 258866/week @ 2024-11-27 345395/week @ 2024-12-04 402821/week @ 2024-12-11 253605/week @ 2024-12-18 129324/week @ 2024-12-25 269969/week @ 2025-01-01 399381/week @ 2025-01-08 344104/week @ 2025-01-15 351018/week @ 2025-01-22 357040/week @ 2025-01-29 416145/week @ 2025-02-05 382167/week @ 2025-02-12

1,570,906 downloads per month
Used in 1,474 crates (82 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–11MB
~125K SLoC