Ready for 3.0.0-rc.0 release

.github/workflows/ci.yml

@@ -91,7 +91,7 @@ jobs:
         if: matrix.features == 'none'
         with:
           command: test
-          args: --target ${{ matrix.target }} --no-default-features --features "std cargo" -p clap:3.0.0-beta.5
+          args: --target ${{ matrix.target }} --no-default-features --features "std cargo" -p clap:3.0.0-rc.0
       - name: Test all features
         uses: actions-rs/cargo@v1
         if: matrix.features == 'all'
@@ -133,7 +133,7 @@ jobs:
         if: matrix.features == 'none'
         with:
           command: test
-          args: --no-default-features --features "std cargo" -p clap:3.0.0-beta.5
+          args: --no-default-features --features "std cargo" -p clap:3.0.0-rc.0
       - name: Test all features
         uses: actions-rs/cargo@v1
         if: matrix.features == 'all'

CHANGELOG.md

@@ -6,6 +6,28 @@ TODO: `YamlLoader`
 <a name="v3.0.0-rc.0"></a>
 ## v3.0.0-rc.0
 
+#### BREAKING CHANGES
+
+* **Gated behind features**
+  * `ArgMatches::grouped_values_of` is now gated behind `unstable-grouped`
+* **Renamed Structs**
+  * `clap::ArgValue` => `clap::PossibleValue`
+* **Removed Methods**
+  * `App::license`
+* **Removed Macros**
+  * `crate_license!`
+* **Changed**
+  * `Arg::from` now differentiates between `multiple_values` and `multiple_occurrences`. If `--opt [val]...` was meant for:
+    - only multiple occurrences, use `[opt]... --opt [val]`
+    - both multiple occurrences and values, use `[opt]... --opt [val]...`
+  * `Arg::from(...)` will now use `multiple_occurrences` for a positional arg's `...`, rather than `multiple_values`.
+
+#### Features
+
+* **Added Settings**
+  * `AppSettings::DisableColoredHelp`
+* **Added Methods**
+  * `App::get_color`
 
 <a name="v3.0.0-beta.5"></a>
 ## v3.0.0-beta.5 (2021-10-18)
@@ -28,7 +50,7 @@ TODO: `YamlLoader`
   * `App::generate_usage` => `App::render_usage`
 * **Removed Settings**
   * `AppSettings::DisableVersionForSubcommands` is now default behaviour
-  * `AppSettings::ColoredHelp`: we are now relying solely on the `color` feature flag and `App::color` method
+  * `AppSettings::ColoredHelp`: we are now relying solely on the `color` feature flag and `App::color` method (changed again 3.0.0-rc.0 with introduction of `AppSettings::DisableColoredHelp`)
   * `AppSettings::StrictUtf8` is now default behaviour
   * `AppSettings::AllowInvalidUtf8` in favor of `ArgSettings::AllowInvalidUtf8`
   * `AppSettings::UnifiedHelpMessage` is now default behaviour
@@ -142,7 +164,7 @@ Added `unicode_help`, `env` features.
   * `clap::Args` behind `derive` feature
 * **Added Methods**
   * **App**
-    * `App::license`
+    * `App::license` (changed again in 3.0.0-rc.0)
   * **Arg**
     * `Arg::get_long_about`
     * `Arg::get_env`

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "clap"
-version = "3.0.0-beta.5"
+version = "3.0.0-rc.0"
 edition = "2018"
 authors = [
 	"Kevin K. <kbknapp@gmail.com>",
@@ -61,7 +61,7 @@ name = "06_rustup"
 path = "benches/06_rustup.rs"
 
 [dependencies]
-clap_derive = { path = "./clap_derive", version = "=3.0.0-beta.5", optional = true }
+clap_derive = { path = "./clap_derive", version = "=3.0.0-rc.0", optional = true }
 bitflags = "1.2"
 textwrap = { version = "0.14.0", default-features = false, features = [] }
 unicase = { version = "2.6", optional = true }

README.md

@@ -17,7 +17,7 @@ It is a simple-to-use, efficient, and full-featured library for parsing command
 * [Questions & Discussions](https://github.com/clap-rs/clap/discussions)
 * [Website](https://clap.rs/)
 
-We are currently hard at work trying to release `3.0`. We have a `3.0.0-beta.5` prerelease out but we do not give any guarantees that its API is stable. We do not have a changelog yet which will be written down after we are sure about the API stability. We recommend users to not update to the prerelease version yet and to wait for the official `3.0`.
+We are currently hard at work trying to release `3.0`. We have a `3.0.0-rc.0` prerelease out but we do not give any guarantees that its API is stable. We do not have a changelog yet which will be written down after we are sure about the API stability. We recommend users to not update to the prerelease version yet and to wait for the official `3.0`.
 
 > If you're looking for the readme & examples for `clap v2.33` - find it on [github](https://github.com/clap-rs/clap/tree/v2.33.0), [crates.io](https://crates.io/crates/clap/2.33.0), [docs.rs](https://docs.rs/clap/2.33.0/clap/).
 
@@ -125,7 +125,7 @@ Add `clap` to your `Cargo.toml`
 
 ```toml
 [dependencies]
-clap = "3.0.0-beta.5"
+clap = "3.0.0-rc.0"
 ```
 
 #### Using Derive Macros
@@ -349,7 +349,7 @@ Simply add the `yaml` feature flag to your `Cargo.toml`.
 
 ```toml
 [dependencies]
-clap = { version = "3.0.0-beta.5", features = ["yaml"] }
+clap = { version = "3.0.0-rc.0", features = ["yaml"] }
 ```
 
 Finally we create our `main.rs` file just like we would have with the previous two examples:
@@ -425,7 +425,7 @@ For full usage, add `clap` as a dependency in your `Cargo.toml` to use from crat
 
 ```toml
 [dependencies]
-clap = "3.0.0-beta.5"
+clap = "3.0.0-rc.0"
 ```
 
 Define a list of valid arguments for your program (see the [documentation][docs] or [examples][examples] directory of this repo)
@@ -450,7 +450,7 @@ To disable these, add this to your `Cargo.toml`:
 
 ```toml
 [dependencies.clap]
-version = "3.0.0-beta.5"
+version = "3.0.0-rc.0"
 default-features = false
 features = ["std"]
 ```
@@ -459,7 +459,7 @@ You can also selectively enable only the features you'd like to include, by addi
 
 ```toml
 [dependencies.clap]
-version = "3.0.0-beta.5"
+version = "3.0.0-rc.0"
 default-features = false
 
 # Cherry-pick the features you'd like to use
@@ -522,7 +522,7 @@ In order to keep from being surprised of breaking changes, it is **highly** reco
 
 ```toml
 [dependencies]
-clap = "~3.0.0-beta.5"
+clap = "~3.0.0-rc.0"
 ```
 
 This will cause *only* the patch version to be updated upon a `cargo update` call, and therefore cannot break due to new features, or bumped minimum versions of Rust.

clap_derive/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "clap_derive"
-version = "3.0.0-beta.5"
+version = "3.0.0-rc.0"
 edition = "2018"
 authors = [
 	"Guillaume Pinot <texitoi@texitoi.eu>",

clap_derive/src/lib.rs

@@ -13,7 +13,7 @@
 // MIT/Apache 2.0 license.
 
 #![doc(html_logo_url = "https://clap.rs/images/media/clap.png")]
-#![doc(html_root_url = "https://docs.rs/clap_derive/3.0.0-beta.5")]
+#![doc(html_root_url = "https://docs.rs/clap_derive/3.0.0-rc.0")]
 #![doc = include_str!("../README.md")]
 #![forbid(unsafe_code)]
 

clap_generate/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "clap_generate"
-version = "3.0.0-beta.5"
+version = "3.0.0-rc.0"
 edition = "2018"
 authors = [
 	"Kevin K. <kbknapp@gmail.com>",
@@ -31,12 +31,12 @@ readme = "README.md"
 bench = false
 
 [dependencies]
-clap = { path = "../", version = "=3.0.0-beta.5", default-features = false, features = ["std"] }
+clap = { path = "../", version = "=3.0.0-rc.0", default-features = false, features = ["std"] }
 
 [dev-dependencies]
 pretty_assertions = "0.7"
 version-sync = "0.9"
-clap = { path = "../", version = "=3.0.0-beta.5", default-features = false, features = ["std", "derive"] }
+clap = { path = "../", version = "=3.0.0-rc.0", default-features = false, features = ["std", "derive"] }
 
 [features]
 default = []

clap_generate/src/lib.rs

@@ -6,7 +6,7 @@
 // for more information.
 
 #![doc(html_logo_url = "https://clap.rs/images/media/clap.png")]
-#![doc(html_root_url = "https://docs.rs/clap_generate/3.0.0-beta.5")]
+#![doc(html_root_url = "https://docs.rs/clap_generate/3.0.0-rc.0")]
 #![doc = include_str!("../README.md")]
 #![deny(missing_docs, trivial_casts, unused_allocation, trivial_numeric_casts)]
 #![forbid(unsafe_code)]

clap_generate_fig/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "clap_generate_fig"
-version = "3.0.0-beta.5"
+version = "3.0.0-rc.0"
 edition = "2018"
 authors = [
 	"Clap Maintainers"
@@ -31,8 +31,8 @@ readme = "README.md"
 bench = false
 
 [dependencies]
-clap = { path = "../", version = "=3.0.0-beta.5", default-features = false, features = ["std"] }
-clap_generate = { path = "../clap_generate", version = "=3.0.0-beta.5" }
+clap = { path = "../", version = "=3.0.0-rc.0", default-features = false, features = ["std"] }
+clap_generate = { path = "../clap_generate", version = "=3.0.0-rc.0" }
 
 [dev-dependencies]
 pretty_assertions = "0.7"

clap_generate_fig/src/lib.rs

@@ -6,7 +6,7 @@
 //! Generates [Fig](https://github.com/withfig/autocomplete) completions for [`clap`](https://github.com/clap-rs/clap) based CLIs
 
 #![doc(html_logo_url = "https://clap.rs/images/media/clap.png")]
-#![doc(html_root_url = "https://docs.rs/clap_generate_fig/3.0.0-beta.5")]
+#![doc(html_root_url = "https://docs.rs/clap_generate_fig/3.0.0-rc.0")]
 #![deny(missing_docs, trivial_casts, unused_allocation, trivial_numeric_casts)]
 #![forbid(unsafe_code)]
 #![allow(clippy::needless_doctest_main)]

src/lib.rs

@@ -4,7 +4,7 @@
 // notice may not be copied, modified, or distributed except according to those terms.
 
 #![doc(html_logo_url = "https://clap.rs/images/media/clap.png")]
-#![doc(html_root_url = "https://docs.rs/clap/3.0.0-beta.5")]
+#![doc(html_root_url = "https://docs.rs/clap/3.0.0-rc.0")]
 #![doc = include_str!("../README.md")]
 //! <https://github.com/clap-rs/clap>
 #![crate_type = "lib"]