diff --git a/CHANGELOG.md b/CHANGELOG.md index 6116f41be30..ae3e804ba0b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -30,6 +30,8 @@ _gated behind `unstable-v4`_ ## [Unreleased] - ReleaseDate +## [3.2.4] - 2022-06-14 + ### Fixes - *(derive)* Provide more clearer deprecation messages for `#[clap(parse)]` attribute (#3832) @@ -3475,7 +3477,8 @@ Minimum version of Rust is now v1.13.0 (Stable) * **arg** allow lifetimes other than 'static in arguments ([9e8c1fb9](https://github.com/clap-rs/clap/commit/9e8c1fb9406f8448873ca58bab07fe905f1551e5)) -[Unreleased]: https://github.com/clap-rs/clap/compare/v3.2.3...HEAD +[Unreleased]: https://github.com/clap-rs/clap/compare/v3.2.4...HEAD +[3.2.4]: https://github.com/clap-rs/clap/compare/v3.2.3...v3.2.4 [3.2.3]: https://github.com/clap-rs/clap/compare/v3.2.2...v3.2.3 [3.2.2]: https://github.com/clap-rs/clap/compare/v3.2.1...v3.2.2 [3.2.1]: https://github.com/clap-rs/clap/compare/v3.2.0...v3.2.1 diff --git a/Cargo.toml b/Cargo.toml index 79d42ea32a6..6742618d281 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -10,7 +10,7 @@ members = [ [package] name = "clap" -version = "3.2.3" +version = "3.2.4" description = "A simple to use, efficient, and full-featured Command Line Argument Parser" repository = "https://github.com/clap-rs/clap" documentation = "https://docs.rs/clap/" @@ -92,7 +92,7 @@ unstable-v4 = ["clap_derive/unstable-v4", "deprecated"] bench = false [dependencies] -clap_derive = { path = "./clap_derive", version = "=3.2.3", optional = true } +clap_derive = { path = "./clap_derive", version = "=3.2.4", optional = true } clap_lex = { path = "./clap_lex", version = "0.2.2" } bitflags = "1.2" textwrap = { version = "0.15.0", default-features = false, features = [] } diff --git a/README.md b/README.md index 198ca62cbbd..b16008c4f19 100644 --- a/README.md +++ b/README.md @@ -5,8 +5,8 @@ [![Crates.io](https://img.shields.io/crates/v/clap?style=flat-square)](https://crates.io/crates/clap) [![Crates.io](https://img.shields.io/crates/d/clap?style=flat-square)](https://crates.io/crates/clap) -[![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/v3.2.3/LICENSE-APACHE) -[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/v3.2.3/LICENSE-MIT) +[![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/v3.2.4/LICENSE-APACHE) +[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/v3.2.4/LICENSE-MIT) [![Build Status](https://img.shields.io/github/workflow/status/clap-rs/clap/CI/staging?style=flat-square)](https://github.com/clap-rs/clap/actions/workflows/ci.yml?query=branch%3Astaging) [![Coverage Status](https://img.shields.io/coveralls/github/clap-rs/clap/master?style=flat-square)](https://coveralls.io/github/clap-rs/clap?branch=master) [![Contributors](https://img.shields.io/github/contributors/clap-rs/clap?style=flat-square)](https://github.com/clap-rs/clap/graphs/contributors) @@ -14,15 +14,15 @@ Dual-licensed under [Apache 2.0](LICENSE-APACHE) or [MIT](LICENSE-MIT). 1. [About](#about) -2. Tutorial: [Builder API](https://github.com/clap-rs/clap/blob/v3.2.3/examples/tutorial_builder/README.md), [Derive API](https://github.com/clap-rs/clap/blob/v3.2.3/examples/tutorial_derive/README.md) -3. [Examples](https://github.com/clap-rs/clap/blob/v3.2.3/examples/README.md) +2. Tutorial: [Builder API](https://github.com/clap-rs/clap/blob/v3.2.4/examples/tutorial_builder/README.md), [Derive API](https://github.com/clap-rs/clap/blob/v3.2.4/examples/tutorial_derive/README.md) +3. [Examples](https://github.com/clap-rs/clap/blob/v3.2.4/examples/README.md) 4. [API Reference](https://docs.rs/clap) - - [Derive Reference](https://github.com/clap-rs/clap/blob/v3.2.3/examples/derive_ref/README.md) + - [Derive Reference](https://github.com/clap-rs/clap/blob/v3.2.4/examples/derive_ref/README.md) - [Feature Flags](#feature-flags) -5. [CHANGELOG](https://github.com/clap-rs/clap/blob/v3.2.3/CHANGELOG.md) -6. [FAQ](https://github.com/clap-rs/clap/blob/v3.2.3/docs/FAQ.md) +5. [CHANGELOG](https://github.com/clap-rs/clap/blob/v3.2.4/CHANGELOG.md) +6. [FAQ](https://github.com/clap-rs/clap/blob/v3.2.4/docs/FAQ.md) 7. [Questions & Discussions](https://github.com/clap-rs/clap/discussions) -8. [Contributing](https://github.com/clap-rs/clap/blob/v3.2.3/CONTRIBUTING.md) +8. [Contributing](https://github.com/clap-rs/clap/blob/v3.2.4/CONTRIBUTING.md) 8. [Sponsors](#sponsors) ## About @@ -32,8 +32,8 @@ Create your command-line parser, with all of the bells and whistles, declarative ### Example This uses our -[Derive API](https://github.com/clap-rs/clap/blob/v3.2.3/examples/tutorial_derive/README.md) -which provides access to the [Builder API](https://github.com/clap-rs/clap/blob/v3.2.3/examples/tutorial_builder/README.md) as attributes on a `struct`: +[Derive API](https://github.com/clap-rs/clap/blob/v3.2.4/examples/tutorial_derive/README.md) +which provides access to the [Builder API](https://github.com/clap-rs/clap/blob/v3.2.4/examples/tutorial_builder/README.md) as attributes on a `struct`: ```rust,no_run @@ -63,7 +63,7 @@ fn main() { Add this to `Cargo.toml`: ```toml [dependencies] -clap = { version = "3.2.3", features = ["derive"] } +clap = { version = "3.2.4", features = ["derive"] } ``` ```bash $ demo --help @@ -103,12 +103,12 @@ CLI parsers optimized for other use cases. ### Selecting an API -Why use the declarative [Derive API](https://github.com/clap-rs/clap/blob/v3.2.3/examples/tutorial_derive/README.md): +Why use the declarative [Derive API](https://github.com/clap-rs/clap/blob/v3.2.4/examples/tutorial_derive/README.md): - Easier to read, write, and modify - Easier to keep the argument declaration and reading of argument in sync - Easier to reuse, e.g. [clap-verbosity-flag](https://crates.io/crates/clap-verbosity-flag) -Why use the procedural [Builder API](https://github.com/clap-rs/clap/blob/v3.2.3/examples/tutorial_builder/README.md): +Why use the procedural [Builder API](https://github.com/clap-rs/clap/blob/v3.2.4/examples/tutorial_builder/README.md): - Faster compile times if you aren't already using other procedural macros - More flexible, e.g. you can look up how many times an argument showed up, what its values were, and what were the indexes of those values. The Derive diff --git a/clap_derive/Cargo.toml b/clap_derive/Cargo.toml index 4982d85c630..0be7b6502e9 100644 --- a/clap_derive/Cargo.toml +++ b/clap_derive/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "clap_derive" -version = "3.2.3" +version = "3.2.4" description = "Parse command line argument by defining a struct, derive crate." repository = "https://github.com/clap-rs/clap/tree/master/clap_derive" documentation = "https://docs.rs/clap_derive" diff --git a/clap_derive/README.md b/clap_derive/README.md index dacce79bcc7..ac0a1d5d9c1 100644 --- a/clap_derive/README.md +++ b/clap_derive/README.md @@ -3,8 +3,8 @@ Macro implementation for clap's derives. [docs.rs](https://docs.rs/clap) -- [Derive Tutorial](https://github.com/clap-rs/clap/blob/v3.2.3/examples/tutorial_derive/README.md) -- [Derive Reference](https://github.com/clap-rs/clap/blob/v3.2.3/examples/derive_ref/README.md) +- [Derive Tutorial](https://github.com/clap-rs/clap/blob/v3.2.4/examples/tutorial_derive/README.md) +- [Derive Reference](https://github.com/clap-rs/clap/blob/v3.2.4/examples/derive_ref/README.md) ## License diff --git a/src/derive.rs b/src/derive.rs index 504301968ae..795a722f187 100644 --- a/src/derive.rs +++ b/src/derive.rs @@ -20,7 +20,7 @@ use std::ffi::OsString; /// See also [`Subcommand`] and [`Args`]. /// /// See the -/// [derive reference](https://github.com/clap-rs/clap/blob/v3.2.3/examples/derive_ref/README.md) +/// [derive reference](https://github.com/clap-rs/clap/blob/v3.2.4/examples/derive_ref/README.md) /// for attributes and best practices. /// /// **NOTE:** Deriving requires the `derive` feature flag @@ -373,7 +373,7 @@ pub trait FromArgMatches: Sized { /// - `Variant(ChildArgs)`: No attribute is used with enum variants that impl `Args`. /// /// See the -/// [derive reference](https://github.com/clap-rs/clap/blob/v3.2.3/examples/derive_ref/README.md) +/// [derive reference](https://github.com/clap-rs/clap/blob/v3.2.4/examples/derive_ref/README.md) /// for attributes and best practices. /// /// **NOTE:** Deriving requires the `derive` feature flag @@ -417,7 +417,7 @@ pub trait Args: FromArgMatches + Sized { /// `Subcommand`. /// /// See the -/// [derive reference](https://github.com/clap-rs/clap/blob/v3.2.3/examples/derive_ref/README.md) +/// [derive reference](https://github.com/clap-rs/clap/blob/v3.2.4/examples/derive_ref/README.md) /// for attributes and best practices. /// /// **NOTE:** Deriving requires the `derive` feature flag @@ -461,7 +461,7 @@ pub trait Subcommand: FromArgMatches + Sized { /// - Allowing using the `#[clap(default_value_t)]` attribute without implementing `Display`. /// /// See the -/// [derive reference](https://github.com/clap-rs/clap/blob/v3.2.3/examples/derive_ref/README.md) +/// [derive reference](https://github.com/clap-rs/clap/blob/v3.2.4/examples/derive_ref/README.md) /// for attributes and best practices. /// /// **NOTE:** Deriving requires the `derive` feature flag