Add support for subcommands

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "structopt"
-version = "0.0.5"
+version = "0.1.0"
 authors = ["Guillaume Pinot <texitoi@texitoi.eu>"]
 description = "Parse command line argument by defining a struct."
 documentation = "https://docs.rs/structopt"
@@ -17,6 +17,6 @@ travis-ci = { repository = "TeXitoi/structopt" }
 clap = "2.20"
 
 [dev-dependencies]
-structopt-derive = { path = "structopt-derive", version = "0.0.5" }
+structopt-derive = { path = "structopt-derive", version = "0.1.0" }
 
 [workspace]

README.md

@@ -8,11 +8,11 @@ Find it on Docs.rs: [structopt-derive](https://docs.rs/structopt-derive) and [st
 
 ## Example
 
-Add `structopt` and `structop-derive` to your dependencies of your `Cargo.toml`:
+Add `structopt` and `structopt-derive` to your dependencies of your `Cargo.toml`:
 ```toml
 [dependencies]
-structopt = "0.0.3"
-structopt-derive = "0.0.3"
+structopt = "0.1.0"
+structopt-derive = "0.1.0"
 ```
 
 And then, in your rust file:

examples/git.rs

@@ -0,0 +1,40 @@
+//! `git.rs` serves as a demonstration of how to use subcommands,
+//! as well as a demonstration of adding documentation to subcommands.
+//! Documentation can be added either through doc comments or the
+//! `about` attribute.
+
+extern crate structopt;
+#[macro_use] extern crate structopt_derive;
+
+use structopt::StructOpt;
+
+#[derive(StructOpt, Debug)]
+#[structopt(name = "git")]
+/// the stupid content tracker
+enum Opt {
+    #[structopt(name = "fetch")]
+    /// fetch branches from remote repository
+    Fetch {
+        #[structopt(long = "dry-run")]
+        dry_run: bool,
+        #[structopt(long = "all")]
+        all: bool,
+        #[structopt(default_value = "origin")]
+        repository: String
+    },
+    #[structopt(name = "add")]
+    /// add files to the staging area
+    Add {
+        #[structopt(short = "i")]
+        interactive: bool,
+        #[structopt(short = "a")]
+        all: bool,
+        files: Vec<String>
+    }
+}
+
+fn main() {
+    let matches = Opt::from_args();
+
+    println!("{:?}", matches);
+}

src/lib.rs

@@ -10,8 +10,9 @@
 //! `StructOpt` trait definition
 //!
 //! This crate defines the `StructOpt` trait.  Alone, this crate is of
-//! little interest.  See the `structopt-derive` crate to
-//! automatically generate implementation of this trait.
+//! little interest.  See the 
+//! [`structopt-derive`](https://docs.rs/structopt-derive) crate to
+//! automatically generate an implementation of this trait.
 
 extern crate clap as _clap;
 

structopt-derive/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "structopt-derive"
-version = "0.0.5"
+version = "0.1.0"
 authors = ["Guillaume Pinot <texitoi@texitoi.eu>"]
 description = "Parse command line argument by defining a struct, derive crate."
 documentation = "https://docs.rs/structopt-derive"