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

chore: Release

Browse source
This commit is contained in:
Ed Page 2022-06-28 08:04:18 -05:00
parent 3e80393e43
commit b4a1362486
17 changed files with 58 additions and 43 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 -->
## [Unreleased] - ReleaseDate
## [3.2.7] - 2022-06-28
### Fixes
- Global arguments should override env-sourced arguments
@ -3493,7 +3495,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))
<!-- next-url -->
[Unreleased]: https://github.com/clap-rs/clap/compare/v3.2.6...HEAD
[Unreleased]: https://github.com/clap-rs/clap/compare/v3.2.7...HEAD
[3.2.7]: https://github.com/clap-rs/clap/compare/v3.2.6...v3.2.7
[3.2.6]: https://github.com/clap-rs/clap/compare/v3.2.5...v3.2.6
[3.2.5]: https://github.com/clap-rs/clap/compare/v3.2.4...v3.2.5
[3.2.4]: https://github.com/clap-rs/clap/compare/v3.2.3...v3.2.4

4
Cargo.toml
View file

@ -10,7 +10,7 @@ members = [
[package]
name = "clap"
version = "3.2.6"
version = "3.2.7"
description = "A simple to use, efficient, and full-featured Command Line Argument Parser"
repository = "https://github.com/clap-rs/clap"
categories = ["command-line-interface"]
@ -90,7 +90,7 @@ unstable-v4 = ["clap_derive/unstable-v4", "deprecated"]
bench = false
[dependencies]
clap_derive = { path = "./clap_derive", version = "=3.2.6", optional = true }
clap_derive = { path = "./clap_derive", version = "=3.2.7", optional = true }
clap_lex = { path = "./clap_lex", version = "0.2.2" }
bitflags = "1.2"
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/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.6/LICENSE-APACHE)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/v3.2.6/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.7/LICENSE-APACHE)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/v3.2.7/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.6/examples/tutorial_builder/README.md), [Derive API](https://github.com/clap-rs/clap/blob/v3.2.6/examples/tutorial_derive/README.md)
3. [Examples](https://github.com/clap-rs/clap/blob/v3.2.6/examples/README.md)
2. Tutorial: [Builder API](https://github.com/clap-rs/clap/blob/v3.2.7/examples/tutorial_builder/README.md), [Derive API](https://github.com/clap-rs/clap/blob/v3.2.7/examples/tutorial_derive/README.md)
3. [Examples](https://github.com/clap-rs/clap/blob/v3.2.7/examples/README.md)
4. [API Reference](https://docs.rs/clap)
- [Derive Reference](https://github.com/clap-rs/clap/blob/v3.2.6/examples/derive_ref/README.md)
- [Derive Reference](https://github.com/clap-rs/clap/blob/v3.2.7/examples/derive_ref/README.md)
- [Feature Flags](#feature-flags)
5. [CHANGELOG](https://github.com/clap-rs/clap/blob/v3.2.6/CHANGELOG.md)
6. [FAQ](https://github.com/clap-rs/clap/blob/v3.2.6/docs/FAQ.md)
5. [CHANGELOG](https://github.com/clap-rs/clap/blob/v3.2.7/CHANGELOG.md)
6. [FAQ](https://github.com/clap-rs/clap/blob/v3.2.7/docs/FAQ.md)
7. [Questions & Discussions](https://github.com/clap-rs/clap/discussions)
8. [Contributing](https://github.com/clap-rs/clap/blob/v3.2.6/CONTRIBUTING.md)
8. [Contributing](https://github.com/clap-rs/clap/blob/v3.2.7/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.6/examples/tutorial_derive/README.md)
which provides access to the [Builder API](https://github.com/clap-rs/clap/blob/v3.2.6/examples/tutorial_builder/README.md) as attributes on a `struct`:
[Derive API](https://github.com/clap-rs/clap/blob/v3.2.7/examples/tutorial_derive/README.md)
which provides access to the [Builder API](https://github.com/clap-rs/clap/blob/v3.2.7/examples/tutorial_builder/README.md) as attributes on a `struct`:
<!-- Copied from examples/demo.{rs,md} -->
```rust,no_run
@ -63,7 +63,7 @@ fn main() {
Add this to `Cargo.toml`:
```toml
[dependencies]
clap = { version = "3.2.6", features = ["derive"] }
clap = { version = "3.2.7", 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.6/examples/tutorial_derive/README.md):
Why use the declarative [Derive API](https://github.com/clap-rs/clap/blob/v3.2.7/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.6/examples/tutorial_builder/README.md):
Why use the procedural [Builder API](https://github.com/clap-rs/clap/blob/v3.2.7/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

5
clap_complete/CHANGELOG.md
View file

@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
<!-- next-header -->
## [Unreleased] - ReleaseDate
## [3.2.3] - 2022-06-28
## [3.2.2] - 2022-06-21
## [3.2.1] - 2022-06-13
@ -65,7 +67,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
## [3.0.1] - 2022-01-03
<!-- next-url -->
[Unreleased]: https://github.com/clap-rs/clap/compare/clap_complete-v3.2.2...HEAD
[Unreleased]: https://github.com/clap-rs/clap/compare/clap_complete-v3.2.3...HEAD
[3.2.3]: https://github.com/clap-rs/clap/compare/clap_complete-v3.2.2...clap_complete-v3.2.3
[3.2.2]: https://github.com/clap-rs/clap/compare/clap_complete-v3.2.1...clap_complete-v3.2.2
[3.2.1]: https://github.com/clap-rs/clap/compare/clap_complete-v3.2.0...clap_complete-v3.2.1
[3.2.0]: https://github.com/clap-rs/clap/compare/clap_complete-v3.1.4...clap_complete-v3.2.0

2
clap_complete/Cargo.toml
View file

@ -1,6 +1,6 @@
[package]
name = "clap_complete"
version = "3.2.2"
version = "3.2.3"
description = "Generate shell completion scripts for your clap::Command"
repository = "https://github.com/clap-rs/clap/tree/master/clap_complete"
categories = ["command-line-interface"]

8
clap_complete/README.md
View file

@ -5,16 +5,16 @@
[![Crates.io](https://img.shields.io/crates/v/clap_complete?style=flat-square)](https://crates.io/crates/clap_complete)
[![Crates.io](https://img.shields.io/crates/d/clap_complete?style=flat-square)](https://crates.io/crates/clap_complete)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/clap_complete-v3.2.2/LICENSE-APACHE)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/clap_complete-v3.2.2/LICENSE-MIT)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/clap_complete-v3.2.3/LICENSE-APACHE)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/clap_complete-v3.2.3/LICENSE-MIT)
Dual-licensed under [Apache 2.0](LICENSE-APACHE) or [MIT](LICENSE-MIT).
1. [About](#about)
2. [API Reference](https://docs.rs/clap_complete)
3. [Questions & Discussions](https://github.com/clap-rs/clap/discussions)
4. [CONTRIBUTING](https://github.com/clap-rs/clap/blob/clap_complete-v3.2.2/clap_complete/CONTRIBUTING.md)
5. [Sponsors](https://github.com/clap-rs/clap/blob/clap_complete-v3.2.2/README.md#sponsors)
4. [CONTRIBUTING](https://github.com/clap-rs/clap/blob/clap_complete-v3.2.3/clap_complete/CONTRIBUTING.md)
5. [Sponsors](https://github.com/clap-rs/clap/blob/clap_complete-v3.2.3/README.md#sponsors)
## About

5
clap_complete_fig/CHANGELOG.md
View file

@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
<!-- next-header -->
## [Unreleased] - ReleaseDate
## [3.2.3] - 2022-06-28
## [3.2.2] - 2022-06-21
## [3.2.1] - 2022-06-13
@ -43,7 +45,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
## [3.0.1] - 2022-01-03
<!-- next-url -->
[Unreleased]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.2.2...HEAD
[Unreleased]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.2.3...HEAD
[3.2.3]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.2.2...clap_complete_fig-v3.2.3
[3.2.2]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.2.1...clap_complete_fig-v3.2.2
[3.2.1]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.2.0...clap_complete_fig-v3.2.1
[3.2.0]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.1.5...clap_complete_fig-v3.2.0

2
clap_complete_fig/Cargo.toml
View file

@ -1,6 +1,6 @@
[package]
name = "clap_complete_fig"
version = "3.2.2"
version = "3.2.3"
description = "A generator library used with clap for Fig completion scripts"
repository = "https://github.com/clap-rs/clap/tree/master/clap_complete_fig"
categories = ["command-line-interface"]

2
clap_derive/Cargo.toml
View file

@ -1,6 +1,6 @@
[package]
name = "clap_derive"
version = "3.2.6"
version = "3.2.7"
description = "Parse command line argument by defining a struct, derive crate."
repository = "https://github.com/clap-rs/clap/tree/master/clap_derive"
categories = ["command-line-interface", "development-tools::procedural-macro-helpers"]

4
clap_derive/README.md
View file

@ -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.6/examples/tutorial_derive/README.md)
- [Derive Reference](https://github.com/clap-rs/clap/blob/v3.2.6/examples/derive_ref/README.md)
- [Derive Tutorial](https://github.com/clap-rs/clap/blob/v3.2.7/examples/tutorial_derive/README.md)
- [Derive Reference](https://github.com/clap-rs/clap/blob/v3.2.7/examples/derive_ref/README.md)
## License

5
clap_lex/CHANGELOG.md
View file

@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
<!-- next-header -->
## [Unreleased] - ReleaseDate
## [0.2.4] - 2022-06-28
## [0.2.3] - 2022-06-21
## [0.2.2] - 2022-06-13
@ -28,7 +30,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
- Drop `memchr` dependency
<!-- next-url -->
[Unreleased]: https://github.com/clap-rs/clap/compare/clap_lex-v0.2.3...HEAD
[Unreleased]: https://github.com/clap-rs/clap/compare/clap_lex-v0.2.4...HEAD
[0.2.4]: https://github.com/clap-rs/clap/compare/clap_lex-v0.2.3...clap_lex-v0.2.4
[0.2.3]: https://github.com/clap-rs/clap/compare/clap_lex-v0.2.2...clap_lex-v0.2.3
[0.2.2]: https://github.com/clap-rs/clap/compare/clap_lex-v0.2.1...clap_lex-v0.2.2
[0.2.1]: https://github.com/clap-rs/clap/compare/clap_lex-v0.2.0...clap_lex-v0.2.1

2
clap_lex/Cargo.toml
View file

@ -1,6 +1,6 @@
[package]
name = "clap_lex"
version = "0.2.3"
version = "0.2.4"
description = "Minimal, flexible command line parser"
repository = "https://github.com/clap-rs/clap/tree/master/clap_lex"
categories = ["command-line-interface"]

8
clap_lex/README.md
View file

@ -5,15 +5,15 @@
[![Crates.io](https://img.shields.io/crates/v/clap_lex?style=flat-square)](https://crates.io/crates/clap_lex)
[![Crates.io](https://img.shields.io/crates/d/clap_lex?style=flat-square)](https://crates.io/crates/clap_lex)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/clap_lex-v0.2.3/LICENSE-APACHE)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/clap_lex-v0.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/clap_lex-v0.2.4/LICENSE-APACHE)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/clap_lex-v0.2.4/LICENSE-MIT)
Dual-licensed under [Apache 2.0](LICENSE-APACHE) or [MIT](LICENSE-MIT).
1. [About](#about)
2. [API Reference](https://docs.rs/clap_lex)
3. [Questions & Discussions](https://github.com/clap-rs/clap/discussions)
4. [CONTRIBUTING](https://github.com/clap-rs/clap/blob/clap_lex-v0.2.3/clap_lex/CONTRIBUTING.md)
5. [Sponsors](https://github.com/clap-rs/clap/blob/clap_lex-v0.2.3/README.md#sponsors)
4. [CONTRIBUTING](https://github.com/clap-rs/clap/blob/clap_lex-v0.2.4/clap_lex/CONTRIBUTING.md)
5. [Sponsors](https://github.com/clap-rs/clap/blob/clap_lex-v0.2.4/README.md#sponsors)
## About

5
clap_mangen/CHANGELOG.md
View file

@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
<!-- next-header -->
## [Unreleased] - ReleaseDate
## [0.1.10] - 2022-06-28
## [0.1.9] - 2022-06-21
## [0.1.8] - 2022-06-13
@ -38,7 +40,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
- Expanded the documentation
<!-- next-url -->
[Unreleased]: https://github.com/clap-rs/clap/compare/clap_mangen-v0.1.9...HEAD
[Unreleased]: https://github.com/clap-rs/clap/compare/clap_mangen-v0.1.10...HEAD
[0.1.10]: https://github.com/clap-rs/clap/compare/clap_mangen-v0.1.9...clap_mangen-v0.1.10
[0.1.9]: https://github.com/clap-rs/clap/compare/clap_mangen-v0.1.8...clap_mangen-v0.1.9
[0.1.8]: https://github.com/clap-rs/clap/compare/clap_mangen-v0.1.7...clap_mangen-v0.1.8
[0.1.7]: https://github.com/clap-rs/clap/compare/clap_mangen-v0.1.6...clap_mangen-v0.1.7

2
clap_mangen/Cargo.toml
View file

@ -1,6 +1,6 @@
[package]
name = "clap_mangen"
version = "0.1.9"
version = "0.1.10"
description = "A manpage generator for clap"
repository = "https://github.com/clap-rs/clap/tree/master/clap_mangen"
categories = ["command-line-interface"]

8
clap_mangen/README.md
View file

@ -5,16 +5,16 @@
[![Crates.io](https://img.shields.io/crates/v/clap_mangen?style=flat-square)](https://crates.io/crates/clap_mangen)
[![Crates.io](https://img.shields.io/crates/d/clap_mangen?style=flat-square)](https://crates.io/crates/clap_mangen)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/clap_mangen-v0.1.9/LICENSE-APACHE)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/clap_mangen-v0.1.9/LICENSE-MIT)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/clap_mangen-v0.1.10/LICENSE-APACHE)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/clap_mangen-v0.1.10/LICENSE-MIT)
Dual-licensed under [Apache 2.0](LICENSE-APACHE) or [MIT](LICENSE-MIT).
1. [About](#about)
2. [API Reference](https://docs.rs/clap_mangen)
3. [Questions & Discussions](https://github.com/clap-rs/clap/discussions)
4. [CONTRIBUTING](https://github.com/clap-rs/clap/blob/clap_mangen-v0.1.9/clap_mangen/CONTRIBUTING.md)
5. [Sponsors](https://github.com/clap-rs/clap/blob/clap_mangen-v0.1.9/README.md#sponsors)
4. [CONTRIBUTING](https://github.com/clap-rs/clap/blob/clap_mangen-v0.1.10/clap_mangen/CONTRIBUTING.md)
5. [Sponsors](https://github.com/clap-rs/clap/blob/clap_mangen-v0.1.10/README.md#sponsors)
## About

8
src/derive.rs
View file

@ -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.6/examples/derive_ref/README.md)
/// [derive reference](https://github.com/clap-rs/clap/blob/v3.2.7/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.6/examples/derive_ref/README.md)
/// [derive reference](https://github.com/clap-rs/clap/blob/v3.2.7/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.6/examples/derive_ref/README.md)
/// [derive reference](https://github.com/clap-rs/clap/blob/v3.2.7/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.6/examples/derive_ref/README.md)
/// [derive reference](https://github.com/clap-rs/clap/blob/v3.2.7/examples/derive_ref/README.md)
/// for attributes and best practices.
///
/// **NOTE:** Deriving requires the `derive` feature flag