Mirrors/clap
2
0
Fork 0
mirror of https://github.com/clap-rs/clap synced 2024-12-13 14:22:34 +00:00
Code Issues Projects Releases Packages Wiki Activity

chore: Release

Browse source
This commit is contained in:
Ed Page 2022-04-19 10:31:52 -05:00
parent 62b1e4874a
commit 0194568b03
12 changed files with 49 additions and 37 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
CHANGELOG.md
View file

@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
<!-- next-header --> <!-- next-header -->
## [Unreleased] - ReleaseDate ## [Unreleased] - ReleaseDate
## [3.1.10] - 2022-04-19
### Featues ### Featues
- Expose `Command::build` for custom help generation or other command introspection needs - Expose `Command::build` for custom help generation or other command introspection needs
@ -3257,7 +3259,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.1.9...HEAD [Unreleased]: https://github.com/clap-rs/clap/compare/v3.1.10...HEAD
[3.1.10]: https://github.com/clap-rs/clap/compare/v3.1.9...v3.1.10
[3.1.9]: https://github.com/clap-rs/clap/compare/v3.1.8...v3.1.9 [3.1.9]: https://github.com/clap-rs/clap/compare/v3.1.8...v3.1.9
[3.1.8]: https://github.com/clap-rs/clap/compare/v3.1.7...v3.1.8 [3.1.8]: https://github.com/clap-rs/clap/compare/v3.1.7...v3.1.8
[3.1.7]: https://github.com/clap-rs/clap/compare/v3.1.6...v3.1.7 [3.1.7]: https://github.com/clap-rs/clap/compare/v3.1.6...v3.1.7

2
Cargo.toml
View file

@ -9,7 +9,7 @@ members = [
[package] [package]
name = "clap" name = "clap"
version = "3.1.9" version = "3.1.10"
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/"

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.1.9/LICENSE-APACHE) [![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/v3.1.10/LICENSE-APACHE)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/v3.1.9/LICENSE-MIT) [![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/v3.1.10/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.1.9/examples/tutorial_builder/README.md), [Derive API](https://github.com/clap-rs/clap/blob/v3.1.9/examples/tutorial_derive/README.md) 2. Tutorial: [Builder API](https://github.com/clap-rs/clap/blob/v3.1.10/examples/tutorial_builder/README.md), [Derive API](https://github.com/clap-rs/clap/blob/v3.1.10/examples/tutorial_derive/README.md)
3. [Examples](https://github.com/clap-rs/clap/blob/v3.1.9/examples/README.md) 3. [Examples](https://github.com/clap-rs/clap/blob/v3.1.10/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.1.9/examples/derive_ref/README.md) - [Derive Reference](https://github.com/clap-rs/clap/blob/v3.1.10/examples/derive_ref/README.md)
- [Feature Flags](#feature-flags) - [Feature Flags](#feature-flags)
5. [CHANGELOG](https://github.com/clap-rs/clap/blob/v3.1.9/CHANGELOG.md) 5. [CHANGELOG](https://github.com/clap-rs/clap/blob/v3.1.10/CHANGELOG.md)
6. [FAQ](https://github.com/clap-rs/clap/blob/v3.1.9/docs/FAQ.md) 6. [FAQ](https://github.com/clap-rs/clap/blob/v3.1.10/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.1.9/CONTRIBUTING.md) 8. [Contributing](https://github.com/clap-rs/clap/blob/v3.1.10/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.1.9/examples/tutorial_derive/README.md) [Derive API](https://github.com/clap-rs/clap/blob/v3.1.10/examples/tutorial_derive/README.md)
which provides access to the [Builder API](https://github.com/clap-rs/clap/blob/v3.1.9/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.1.10/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.1.9", features = ["derive"] } clap = { version = "3.1.10", 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.1.9/examples/tutorial_derive/README.md): Why use the declarative [Derive API](https://github.com/clap-rs/clap/blob/v3.1.10/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.1.9/examples/tutorial_builder/README.md): Why use the procedural [Builder API](https://github.com/clap-rs/clap/blob/v3.1.10/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

5
clap_complete/CHANGELOG.md
View file

@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
<!-- next-header --> <!-- next-header -->
## [Unreleased] - ReleaseDate ## [Unreleased] - ReleaseDate
## [3.1.2] - 2022-04-19
## [3.1.1] - 2022-03-02 ## [3.1.1] - 2022-03-02
## [3.1.0] - 2022-02-16 ## [3.1.0] - 2022-02-16
@ -45,7 +47,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
## [3.0.1] - 2022-01-03 ## [3.0.1] - 2022-01-03
<!-- next-url --> <!-- next-url -->
[Unreleased]: https://github.com/clap-rs/clap/compare/clap_complete-v3.1.1...HEAD [Unreleased]: https://github.com/clap-rs/clap/compare/clap_complete-v3.1.2...HEAD
[3.1.2]: https://github.com/clap-rs/clap/compare/clap_complete-v3.1.1...clap_complete-v3.1.2
[3.1.1]: https://github.com/clap-rs/clap/compare/clap_complete-v3.1.0...clap_complete-v3.1.1 [3.1.1]: https://github.com/clap-rs/clap/compare/clap_complete-v3.1.0...clap_complete-v3.1.1
[3.1.0]: https://github.com/clap-rs/clap/compare/clap_complete-v3.0.6...clap_complete-v3.1.0 [3.1.0]: https://github.com/clap-rs/clap/compare/clap_complete-v3.0.6...clap_complete-v3.1.0
[3.0.6]: https://github.com/clap-rs/clap/compare/clap_complete-v3.0.5...clap_complete-v3.0.6 [3.0.6]: https://github.com/clap-rs/clap/compare/clap_complete-v3.0.5...clap_complete-v3.0.6

6
clap_complete/Cargo.toml
View file

@ -1,6 +1,6 @@
[package] [package]
name = "clap_complete" name = "clap_complete"
version = "3.1.1" version = "3.1.2"
edition = "2018" edition = "2018"
include = [ include = [
"src/**/*", "src/**/*",
@ -35,12 +35,12 @@ pre-release-replacements = [
bench = false bench = false
[dependencies] [dependencies]
clap = { path = "../", version = "3.1.0", default-features = false, features = ["std"] } clap = { path = "../", version = "3.1.10", default-features = false, features = ["std"] }
[dev-dependencies] [dev-dependencies]
pretty_assertions = "1.0" pretty_assertions = "1.0"
snapbox = { version = "0.2", features = ["diff"] } snapbox = { version = "0.2", features = ["diff"] }
clap = { path = "../", version = "3.1.0", default-features = false, features = ["std", "derive"] } clap = { path = "../", version = "3.1.10", default-features = false, features = ["std", "derive"] }
[features] [features]
default = [] default = []

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/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) [![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.1.1/LICENSE-APACHE) [![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/clap_complete-v3.1.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.1.1/LICENSE-MIT) [![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/clap_complete-v3.1.2/LICENSE-MIT)
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. [API Reference](https://docs.rs/clap_complete) 2. [API Reference](https://docs.rs/clap_complete)
3. [Questions & Discussions](https://github.com/clap-rs/clap/discussions) 3. [Questions & Discussions](https://github.com/clap-rs/clap/discussions)
4. [CONTRIBUTING](https://github.com/clap-rs/clap/blob/clap_complete-v3.1.1/clap_complete/CONTRIBUTING.md) 4. [CONTRIBUTING](https://github.com/clap-rs/clap/blob/clap_complete-v3.1.2/clap_complete/CONTRIBUTING.md)
5. [Sponsors](https://github.com/clap-rs/clap/blob/clap_complete-v3.1.1/README.md#sponsors) 5. [Sponsors](https://github.com/clap-rs/clap/blob/clap_complete-v3.1.2/README.md#sponsors)
## About ## 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 --> <!-- next-header -->
## [Unreleased] - ReleaseDate ## [Unreleased] - ReleaseDate
## [3.1.5] - 2022-04-19
## [3.1.4] - 2022-03-21 ## [3.1.4] - 2022-03-21
- Subcommand alias support - Subcommand alias support
@ -35,7 +37,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
## [3.0.1] - 2022-01-03 ## [3.0.1] - 2022-01-03
<!-- next-url --> <!-- next-url -->
[Unreleased]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.1.4...HEAD [Unreleased]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.1.5...HEAD
[3.1.5]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.1.4...clap_complete_fig-v3.1.5
[3.1.4]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.1.3...clap_complete_fig-v3.1.4 [3.1.4]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.1.3...clap_complete_fig-v3.1.4
[3.1.3]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.1.2...clap_complete_fig-v3.1.3 [3.1.3]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.1.2...clap_complete_fig-v3.1.3
[3.1.2]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.1.1...clap_complete_fig-v3.1.2 [3.1.2]: https://github.com/clap-rs/clap/compare/clap_complete_fig-v3.1.1...clap_complete_fig-v3.1.2

6
clap_complete_fig/Cargo.toml
View file

@ -1,6 +1,6 @@
[package] [package]
name = "clap_complete_fig" name = "clap_complete_fig"
version = "3.1.4" version = "3.1.5"
edition = "2018" edition = "2018"
include = [ include = [
"src/**/*", "src/**/*",
@ -38,8 +38,8 @@ pre-release-replacements = [
bench = false bench = false
[dependencies] [dependencies]
clap = { path = "../", version = "3.1.0", default-features = false, features = ["std"] } clap = { path = "../", version = "3.1.10", default-features = false, features = ["std"] }
clap_complete = { path = "../clap_complete", version = "3.1.0" } clap_complete = { path = "../clap_complete", version = "3.1.2" }
[dev-dependencies] [dev-dependencies]
snapbox = { version = "0.2", features = ["diff"] } snapbox = { version = "0.2", features = ["diff"] }

5
clap_mangen/CHANGELOG.md
View file

@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
<!-- next-header --> <!-- next-header -->
## [Unreleased] - ReleaseDate ## [Unreleased] - ReleaseDate
## [0.1.4] - 2022-04-19
## [0.1.3] - 2022-04-15 ## [0.1.3] - 2022-04-15
- Use value names for positionals - Use value names for positionals
@ -22,7 +24,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
- Expanded the documentation - Expanded the documentation
<!-- next-url --> <!-- next-url -->
[Unreleased]: https://github.com/clap-rs/clap/compare/clap_mangen-v0.1.3...HEAD [Unreleased]: https://github.com/clap-rs/clap/compare/clap_mangen-v0.1.4...HEAD
[0.1.4]: https://github.com/clap-rs/clap/compare/clap_mangen-v0.1.3...clap_mangen-v0.1.4
[0.1.3]: https://github.com/clap-rs/clap/compare/clap_mangen-v0.1.2...clap_mangen-v0.1.3 [0.1.3]: https://github.com/clap-rs/clap/compare/clap_mangen-v0.1.2...clap_mangen-v0.1.3
[0.1.2]: https://github.com/clap-rs/clap/compare/clap_mangen-v0.1.1...clap_mangen-v0.1.2 [0.1.2]: https://github.com/clap-rs/clap/compare/clap_mangen-v0.1.1...clap_mangen-v0.1.2
[0.1.1]: https://github.com/clap-rs/clap/compare/0b045f5d0de9f6c97607be3276f529a14510e94e...clap_mangen-v0.1.1 [0.1.1]: https://github.com/clap-rs/clap/compare/0b045f5d0de9f6c97607be3276f529a14510e94e...clap_mangen-v0.1.1

2
clap_mangen/Cargo.toml
View file

@ -1,6 +1,6 @@
[package] [package]
name = "clap_mangen" name = "clap_mangen"
version = "0.1.3" version = "0.1.4"
edition = "2018" edition = "2018"
include = [ include = [
"src/**/*", "src/**/*",

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/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) [![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.3/LICENSE-APACHE) [![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.4/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.3/LICENSE-MIT) [![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://github.com/clap-rs/clap/blob/clap_mangen-v0.1.4/LICENSE-MIT)
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. [API Reference](https://docs.rs/clap_mangen) 2. [API Reference](https://docs.rs/clap_mangen)
3. [Questions & Discussions](https://github.com/clap-rs/clap/discussions) 3. [Questions & Discussions](https://github.com/clap-rs/clap/discussions)
4. [CONTRIBUTING](https://github.com/clap-rs/clap/blob/clap_mangen-v0.1.3/clap_mangen/CONTRIBUTING.md) 4. [CONTRIBUTING](https://github.com/clap-rs/clap/blob/clap_mangen-v0.1.4/clap_mangen/CONTRIBUTING.md)
5. [Sponsors](https://github.com/clap-rs/clap/blob/clap_mangen-v0.1.3/README.md#sponsors) 5. [Sponsors](https://github.com/clap-rs/clap/blob/clap_mangen-v0.1.4/README.md#sponsors)
## About ## About

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.1.9/examples/derive_ref/README.md) /// [derive reference](https://github.com/clap-rs/clap/blob/v3.1.10/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
@ -306,7 +306,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.1.9/examples/derive_ref/README.md) /// [derive reference](https://github.com/clap-rs/clap/blob/v3.1.10/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
@ -350,7 +350,7 @@ pub trait Args: FromArgMatches + Sized {
/// `Subcommand`. /// `Subcommand`.
/// ///
/// See the /// See the
/// [derive reference](https://github.com/clap-rs/clap/blob/v3.1.9/examples/derive_ref/README.md) /// [derive reference](https://github.com/clap-rs/clap/blob/v3.1.10/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
@ -394,7 +394,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.1.9/examples/derive_ref/README.md) /// [derive reference](https://github.com/clap-rs/clap/blob/v3.1.10/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