Add structopt dependency in version 0.3.7

This patch series replaces argparse with structopt in the argument
handling code. As a first step, we need structopt as a dependency.

Import subrepo structopt/:structopt at efbdda4753592e27bc430fb01f7b9650b2f3174d
Import subrepo bitflags/:bitflags at 30668016aca6bd3b02c766e8347e0b4080d4c296
Import subrepo clap/:clap at 784524f7eb193e35f81082cc69454c8c21b948f7
Import subrepo heck/:heck at 093d56fbf001e1506e56dbfa38631d99b1066df1
Import subrepo proc-macro-error/:proc-macro-error at 6c4cfe79a622c5de8ae68557993542be46eacae2
Import subrepo proc-macro2/:proc-macro2 at d5d48eddca4566e5438e8a2cbed4a74e049544de
Import subrepo quote/:quote at 727436c6c137b20f0f34dde5d8fda2679b9747ad
Import subrepo rustversion/:rustversion at 0c5663313516263059ce9059ef81fc7a1cf655ca
Import subrepo syn-mid/:syn-mid at 5d3d85414a9e6674e1857ec22a87b96e04a6851a
Import subrepo syn/:syn at e87c27e87f6f4ef8919d0372bdb056d53ef0d8f3
Import subrepo textwrap/:textwrap at abcd618beae3f74841032aa5b53c1086b0a57ca2
Import subrepo unicode-segmentation/:unicode-segmentation at 637c9874c4fe0c205ff27787faf150a40295c6c3
Import subrepo unicode-width/:unicode-width at 3033826f8bf05e82724140a981d5941e48fce393
Import subrepo unicode-xid/:unicode-xid at 4baae9fffb156ba229665b972a9cd5991787ceb7

1 files changed, 198 insertions, 0 deletions

diff --git a/clap/benches/04_new_help.rs b/clap/benches/04_new_help.rs
new file mode 100644
index 0000000..f033efb
--- /dev/null
+++ b/clap/benches/04_new_help.rs
@@ -0,0 +1,198 @@
+#![feature(test)]
+
+extern crate clap;
+extern crate test;
+
+use test::Bencher;
+
+use std::io::Cursor;
+
+use clap::App;
+use clap::{Arg, SubCommand};
+
+fn build_help(app: &App) -> String {
+    let mut buf = Cursor::new(Vec::with_capacity(50));
+    app.write_help(&mut buf).unwrap();
+    let content = buf.into_inner();
+    String::from_utf8(content).unwrap()
+}
+
+fn app_example1<'b, 'c>() -> App<'b, 'c> {
+    App::new("MyApp")
+        .version("1.0")
+        .author("Kevin K. <kbknapp@gmail.com>")
+        .about("Does awesome things")
+        .args_from_usage("-c, --config=[FILE] 'Sets a custom config file'
+                          <output> 'Sets an optional output file'
+                          -d... 'Turn debugging information on'")
+        .subcommand(SubCommand::with_name("test")
+            .about("does testing things")
+            .arg_from_usage("-l, --list 'lists test values'"))
+}
+
+fn app_example2<'b, 'c>() -> App<'b, 'c> {
+    App::new("MyApp")
+        .version("1.0")
+        .author("Kevin K. <kbknapp@gmail.com>")
+        .about("Does awesome things")
+}
+
+fn app_example3<'b, 'c>() -> App<'b, 'c> {
+    App::new("MyApp")
+        .arg(Arg::with_name("debug")
+            .help("turn on debugging information")
+            .short("d"))
+        .args(&[Arg::with_name("config")
+                    .help("sets the config file to use")
+                    .takes_value(true)
+                    .short("c")
+                    .long("config"),
+                Arg::with_name("input")
+                    .help("the input file to use")
+                    .index(1)
+                    .required(true)])
+        .arg_from_usage("--license 'display the license file'")
+        .args_from_usage("[output] 'Supply an output file to use'
+                          -i, --int=[IFACE] 'Set an interface to use'")
+}
+
+fn app_example4<'b, 'c>() -> App<'b, 'c> {
+    App::new("MyApp")
+        .about("Parses an input file to do awesome things")
+        .version("1.0")
+        .author("Kevin K. <kbknapp@gmail.com>")
+        .arg(Arg::with_name("debug")
+            .help("turn on debugging information")
+            .short("d")
+            .long("debug"))
+        .arg(Arg::with_name("config")
+            .help("sets the config file to use")
+            .short("c")
+            .long("config"))
+        .arg(Arg::with_name("input")
+            .help("the input file to use")
+            .index(1)
+            .required(true))
+}
+
+fn app_example5<'b, 'c>() -> App<'b, 'c> {
+    App::new("MyApp").arg(Arg::with_name("awesome")
+        .help("turns up the awesome")
+        .short("a")
+        .long("awesome")
+        .multiple(true)
+        .requires("config")
+        .conflicts_with("output"))
+}
+
+fn app_example6<'b, 'c>() -> App<'b, 'c> {
+    App::new("MyApp")
+        .arg(Arg::with_name("input")
+            .help("the input file to use")
+            .index(1)
+            .requires("config")
+            .conflicts_with("output")
+            .required(true))
+        .arg(Arg::with_name("config")
+            .help("the config file to use")
+            .index(2))
+}
+
+fn app_example7<'b, 'c>() -> App<'b, 'c> {
+    App::new("MyApp")
+        .arg(Arg::with_name("config"))
+        .arg(Arg::with_name("output"))
+        .arg(Arg::with_name("input")
+            .help("the input file to use")
+            .takes_value(true)
+            .short("i")
+            .long("input")
+            .multiple(true)
+            .required(true)
+            .requires("config")
+            .conflicts_with("output"))
+}
+
+fn app_example8<'b, 'c>() -> App<'b, 'c> {
+    App::new("MyApp")
+        .arg(Arg::with_name("config"))
+        .arg(Arg::with_name("output"))
+        .arg(Arg::with_name("input")
+            .help("the input file to use")
+            .takes_value(true)
+            .short("i")
+            .long("input")
+            .multiple(true)
+            .required(true)
+            .requires("config")
+            .conflicts_with("output"))
+}
+
+fn app_example10<'b, 'c>() -> App<'b, 'c> {
+    App::new("myapp")
+        .about("does awesome things")
+        .arg(Arg::with_name("CONFIG")
+            .help("The config file to use (default is \"config.json\")")
+            .short("c")
+            .takes_value(true))
+}
+
+#[bench]
+fn example1(b: &mut Bencher) {
+    let app = app_example1();
+    b.iter(|| build_help(&app));
+}
+
+#[bench]
+fn example2(b: &mut Bencher) {
+    let app = app_example2();
+    b.iter(|| build_help(&app));
+}
+
+#[bench]
+fn example3(b: &mut Bencher) {
+    let app = app_example3();
+    b.iter(|| build_help(&app));
+}
+
+#[bench]
+fn example4(b: &mut Bencher) {
+    let app = app_example4();
+    b.iter(|| build_help(&app));
+}
+
+#[bench]
+fn example5(b: &mut Bencher) {
+    let app = app_example5();
+    b.iter(|| build_help(&app));
+}
+
+#[bench]
+fn example6(b: &mut Bencher) {
+    let app = app_example6();
+    b.iter(|| build_help(&app));
+}
+
+#[bench]
+fn example7(b: &mut Bencher) {
+    let app = app_example7();
+    b.iter(|| build_help(&app));
+}
+
+#[bench]
+fn example8(b: &mut Bencher) {
+    let app = app_example8();
+    b.iter(|| build_help(&app));
+}
+
+#[bench]
+fn example10(b: &mut Bencher) {
+    let app = app_example10();
+    b.iter(|| build_help(&app));
+}
+
+#[bench]
+fn example4_template(b: &mut Bencher) {
+    let app = app_example4().template("{bin} {version}\n{author}\n{about}\n\nUSAGE:\n    {usage}\n\nFLAGS:\n{flags}\n\nARGS:\n{args}\n");
+    b.iter(|| build_help(&app));
+}