capturing-glob 0.1.1

An extension for unix shell style globs that allow to capture groups (i.e. remember matching character ranges) while matching.
Documentation
  • Coverage
  • 100%
    33 out of 33 items documented5 out of 24 items with examples
  • Size
  • Source code size: 99.98 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 5.84 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 10s Average build duration of successful builds.
  • all releases: 10s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • Homepage
  • Documentation
  • tailhook/capturing-glob
    7 0 1
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • tailhook

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.