shift 0.2.0

A command-line argument parser
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

# shift

Unobtrusive library for processing command line arguments.

- [Library on crates.io]()
- [Documentation]()

```rust
pub fn main() {
    // Assume this is the result of std::env::args()
    let cmdline = ["git", "--help", "commit", "--message", "hello"];
    let mut args = shift::parse(
        cmdline.into_iter().map(|s| s.to_string()).collect()
    ).unwrap();

    // Detect help flags
    if args.shift_flag("help") || args.shift_flag("h") {
        // Show help
    }

    // Detect positional arguments with known values (aka "commands")
    if args.shift_operand_with_value("commit") {
        // Do the commit
    }

    // Get the value of an option
    let Some(value) = args.shift_option("m").or_else(|| args.shift_option("message")) else {
        panic!();
    };
    assert_eq!(value, "hello");
}
```