Mirrors/clap
2
0
Fork 0
mirror of https://github.com/clap-rs/clap synced 2024-11-10 14:54:15 +00:00
Code Issues Projects Releases Packages Wiki Activity

chore: Release

Browse source
This commit is contained in:
Ed Page 2022-06-14 15:01:42 -05:00
parent 241a6fcfbc
commit 20358ff295
6 changed files with 26 additions and 23 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
CHANGELOG.md
View file

@ -30,6 +30,8 @@ _gated behind `unstable-v4`_
<!-- next-header --> <!-- next-header -->
## [Unreleased] - ReleaseDate ## [Unreleased] - ReleaseDate
## [3.2.4] - 2022-06-14
### Fixes ### Fixes
- *(derive)* Provide more clearer deprecation messages for `#[clap(parse)]` attribute (#3832) - *(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)) * **arg** allow lifetimes other than 'static in arguments ([9e8c1fb9](https://github.com/clap-rs/clap/commit/9e8c1fb9406f8448873ca58bab07fe905f1551e5))
<!-- next-url --> <!-- next-url -->
[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.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.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 [3.2.1]: https://github.com/clap-rs/clap/compare/v3.2.0...v3.2.1

4
Cargo.toml
View file

@ -10,7 +10,7 @@ members = [
[package] [package]
name = "clap" name = "clap"
version = "3.2.3" version = "3.2.4"
description = "A simple to use, efficient, and full-featured Command Line Argument Parser" description = "A simple to use, efficient, and full-featured Command Line Argument Parser"
repository = "https://github.com/clap-rs/clap" repository = "https://github.com/clap-rs/clap"
documentation = "https://docs.rs/clap/" documentation = "https://docs.rs/clap/"
@ -92,7 +92,7 @@ unstable-v4 = ["clap_derive/unstable-v4", "deprecated"]
bench = false bench = false
[dependencies] [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" } clap_lex = { path = "./clap_lex", version = "0.2.2" }
bitflags = "1.2" bitflags = "1.2"
textwrap = { version = "0.15.0", default-features = false, features = [] } textwrap = { version = "0.15.0", default-features = false, features = [] }

26
README.md
View file

@ -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/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) [![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-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.3/LICENSE-MIT) [![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) [![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) [![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) [![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). Dual-licensed under [Apache 2.0](LICENSE-APACHE) or [MIT](LICENSE-MIT).
1. [About](#about) 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) 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.3/examples/README.md) 3. [Examples](https://github.com/clap-rs/clap/blob/v3.2.4/examples/README.md)
4. [API Reference](https://docs.rs/clap) 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) - [Feature Flags](#feature-flags)
5. [CHANGELOG](https://github.com/clap-rs/clap/blob/v3.2.3/CHANGELOG.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.3/docs/FAQ.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) 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) 8. [Sponsors](#sponsors)
## About ## About
@ -32,8 +32,8 @@ Create your command-line parser, with all of the bells and whistles, declarative
### Example ### Example
This uses our This uses our
[Derive API](https://github.com/clap-rs/clap/blob/v3.2.3/examples/tutorial_derive/README.md) [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.3/examples/tutorial_builder/README.md) as attributes on a `struct`: 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`:
<!-- Copied from examples/demo.{rs,md} --> <!-- Copied from examples/demo.{rs,md} -->
```rust,no_run ```rust,no_run
@ -63,7 +63,7 @@ fn main() {
Add this to `Cargo.toml`: Add this to `Cargo.toml`:
```toml ```toml
[dependencies] [dependencies]
clap = { version = "3.2.3", features = ["derive"] } clap = { version = "3.2.4", features = ["derive"] }
``` ```
```bash ```bash
$ demo --help $ demo --help
@ -103,12 +103,12 @@ CLI parsers optimized for other use cases.
### Selecting an API ### 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 read, write, and modify
- Easier to keep the argument declaration and reading of argument in sync - 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) - 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 - 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, - 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 what its values were, and what were the indexes of those values. The Derive

2
clap_derive/Cargo.toml
View file

@ -1,6 +1,6 @@
[package] [package]
name = "clap_derive" name = "clap_derive"
version = "3.2.3" version = "3.2.4"
description = "Parse command line argument by defining a struct, derive crate." description = "Parse command line argument by defining a struct, derive crate."
repository = "https://github.com/clap-rs/clap/tree/master/clap_derive" repository = "https://github.com/clap-rs/clap/tree/master/clap_derive"
documentation = "https://docs.rs/clap_derive" documentation = "https://docs.rs/clap_derive"

4
clap_derive/README.md
View file

@ -3,8 +3,8 @@
Macro implementation for clap's derives. Macro implementation for clap's derives.
[docs.rs](https://docs.rs/clap) [docs.rs](https://docs.rs/clap)
- [Derive Tutorial](https://github.com/clap-rs/clap/blob/v3.2.3/examples/tutorial_derive/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.3/examples/derive_ref/README.md) - [Derive Reference](https://github.com/clap-rs/clap/blob/v3.2.4/examples/derive_ref/README.md)
## License ## License

8
src/derive.rs
View file

@ -20,7 +20,7 @@ use std::ffi::OsString;
/// See also [`Subcommand`] and [`Args`]. /// See also [`Subcommand`] and [`Args`].
/// ///
/// See the /// 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. /// for attributes and best practices.
/// ///
/// **NOTE:** Deriving requires the `derive` feature flag /// **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`. /// - `Variant(ChildArgs)`: No attribute is used with enum variants that impl `Args`.
/// ///
/// See the /// 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. /// for attributes and best practices.
/// ///
/// **NOTE:** Deriving requires the `derive` feature flag /// **NOTE:** Deriving requires the `derive` feature flag
@ -417,7 +417,7 @@ pub trait Args: FromArgMatches + Sized {
/// `Subcommand`. /// `Subcommand`.
/// ///
/// See the /// 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. /// for attributes and best practices.
/// ///
/// **NOTE:** Deriving requires the `derive` feature flag /// **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`. /// - Allowing using the `#[clap(default_value_t)]` attribute without implementing `Display`.
/// ///
/// See the /// 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. /// for attributes and best practices.
/// ///
/// **NOTE:** Deriving requires the `derive` feature flag /// **NOTE:** Deriving requires the `derive` feature flag