#pattern-matching #group #unix-shell #capture #file-path #glob-pattern #range

capturing-glob

An extension for unix shell style globs that allow to capture groups (i.e. remember matching character ranges) while matching.

2 releases

Uses old Rust 2015

0.1.1 Feb 9, 2018
0.1.0 Dec 15, 2017

#748 in Filesystem

Download history 26/week @ 2023-12-11 42/week @ 2023-12-18 50/week @ 2023-12-25 72/week @ 2024-01-01 102/week @ 2024-01-08 104/week @ 2024-01-15 181/week @ 2024-01-22 258/week @ 2024-01-29 176/week @ 2024-02-05 108/week @ 2024-02-12 398/week @ 2024-02-19 175/week @ 2024-02-26 248/week @ 2024-03-04 302/week @ 2024-03-11 261/week @ 2024-03-18 182/week @ 2024-03-25

999 downloads per month
Used in 2 crates

MIT/Apache

74KB
1.5K SLoC

Capturing Glob

Documentation | Github | Crate

Support for matching file paths against Unix shell style patterns, and capture groups when matching (similarly to captures in regexes).

Usage

And add this to your crate root:

extern crate capturing_glob;

Examples

Print all jpg files in /media/ and all of its subdirectories.

use capguring_glob::glob;

for entry in glob("/media/**/(*).jpg").expect("Failed to read glob pattern") {
    match entry {
        Ok(entry) => println!("Path {:?}, name {:?}",
            entry.path().display(), entry.group(1).unwrap()),
        Err(e) => println!("{:?}", e),
    }
}

Note: in the case above, regular filename matching might be used (i.e. file_stem()), but the library allows you to skip unwraps here, but more importantly you can use user-defined globs like these:

  • (*)/package.json
  • tests/(*).spec.js
  • docs/(section-*).rst
  • /usr/share/zoneinfo/(*/*)

License

Licensed under either of

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

No runtime deps