12 stable releases

2.2.1 Jan 27, 2024
2.2.1-rc Dec 18, 2023
2.2.0 Sep 24, 2023
2.1.0 Aug 14, 2022
0.1.0 Nov 17, 2017

#7 in Windows APIs

Download history 29696/week @ 2024-07-27 30111/week @ 2024-08-03 30517/week @ 2024-08-10 34827/week @ 2024-08-17 30855/week @ 2024-08-24 31818/week @ 2024-08-31 34151/week @ 2024-09-07 33336/week @ 2024-09-14 34146/week @ 2024-09-21 27054/week @ 2024-09-28 34550/week @ 2024-10-05 33322/week @ 2024-10-12 32367/week @ 2024-10-19 28630/week @ 2024-10-26 29487/week @ 2024-11-02 30045/week @ 2024-11-09

125,992 downloads per month
Used in 182 crates (41 directly)

Apache-2.0 OR MIT

27KB
484 lines

Wild::args for Rust

Allows Rust applications support wildcard arguments (*foo*, file.???, *.log.[0-9], etc.) on command-line, uniformly on all platforms, including Windows.

Unix shells automatically interpret wildcard arguments and pass them expanded (already converted to file names) to applications, but Windows' cmd.exe doesn't do that. For consistent cross-platform behavior, this crate emulates Unix-like expansion on Windows. You only need to use wild::args() instead of std::env::args().

It is more robust than using glob() on values from std::env::args(), because this crate is aware of argument quoting, and special characteres in quotes ("*") are intentionally not expanded.

The glob syntax on Windows is limited to *, ?, and [a-z]/[!a-z] ranges, as supported by the glob crate. Parsing of quoted arguments precisely follows Windows' native syntax (CommandLineToArgvW, specifically).

Usage

wild::args() is a drop-in replacement for std::env::args().

[dependencies]
wild = "2"
fn main() {
    let args = wild::args();
    println!("The args are: {:?}", args.collect::<Vec<_>>());
}

Usage with Clap

let matches = clap::App::new("your_app")
    .arg()
    .arg()
    .arg()
    // .get_matches(); change to:
    .get_matches_from(wild::args());

Dependencies

~12KB