V0.3.7

CHANGELOG.md

@@ -1,4 +1,12 @@
-# v0.3.6 (2019-12-22)
+# v0.3.7 (2019-12-28)
+
+Nothing's new. Just re-release of `v0.3.6` due to
+[the mess with versioning](https://github.com/TeXitoi/structopt/issues/315#issuecomment-568502792).
+
+You may notice that `structopt-derive` was bumped to `v0.4.0`, that's OK, it's not a breaking change.
+`structopt` will pull the right version in on its on.
+
+# v0.3.6 (2019-12-22) - YANKED
 
 This is unusually big patch release. It contains a number of bugfixes and
 new features, some of them may theoretically be considered breaking. We did our best

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "structopt"
-version = "0.3.6"
+version = "0.3.7"
 edition = "2018"
 authors = ["Guillaume Pinot <[email protected]>", "others"]
 description = "Parse command line argument by defining a struct."
@@ -28,7 +28,7 @@ travis-ci = { repository = "TeXitoi/structopt" }
 
 [dependencies]
 clap = { version = "2.33", default-features = false }
-structopt-derive = { path = "structopt-derive", version = "0.3.6" }
+structopt-derive = { path = "structopt-derive", version = "=0.4.0" }
 
 [dev-dependencies]
 trybuild = "1.0.5"

src/lib.rs

@@ -966,27 +966,24 @@ pub trait StructOpt {
     {
         Ok(Self::from_clap(&Self::clap().get_matches_from_safe(iter)?))
     }
+}
 
-    // All the following is NOT PUBLIC API!!!
-    //
-    // ** SUBJECT TO CHANGE WITHOUT NOTICE!!! **
-
-    #[doc(hidden)]
-    fn is_subcommand() -> bool {
-        unimplemented!()
+/// This trait is NOT API. **SUBJECT TO CHANGE WITHOUT NOTICE!**.
+#[doc(hidden)]
+pub trait StructOptInternal: StructOpt {
+    fn augment_clap<'a, 'b>(app: clap::App<'a, 'b>) -> clap::App<'a, 'b> {
+        app
     }
 
-    #[doc(hidden)]
-    fn augment_clap<'a, 'b>(_app: clap::App<'a, 'b>) -> clap::App<'a, 'b> {
-        unimplemented!()
+    fn is_subcommand() -> bool {
+        false
     }
 
-    #[doc(hidden)]
     fn from_subcommand<'a, 'b>(_sub: (&'b str, Option<&'b clap::ArgMatches<'a>>)) -> Option<Self>
     where
-        Self: Sized,
+        Self: std::marker::Sized,
     {
-        unimplemented!()
+        None
     }
 }
 
@@ -998,19 +995,21 @@ impl<T: StructOpt> StructOpt for Box<T> {
     fn from_clap(matches: &clap::ArgMatches<'_>) -> Self {
         Box::new(<T as StructOpt>::from_clap(matches))
     }
+}
 
+impl<T: StructOptInternal> StructOptInternal for Box<T> {
     #[doc(hidden)]
-    fn augment_clap<'a, 'b>(app: clap::App<'a, 'b>) -> clap::App<'a, 'b> {
-        <T as StructOpt>::augment_clap(app)
+    fn is_subcommand() -> bool {
+        <T as StructOptInternal>::is_subcommand()
     }
 
     #[doc(hidden)]
-    fn is_subcommand() -> bool {
-        <T as StructOpt>::is_subcommand()
+    fn from_subcommand<'a, 'b>(sub: (&'b str, Option<&'b clap::ArgMatches<'a>>)) -> Option<Self> {
+        <T as StructOptInternal>::from_subcommand(sub).map(Box::new)
     }
 
     #[doc(hidden)]
-    fn from_subcommand<'a, 'b>(sub: (&'b str, Option<&'b clap::ArgMatches<'a>>)) -> Option<Self> {
-        <T as StructOpt>::from_subcommand(sub).map(Box::new)
+    fn augment_clap<'a, 'b>(app: clap::App<'a, 'b>) -> clap::App<'a, 'b> {
+        <T as StructOptInternal>::augment_clap(app)
     }
 }

structopt-derive/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "structopt-derive"
-version = "0.3.6"
+version = "0.4.0"
 edition = "2018"
 authors = ["Guillaume Pinot <[email protected]>"]
 description = "Parse command line argument by defining a struct, derive crate."

structopt-derive/src/lib.rs

@@ -87,7 +87,9 @@ fn gen_augmentation(
 
             let span = field.span();
             let ts = quote! {
-                let #app_var = <#subcmd_type as ::structopt::StructOpt>::augment_clap( #app_var );
+                let #app_var = <#subcmd_type as ::structopt::StructOptInternal>::augment_clap(
+                    #app_var
+                );
                 #required
             };
             Some((span, ts))
@@ -116,8 +118,8 @@ fn gen_augmentation(
             Kind::FlattenStruct => {
                 let ty = &field.ty;
                 Some(quote_spanned! { kind.span()=>
-                    let #app_var = <#ty as ::structopt::StructOpt>::augment_clap(#app_var);
-                    let #app_var = if <#ty as ::structopt::StructOpt>::is_subcommand() {
+                    let #app_var = <#ty as ::structopt::StructOptInternal>::augment_clap(#app_var);
+                    let #app_var = if <#ty as ::structopt::StructOptInternal>::is_subcommand() {
                         #app_var.setting(::structopt::clap::AppSettings::SubcommandRequiredElseHelp)
                     } else {
                         #app_var
@@ -249,7 +251,7 @@ fn gen_constructor(fields: &Punctuated<Field, Comma>, parent_attribute: &Attrs)
                     _ => quote_spanned!( ty.span()=> .unwrap() ),
                 };
                 quote_spanned! { kind.span()=>
-                    #field_name: <#subcmd_type as ::structopt::StructOpt>::from_subcommand(
+                    #field_name: <#subcmd_type as ::structopt::StructOptInternal>::from_subcommand(
                         matches.subcommand())
                         #unwrapper
                 }
@@ -396,7 +398,7 @@ fn gen_clap_struct(struct_attrs: &[Attribute]) -> GenOutput {
     let augmented_tokens = quote! {
         fn clap<'a, 'b>() -> ::structopt::clap::App<'a, 'b> {
             let app = #clap_tokens;
-            <Self as ::structopt::StructOpt>::augment_clap(app)
+            <Self as ::structopt::StructOptInternal>::augment_clap(app)
         }
     };
 
@@ -426,7 +428,7 @@ fn gen_clap_enum(enum_attrs: &[Attribute]) -> GenOutput {
         fn clap<'a, 'b>() -> ::structopt::clap::App<'a, 'b> {
             let app = #clap_tokens
                 .setting(::structopt::clap::AppSettings::SubcommandRequiredElseHelp);
-            <Self as ::structopt::StructOpt>::augment_clap(app)
+            <Self as ::structopt::StructOptInternal>::augment_clap(app)
         }
     };
 
@@ -458,8 +460,10 @@ fn gen_augment_clap_enum(
                 let ty = &unnamed[0];
                 quote_spanned! { ty.span()=>
                     {
-                        let #app_var = <#ty as ::structopt::StructOpt>::augment_clap(#app_var);
-                        if <#ty as ::structopt::StructOpt>::is_subcommand() {
+                        let #app_var = <#ty as ::structopt::StructOptInternal>::augment_clap(
+                            #app_var
+                        );
+                        if <#ty as ::structopt::StructOptInternal>::is_subcommand() {
                             #app_var.setting(
                                 ::structopt::clap::AppSettings::SubcommandRequiredElseHelp
                             )
@@ -498,7 +502,7 @@ fn gen_augment_clap_enum(
 fn gen_from_clap_enum(name: &Ident) -> TokenStream {
     quote! {
         fn from_clap(matches: &::structopt::clap::ArgMatches) -> Self {
-            <#name as ::structopt::StructOpt>::from_subcommand(matches.subcommand())
+            <#name as ::structopt::StructOptInternal>::from_subcommand(matches.subcommand())
                 .unwrap()
         }
     }
@@ -580,11 +584,18 @@ fn impl_structopt_for_struct(
     quote! {
         #[allow(unused_variables)]
         #[allow(unknown_lints)]
-        #[allow(clippy)]
+        #[allow(clippy::all)]
         #[allow(dead_code, unreachable_code)]
         impl ::structopt::StructOpt for #name {
             #clap_tokens
             #from_clap
+        }
+
+        #[allow(unused_variables)]
+        #[allow(unknown_lints)]
+        #[allow(clippy::all)]
+        #[allow(dead_code, unreachable_code)]
+        impl ::structopt::StructOptInternal for #name {
             #augment_clap
             fn is_subcommand() -> bool { false }
         }
@@ -613,6 +624,13 @@ fn impl_structopt_for_enum(
         impl ::structopt::StructOpt for #name {
             #clap_tokens
             #from_clap
+        }
+
+        #[allow(unused_variables)]
+        #[allow(unknown_lints)]
+        #[allow(clippy::all)]
+        #[allow(dead_code, unreachable_code)]
+        impl ::structopt::StructOptInternal for #name {
             #augment_clap
             #from_subcommand
             fn is_subcommand() -> bool { true }