#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

#699 in Filesystem

Download history 21/week @ 2023-11-24 92/week @ 2023-12-01 41/week @ 2023-12-08 40/week @ 2023-12-15 53/week @ 2023-12-22 51/week @ 2023-12-29 88/week @ 2024-01-05 92/week @ 2024-01-12 200/week @ 2024-01-19 225/week @ 2024-01-26 229/week @ 2024-02-02 95/week @ 2024-02-09 326/week @ 2024-02-16 224/week @ 2024-02-23 266/week @ 2024-03-01 88/week @ 2024-03-08

929 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