2018-07-02 17:41:01 +00:00
|
|
|
// Copyright 2018 Guillaume Pinot (@TeXitoi) <texitoi@texitoi.eu>,
|
|
|
|
// Kevin Knapp (@kbknapp) <kbknapp@gmail.com>, and
|
2022-01-04 20:10:35 +00:00
|
|
|
// Ana Hobden (@hoverbear) <operator@hoverbear.org>
|
2017-06-30 01:02:59 +00:00
|
|
|
//
|
2018-02-25 10:22:24 +00:00
|
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
|
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
|
|
// option. This file may not be copied, modified, or distributed
|
|
|
|
// except according to those terms.
|
2018-07-02 17:41:01 +00:00
|
|
|
//
|
|
|
|
// This work was derived from Structopt (https://github.com/TeXitoi/structopt)
|
|
|
|
// commit#ea76fa1b1b273e65e3b0b1046643715b49bec51f which is licensed under the
|
|
|
|
// MIT/Apache 2.0 license.
|
2017-06-30 01:02:59 +00:00
|
|
|
|
2021-10-11 19:48:13 +00:00
|
|
|
use clap::{Parser, Subcommand};
|
2017-06-30 01:02:59 +00:00
|
|
|
|
2021-07-13 17:50:55 +00:00
|
|
|
#[derive(Parser, PartialEq, Debug)]
|
2017-06-30 01:02:59 +00:00
|
|
|
struct Opt {
|
2022-06-01 15:31:23 +00:00
|
|
|
#[clap(short, long, action)]
|
2017-06-30 01:02:59 +00:00
|
|
|
force: bool,
|
2022-06-01 15:31:23 +00:00
|
|
|
#[clap(short, long, action = clap::ArgAction::Count)]
|
2017-06-30 01:02:59 +00:00
|
|
|
verbose: u64,
|
2018-07-02 19:06:46 +00:00
|
|
|
#[clap(subcommand)]
|
2018-05-21 14:54:22 +00:00
|
|
|
cmd: Sub,
|
2017-06-30 01:02:59 +00:00
|
|
|
}
|
|
|
|
|
2021-10-11 19:48:13 +00:00
|
|
|
#[derive(Subcommand, PartialEq, Debug)]
|
2017-06-30 01:02:59 +00:00
|
|
|
enum Sub {
|
|
|
|
Fetch {},
|
2018-05-21 14:54:22 +00:00
|
|
|
Add {},
|
2017-06-30 01:02:59 +00:00
|
|
|
}
|
|
|
|
|
2021-07-13 17:50:55 +00:00
|
|
|
#[derive(Parser, PartialEq, Debug)]
|
2017-06-30 01:02:59 +00:00
|
|
|
struct Opt2 {
|
2022-06-01 15:31:23 +00:00
|
|
|
#[clap(short, long, action)]
|
2017-06-30 01:02:59 +00:00
|
|
|
force: bool,
|
2022-06-01 15:31:23 +00:00
|
|
|
#[clap(short, long, action = clap::ArgAction::Count)]
|
2017-06-30 01:02:59 +00:00
|
|
|
verbose: u64,
|
2018-07-02 19:06:46 +00:00
|
|
|
#[clap(subcommand)]
|
2018-05-21 14:54:22 +00:00
|
|
|
cmd: Option<Sub>,
|
2017-06-30 01:02:59 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn test_no_cmd() {
|
2018-07-13 00:32:28 +00:00
|
|
|
let result = Opt::try_parse_from(&["test"]);
|
2017-06-30 01:02:59 +00:00
|
|
|
assert!(result.is_err());
|
|
|
|
|
2018-05-21 14:54:22 +00:00
|
|
|
assert_eq!(
|
|
|
|
Opt2 {
|
|
|
|
force: false,
|
|
|
|
verbose: 0,
|
|
|
|
cmd: None
|
|
|
|
},
|
test(derive): Provide better error info
`Parser::parse_from` will call `exit` on failure and we don't just lose
backtrace information but we don't even know which of the tests running
in parallel panicked. I ran into this when experimenting with
`clap_derive` and I couldn't tell what actually failed.
So let's switch to `Parse::try_parse_from`.
Errors went from:
```
test option_option ... ok
error: Found argument 'bar' which wasn't expected, or isn't valid in this context
USAGE:
clap_derive [OPTIONS]
For more information try --help
error: test failed, to rerun pass '--test arg_enum'
```
To:
```
test option_option ... ok
test variant_with_defined_casing ... ok
test skip_variant ... ok
test default_value ... ok
test vector ... FAILED
test option_vector ... ok
failures:
---- vector stdout ----
thread 'vector' panicked at 'called `Result::unwrap()` on an `Err` value: Error { message: Formatted(Colorizer { use_stderr: true, color_when: Auto
, pieces: [("error:", Some(Red)), (" ", None), ("Found argument '", None), ("bar", Some(Yellow)), ("' which wasn't expected, or isn't valid in this
context", None), ("\n\n", None), ("USAGE:\n clap_derive [OPTIONS]", None), ("\n\nFor more information try ", None), ("--help", Some(Green)), ("
\n", None)] }), kind: UnknownArgument, info: ["bar"], source: None, backtrace: Backtrace }', clap_derive/tests/arg_enum.rs:388:56
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
failures:
vector
test result: FAILED. 15 passed; 1 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
error: test failed, to rerun pass '--test arg_enum'
```
2021-10-30 14:55:50 +00:00
|
|
|
Opt2::try_parse_from(&["test"]).unwrap()
|
2018-05-21 14:54:22 +00:00
|
|
|
);
|
2017-06-30 01:02:59 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn test_fetch() {
|
2018-05-21 14:54:22 +00:00
|
|
|
assert_eq!(
|
|
|
|
Opt {
|
|
|
|
force: false,
|
|
|
|
verbose: 3,
|
|
|
|
cmd: Sub::Fetch {}
|
|
|
|
},
|
test(derive): Provide better error info
`Parser::parse_from` will call `exit` on failure and we don't just lose
backtrace information but we don't even know which of the tests running
in parallel panicked. I ran into this when experimenting with
`clap_derive` and I couldn't tell what actually failed.
So let's switch to `Parse::try_parse_from`.
Errors went from:
```
test option_option ... ok
error: Found argument 'bar' which wasn't expected, or isn't valid in this context
USAGE:
clap_derive [OPTIONS]
For more information try --help
error: test failed, to rerun pass '--test arg_enum'
```
To:
```
test option_option ... ok
test variant_with_defined_casing ... ok
test skip_variant ... ok
test default_value ... ok
test vector ... FAILED
test option_vector ... ok
failures:
---- vector stdout ----
thread 'vector' panicked at 'called `Result::unwrap()` on an `Err` value: Error { message: Formatted(Colorizer { use_stderr: true, color_when: Auto
, pieces: [("error:", Some(Red)), (" ", None), ("Found argument '", None), ("bar", Some(Yellow)), ("' which wasn't expected, or isn't valid in this
context", None), ("\n\n", None), ("USAGE:\n clap_derive [OPTIONS]", None), ("\n\nFor more information try ", None), ("--help", Some(Green)), ("
\n", None)] }), kind: UnknownArgument, info: ["bar"], source: None, backtrace: Backtrace }', clap_derive/tests/arg_enum.rs:388:56
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
failures:
vector
test result: FAILED. 15 passed; 1 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
error: test failed, to rerun pass '--test arg_enum'
```
2021-10-30 14:55:50 +00:00
|
|
|
Opt::try_parse_from(&["test", "-vvv", "fetch"]).unwrap()
|
2018-05-21 14:54:22 +00:00
|
|
|
);
|
|
|
|
assert_eq!(
|
|
|
|
Opt {
|
|
|
|
force: true,
|
|
|
|
verbose: 0,
|
|
|
|
cmd: Sub::Fetch {}
|
|
|
|
},
|
test(derive): Provide better error info
`Parser::parse_from` will call `exit` on failure and we don't just lose
backtrace information but we don't even know which of the tests running
in parallel panicked. I ran into this when experimenting with
`clap_derive` and I couldn't tell what actually failed.
So let's switch to `Parse::try_parse_from`.
Errors went from:
```
test option_option ... ok
error: Found argument 'bar' which wasn't expected, or isn't valid in this context
USAGE:
clap_derive [OPTIONS]
For more information try --help
error: test failed, to rerun pass '--test arg_enum'
```
To:
```
test option_option ... ok
test variant_with_defined_casing ... ok
test skip_variant ... ok
test default_value ... ok
test vector ... FAILED
test option_vector ... ok
failures:
---- vector stdout ----
thread 'vector' panicked at 'called `Result::unwrap()` on an `Err` value: Error { message: Formatted(Colorizer { use_stderr: true, color_when: Auto
, pieces: [("error:", Some(Red)), (" ", None), ("Found argument '", None), ("bar", Some(Yellow)), ("' which wasn't expected, or isn't valid in this
context", None), ("\n\n", None), ("USAGE:\n clap_derive [OPTIONS]", None), ("\n\nFor more information try ", None), ("--help", Some(Green)), ("
\n", None)] }), kind: UnknownArgument, info: ["bar"], source: None, backtrace: Backtrace }', clap_derive/tests/arg_enum.rs:388:56
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
failures:
vector
test result: FAILED. 15 passed; 1 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
error: test failed, to rerun pass '--test arg_enum'
```
2021-10-30 14:55:50 +00:00
|
|
|
Opt::try_parse_from(&["test", "--force", "fetch"]).unwrap()
|
2018-05-21 14:54:22 +00:00
|
|
|
);
|
2017-06-30 01:02:59 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn test_add() {
|
2018-05-21 14:54:22 +00:00
|
|
|
assert_eq!(
|
|
|
|
Opt {
|
|
|
|
force: false,
|
|
|
|
verbose: 0,
|
|
|
|
cmd: Sub::Add {}
|
|
|
|
},
|
test(derive): Provide better error info
`Parser::parse_from` will call `exit` on failure and we don't just lose
backtrace information but we don't even know which of the tests running
in parallel panicked. I ran into this when experimenting with
`clap_derive` and I couldn't tell what actually failed.
So let's switch to `Parse::try_parse_from`.
Errors went from:
```
test option_option ... ok
error: Found argument 'bar' which wasn't expected, or isn't valid in this context
USAGE:
clap_derive [OPTIONS]
For more information try --help
error: test failed, to rerun pass '--test arg_enum'
```
To:
```
test option_option ... ok
test variant_with_defined_casing ... ok
test skip_variant ... ok
test default_value ... ok
test vector ... FAILED
test option_vector ... ok
failures:
---- vector stdout ----
thread 'vector' panicked at 'called `Result::unwrap()` on an `Err` value: Error { message: Formatted(Colorizer { use_stderr: true, color_when: Auto
, pieces: [("error:", Some(Red)), (" ", None), ("Found argument '", None), ("bar", Some(Yellow)), ("' which wasn't expected, or isn't valid in this
context", None), ("\n\n", None), ("USAGE:\n clap_derive [OPTIONS]", None), ("\n\nFor more information try ", None), ("--help", Some(Green)), ("
\n", None)] }), kind: UnknownArgument, info: ["bar"], source: None, backtrace: Backtrace }', clap_derive/tests/arg_enum.rs:388:56
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
failures:
vector
test result: FAILED. 15 passed; 1 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
error: test failed, to rerun pass '--test arg_enum'
```
2021-10-30 14:55:50 +00:00
|
|
|
Opt::try_parse_from(&["test", "add"]).unwrap()
|
2018-05-21 14:54:22 +00:00
|
|
|
);
|
|
|
|
assert_eq!(
|
|
|
|
Opt {
|
|
|
|
force: false,
|
|
|
|
verbose: 2,
|
|
|
|
cmd: Sub::Add {}
|
|
|
|
},
|
test(derive): Provide better error info
`Parser::parse_from` will call `exit` on failure and we don't just lose
backtrace information but we don't even know which of the tests running
in parallel panicked. I ran into this when experimenting with
`clap_derive` and I couldn't tell what actually failed.
So let's switch to `Parse::try_parse_from`.
Errors went from:
```
test option_option ... ok
error: Found argument 'bar' which wasn't expected, or isn't valid in this context
USAGE:
clap_derive [OPTIONS]
For more information try --help
error: test failed, to rerun pass '--test arg_enum'
```
To:
```
test option_option ... ok
test variant_with_defined_casing ... ok
test skip_variant ... ok
test default_value ... ok
test vector ... FAILED
test option_vector ... ok
failures:
---- vector stdout ----
thread 'vector' panicked at 'called `Result::unwrap()` on an `Err` value: Error { message: Formatted(Colorizer { use_stderr: true, color_when: Auto
, pieces: [("error:", Some(Red)), (" ", None), ("Found argument '", None), ("bar", Some(Yellow)), ("' which wasn't expected, or isn't valid in this
context", None), ("\n\n", None), ("USAGE:\n clap_derive [OPTIONS]", None), ("\n\nFor more information try ", None), ("--help", Some(Green)), ("
\n", None)] }), kind: UnknownArgument, info: ["bar"], source: None, backtrace: Backtrace }', clap_derive/tests/arg_enum.rs:388:56
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
failures:
vector
test result: FAILED. 15 passed; 1 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
error: test failed, to rerun pass '--test arg_enum'
```
2021-10-30 14:55:50 +00:00
|
|
|
Opt::try_parse_from(&["test", "-vv", "add"]).unwrap()
|
2018-05-21 14:54:22 +00:00
|
|
|
);
|
2017-06-30 01:02:59 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn test_badinput() {
|
2018-07-13 00:32:28 +00:00
|
|
|
let result = Opt::try_parse_from(&["test", "badcmd"]);
|
2017-06-30 01:02:59 +00:00
|
|
|
assert!(result.is_err());
|
2018-07-13 00:32:28 +00:00
|
|
|
let result = Opt::try_parse_from(&["test", "add", "--verbose"]);
|
2017-06-30 01:02:59 +00:00
|
|
|
assert!(result.is_err());
|
2018-07-13 00:32:28 +00:00
|
|
|
let result = Opt::try_parse_from(&["test", "--badopt", "add"]);
|
2017-06-30 01:02:59 +00:00
|
|
|
assert!(result.is_err());
|
2018-07-13 00:32:28 +00:00
|
|
|
let result = Opt::try_parse_from(&["test", "add", "--badopt"]);
|
2017-06-30 01:02:59 +00:00
|
|
|
assert!(result.is_err());
|
|
|
|
}
|
|
|
|
|
2021-07-13 17:50:55 +00:00
|
|
|
#[derive(Parser, PartialEq, Debug)]
|
2017-06-30 01:02:59 +00:00
|
|
|
struct Opt3 {
|
2022-06-01 15:31:23 +00:00
|
|
|
#[clap(short, long, action)]
|
2017-06-30 01:02:59 +00:00
|
|
|
all: bool,
|
2018-07-02 19:06:46 +00:00
|
|
|
#[clap(subcommand)]
|
2018-05-21 14:54:22 +00:00
|
|
|
cmd: Sub2,
|
2017-06-30 01:02:59 +00:00
|
|
|
}
|
|
|
|
|
2021-10-11 19:48:13 +00:00
|
|
|
#[derive(Subcommand, PartialEq, Debug)]
|
2017-06-30 01:02:59 +00:00
|
|
|
enum Sub2 {
|
|
|
|
Foo {
|
2022-05-23 20:42:34 +00:00
|
|
|
#[clap(value_parser)]
|
2017-06-30 01:02:59 +00:00
|
|
|
file: String,
|
2018-07-02 19:06:46 +00:00
|
|
|
#[clap(subcommand)]
|
2018-05-21 14:54:22 +00:00
|
|
|
cmd: Sub3,
|
2017-06-30 01:02:59 +00:00
|
|
|
},
|
2018-05-21 14:54:22 +00:00
|
|
|
Bar {},
|
2017-06-30 01:02:59 +00:00
|
|
|
}
|
|
|
|
|
2021-10-11 19:48:13 +00:00
|
|
|
#[derive(Subcommand, PartialEq, Debug)]
|
2017-06-30 01:02:59 +00:00
|
|
|
enum Sub3 {
|
|
|
|
Baz {},
|
2018-05-21 14:54:22 +00:00
|
|
|
Quux {},
|
2017-06-30 01:02:59 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn test_subsubcommand() {
|
|
|
|
assert_eq!(
|
|
|
|
Opt3 {
|
|
|
|
all: true,
|
2018-05-21 14:54:22 +00:00
|
|
|
cmd: Sub2::Foo {
|
|
|
|
file: "lib.rs".to_string(),
|
|
|
|
cmd: Sub3::Quux {}
|
|
|
|
}
|
2017-06-30 01:02:59 +00:00
|
|
|
},
|
test(derive): Provide better error info
`Parser::parse_from` will call `exit` on failure and we don't just lose
backtrace information but we don't even know which of the tests running
in parallel panicked. I ran into this when experimenting with
`clap_derive` and I couldn't tell what actually failed.
So let's switch to `Parse::try_parse_from`.
Errors went from:
```
test option_option ... ok
error: Found argument 'bar' which wasn't expected, or isn't valid in this context
USAGE:
clap_derive [OPTIONS]
For more information try --help
error: test failed, to rerun pass '--test arg_enum'
```
To:
```
test option_option ... ok
test variant_with_defined_casing ... ok
test skip_variant ... ok
test default_value ... ok
test vector ... FAILED
test option_vector ... ok
failures:
---- vector stdout ----
thread 'vector' panicked at 'called `Result::unwrap()` on an `Err` value: Error { message: Formatted(Colorizer { use_stderr: true, color_when: Auto
, pieces: [("error:", Some(Red)), (" ", None), ("Found argument '", None), ("bar", Some(Yellow)), ("' which wasn't expected, or isn't valid in this
context", None), ("\n\n", None), ("USAGE:\n clap_derive [OPTIONS]", None), ("\n\nFor more information try ", None), ("--help", Some(Green)), ("
\n", None)] }), kind: UnknownArgument, info: ["bar"], source: None, backtrace: Backtrace }', clap_derive/tests/arg_enum.rs:388:56
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
failures:
vector
test result: FAILED. 15 passed; 1 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
error: test failed, to rerun pass '--test arg_enum'
```
2021-10-30 14:55:50 +00:00
|
|
|
Opt3::try_parse_from(&["test", "--all", "foo", "lib.rs", "quux"]).unwrap()
|
2017-06-30 01:02:59 +00:00
|
|
|
);
|
|
|
|
}
|
2017-11-14 14:18:13 +00:00
|
|
|
|
2021-07-13 17:50:55 +00:00
|
|
|
#[derive(Parser, PartialEq, Debug)]
|
2017-11-14 14:18:13 +00:00
|
|
|
enum SubSubCmdWithOption {
|
|
|
|
Remote {
|
2018-07-02 19:06:46 +00:00
|
|
|
#[clap(subcommand)]
|
2018-05-21 14:54:22 +00:00
|
|
|
cmd: Option<Remote>,
|
2017-11-14 14:18:13 +00:00
|
|
|
},
|
|
|
|
Stash {
|
2018-07-02 19:06:46 +00:00
|
|
|
#[clap(subcommand)]
|
2018-05-21 14:54:22 +00:00
|
|
|
cmd: Stash,
|
2017-11-14 14:18:13 +00:00
|
|
|
},
|
|
|
|
}
|
2021-10-11 19:48:13 +00:00
|
|
|
#[derive(Subcommand, PartialEq, Debug)]
|
2017-11-14 14:18:13 +00:00
|
|
|
enum Remote {
|
2022-05-23 20:42:34 +00:00
|
|
|
Add {
|
|
|
|
#[clap(value_parser)]
|
|
|
|
name: String,
|
|
|
|
#[clap(value_parser)]
|
|
|
|
url: String,
|
|
|
|
},
|
|
|
|
Remove {
|
|
|
|
#[clap(value_parser)]
|
|
|
|
name: String,
|
|
|
|
},
|
2017-11-14 14:18:13 +00:00
|
|
|
}
|
|
|
|
|
2021-10-11 19:48:13 +00:00
|
|
|
#[derive(Subcommand, PartialEq, Debug)]
|
2017-11-14 14:18:13 +00:00
|
|
|
enum Stash {
|
|
|
|
Save,
|
|
|
|
Pop,
|
|
|
|
}
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn sub_sub_cmd_with_option() {
|
|
|
|
fn make(args: &[&str]) -> Option<SubSubCmdWithOption> {
|
2020-01-07 10:17:23 +00:00
|
|
|
SubSubCmdWithOption::try_parse_from(args).ok()
|
2017-11-14 14:18:13 +00:00
|
|
|
}
|
|
|
|
assert_eq!(
|
2018-05-21 14:54:22 +00:00
|
|
|
Some(SubSubCmdWithOption::Remote { cmd: None }),
|
|
|
|
make(&["", "remote"])
|
|
|
|
);
|
|
|
|
assert_eq!(
|
|
|
|
Some(SubSubCmdWithOption::Remote {
|
|
|
|
cmd: Some(Remote::Add {
|
|
|
|
name: "origin".into(),
|
|
|
|
url: "http".into()
|
|
|
|
})
|
|
|
|
}),
|
2017-11-14 14:18:13 +00:00
|
|
|
make(&["", "remote", "add", "origin", "http"])
|
|
|
|
);
|
2018-05-21 14:54:22 +00:00
|
|
|
assert_eq!(
|
|
|
|
Some(SubSubCmdWithOption::Stash { cmd: Stash::Save }),
|
|
|
|
make(&["", "stash", "save"])
|
|
|
|
);
|
2017-11-14 14:18:13 +00:00
|
|
|
assert_eq!(None, make(&["", "stash"]));
|
|
|
|
}
|