gflags 0.3.12

Command line flags library that does not require a central list of all the flags.
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

use assert_cmd::Command;
use predicates::prelude::*;
use std::ffi::OsStr;

#[test]
fn no_flags() {
    let mut cmd = Command::cargo_bin("examples/print").unwrap();
    cmd.assert().success();
}

/// Helper function to test errors when passing invalid arguments. Runs the
/// binary, passing `args`, expecting a failure that contains `msg`.
fn test_args_failure<I, S>(args: I, msg: &str)
where
    I: IntoIterator<Item = S>,
    S: AsRef<OsStr>,
{
    let mut cmd = Command::cargo_bin("examples/print").unwrap();
    cmd.args(args);
    cmd.assert().failure().stderr(predicate::str::contains(msg));
}

/// Helper function to test successes when passing valid arguments. Runs the
/// binary, passing `args`, expecting success that contains `msg`.
fn test_args_success<I, S>(args: I, msg: &str)
where
    I: IntoIterator<Item = S>,
    S: AsRef<OsStr>,
{
    let mut cmd = Command::cargo_bin("examples/print").unwrap();
    cmd.args(args);
    cmd.assert().success().stdout(predicate::str::contains(msg));
}

// Failure cases

#[test]
fn unrecognized_short_flag() {
    test_args_failure(&["-x"], "Unrecognized flag: -x\n");
}

#[test]
fn unrecognized_long_flag_no_arg() {
    test_args_failure(&["--foo"], "Unrecognized flag: --foo\n");
}

#[test]
fn unrecognized_long_flag_with_arg() {
    test_args_failure(&["--foo", "bar"], "Unrecognized flag: --foo\n");
}

#[test]
fn unrecognized_long_flag_equals_with_arg() {
    test_args_failure(&["--foo=bar"], "Unrecognized flag: --foo\n");
}

#[test]
fn unrecognized_long_flag_equals() {
    test_args_failure(&["--foo="], "Unrecognized flag: --foo\n");
}

// Success cases

#[test]
fn short_language_flag() {
    test_args_success(&["-l", "french"], "language = french\n");
}

#[test]
fn short_language_flag_cuddled() {
    test_args_success(&["-lfrench"], "language = french\n");
}

#[test]
fn long_language_flag() {
    test_args_success(&["--language", "french"], "language = french\n");
}

#[test]
fn long_language_flag_equals() {
    test_args_success(&["--language=french"], "language = french\n");
}

#[test]
fn no_prefix_on_long_args() {
    test_args_success(&["--nobig_menu"], "big_menu = false\n");
}

#[test]
fn args_are_passed_through() {
    test_args_success(&["foo"], "args = [\"foo\"]\n");
}