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

3696 lines
184 KiB
Markdown
Raw Normal View History

docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
# Change Log
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](http://keepachangelog.com/)
and this project adheres to [Semantic Versioning](http://semver.org/).
docs(changelog): Start v4 section
2022-04-29 13:21:23 +00:00
fix(derive)!: Remove value_parser/action defaulted attributes
2022-07-23 00:36:26 +00:00
## 5.0.0 - Upcoming
### Breaking Changes
- *(derive)* Removed `#[clap(value_parser)]` and `#[clap(action)]` defaulted attributes (its the default) (#3976)
docs(changelog): Start v4 section
2022-04-29 13:21:23 +00:00
## 4.0.0 - Upcoming
fix(error):! Merge EmptyValue into InvalidValue There isn't a reason to programmatically differentiate them so this merges them simplify programamtic cases and to hopefully reduce binary size.
2022-07-22 14:03:28 +00:00
### Breaking Changes
fix(error)!: Merge UnrecognizedSubcommand into InvalidSubcommand Fixes #3676
2022-07-22 17:12:35 +00:00
- `ErrorKind::EmptyValue` replaced with `ErrorKind::InvalidValue`
fix(help)!: Make `DeriveDisplayOrder` the default, removing it Force sorting with `next_display_order(None)` Fixes #2808
2022-07-22 20:43:49 +00:00
- `ErrorKind::UnrecognizedSubcommand` replaced with `ErrorKind::InvalidSubcommand` (#3676)
- `arg!` now sets `ArgAction::SetTrue`, `ArgAction::Count`, `ArgAction::Set`, or `ArgAction::Append` as appropriate (#3795)
fix!: Change default actions to Set/SetTrue This is in prep for removing StoreValue/IncOccurrences
2022-07-22 18:37:18 +00:00
- Default actions are now `Set` and `SetTrue`
fix!: Remove PartialEq from Command This gives us more implementation flexibility
2022-07-25 18:52:13 +00:00
- Removed `PartialEq` and `Eq` from `Command`
fix!: Make ArgAction::Set the default This removes the need for `TakesValue` bookkeeping for when we knew we took values but didn't know how many we should take. Fixes #2687
2022-08-05 18:31:33 +00:00
- By default, an `Arg`s default action is `ArgAction::Set`, rather than `ArgAction::SetTrue`
revert: Add some deprecated placeholders
2022-08-30 21:47:39 +00:00
- Changed `Arg::number_of_values` / `Arg::num_args` from average-across-occurrences to per-occurrence (raw CLI args, not parsed values)
fix!: Rename Arg::number_of_values to Arg::num_args
2022-08-03 16:20:07 +00:00
- `num_args(0)` no longer implies `takes_value(true).multiple_values(true)`
- `num_args(1)` no longer implies `multiple_values(true)`
fix(parser)!: Split on value delimiter after validating num_args This will allow `num_args(0..=1).value_delimiter(',')` to work properly. This hacks in support for `require_value_delimiter` until we can remove it. This no longer recognzes value terminators in delimited lists. It looks like there is a bug with recognizing value terminators in positionals arguments. We'll need to dig into that more.
2022-08-03 22:38:58 +00:00
- Does not check default or env values, only what the user explicitly passes in
- No longer terminates on delimited values
- `Arg::value_terminator` must stand on its own now rather than being in a delimited list
fix(parser)!: Only apply num_args to user values
2022-08-03 19:51:38 +00:00
- Sometimes `Arg::default_missing_value` didn't require `num_args(0..=1)`, now it does
fix!: Rename Arg::number_of_values to Arg::num_args
2022-08-03 16:20:07 +00:00
- Replace `Arg::min_values` (across all occurrences) with `Arg::num_args(N..)` (per occurrence)
- Replace `Arg::max_values` (across all occurrences) with `Arg::num_args(1..=M)` (per occurrence)
- Replace `Arg::multiple_values(true)` with `Arg::num_args(1..)` and `Arg::multiple_values(false)` with `Arg::num_args(0)`
docs: Update references in changelog
2022-08-30 21:34:20 +00:00
- Replace `Arg::takes_value(true)` with `Arg::num_args(1)` and `Arg::takes_value(false)` with `Arg::num_args(0)`
fix!: Remove `Arg::rwquire_value_delimiter` In clap v3, `require_value_delimiter` activated an alternative parse mode where - `multiple_values` meant "multiple values within a single arg" - `number_of_values` having no parse impact, only validation impact - `value_names` being delimited values For unbounded `number_of_values`, this is exactly what `value_delimiter` provides. The only value is if someone wanted `value_name` to be `<file1>,<file2>,...` which can be useful and we might look into adding back in. Alternatively, this could be used for cases like key-value pairs but that has issues like not allowing the delimiter in the value which might be ok in some cases but not others. We already instead document that people should instead use `ValueParser` for this case. In removing this, we remove points of confusion at how the different multiple values and delimited value calls interact with each other. I know I would set `require_value_delimiter(true).multiple_values(true)` when it turns out all I needed was `value_delimiter(',')`. This also reduces the API surface area which makes it easier to discover what features we do provide. While this isn't big, this is also yet another small step towards reducing binary size and compile times.
2022-08-03 19:48:50 +00:00
- Remove `Arg::require_value_delimiter`, either users could use `Arg::value_delimiter` or implement a custom parser with `TypedValueParser`
fix(parser): Rely on `default_missing_value` for flag actions In the short term, this just provides a back door to custom actions. Longer term, we can explore a `SetConst` action that relies on this behavior. Really, `SetTrue` and `SetFalse` are shortcuts for such an action but shortcuts can be helpful for usability. Apparently, this also reduced `.text` size by 1k
2022-07-28 20:41:05 +00:00
- `ArgAction::SetTrue` and `ArgAction::SetFalse` now prioritize `Arg::default_missing_value` over their standard behavior
fix!: Require explicit help/version disabling Before we introduced actions, it required specific setups to engage with claps version and help printing. With actions making that more explicit, we don't get as much benefit from our multiple, obscure, ways of users customizing help Before - Modify existing help or version with `mut_arg` which would automatically be pushed down the command tree like `global(true)` - Create an new help or version and have it treated as if it was the built-in on (I think) - Use the same flags as built-in and have the built-in flags automatically disabled - Users could explicitly disable the built-in functionality and do what they want Now - `mut_arg` no longer works as we define help and version flags at the end - If someone defines a flag that overlaps with the built-ins by id, long, or short, a debug assert will tell them to explicitly disable the built-in - Any customization has to be done by a user providing their own. To propagate through the command tree, they need to set `global(true)`. Benefits - Hopefully, this makes it less confusing on how to override help behavior. Someone creates an arg and we then tell them how to disable the built-in - This greatly simplifies the arg handling by pushing more responsibility onto the developer in what are hopefully just corner cases - This removes about 1Kb from .text Fixes #3405 Fixes #4033
2022-08-08 21:08:47 +00:00
- `mut_arg` can no longer be used to customize help and version arguments, instead disable them (`Command::disable_help_flag`, `Command::disable_version_flag`) and provide your own
- `Arg::new("help")` and `Arg::new("version")` no longer implicitly disable the
built-in flags and be copied to all subcommands, instead disable
the built-in flags (`Command::disable_help_flag`,
`Command::disable_version_flag`) and mark the custom flags as `global(true)`.
fix(parser)!: Store args in a group, rather than values Now that `Id` is public, we can have `ArgMatches` report them. If we have to choose one behavior, this is more universal. The user can still look up the values, this works with groups whose args have different types, and this allows people to make decisions off of it when otherwise there isn't enogh information. Fixes #2317 Fixes #3748
2022-08-11 19:50:58 +00:00
- Looking up a group in `ArgMatches` now returns the arg `Id`s, rather than the values.
fix!: Switch from `&[]` to `IntoIterator` This is a part of #2870 and is prep for #1041 Oddly enough, this dropped the binary size by 200 Bytes Compared to `HEAD~` on `06_rustup`: - build: 6.21us -> 6.23us - parse: 7.55us -> 8.17us - parse_sc: 7.95us -> 7.65us
2022-08-12 17:40:58 +00:00
- Various `Arg`, `Command`, and `ArgGroup` calls were switched from accepting `&[]` to `[]` via `IntoIterator`
fix!: Prefer `IntoIterator` over `&[]` The main breakinge change cases: - `&[char]`: now requires removing `&` - All other non-ID `&[_]`: hopefully #1041 will make these non-breaking Fixes #2870
2022-08-15 18:21:05 +00:00
- `Arg::short_aliases` and other builder functions that took `&[]` need the `&` dropped
fix!: Require/default conditional APIs are more explicit This helps with - API cleanup by not having ambigious `None`, see #950 - Removes ambiguity with `None` when using owned/borrowed types for #1041
2022-08-16 16:52:10 +00:00
- Changed `Arg::requires_ifs` and `Arg::default_value*_ifs*` to taking an `ArgPredicate`, removing ambiguity with `None` when accepting owned and borrowed types
docs: Update changelog
2022-08-23 00:47:05 +00:00
- Removed lifetimes from `Command`, `Arg`, `ArgGroup`, and `PossibleValue`
fix(help)!: Make `DeriveDisplayOrder` the default, removing it Force sorting with `next_display_order(None)` Fixes #2808
2022-07-22 20:43:49 +00:00
- *(help)* Make `DeriveDisplayOrder` the default and removed the setting. To sort help, set `next_display_order(None)` (#2808)
- *(help)* Subcommand display order respects `Command::next_display_order` instead of `DeriveDisplayOrder` and using its own initial display order value (#2808)
docs: Provide workaround for title cased headings
2022-08-31 00:59:42 +00:00
- *(help)* Help headings are now title cased, making any user-provided help headings inconsistent. To get the old behavior, see `Command::help_template`, `Arg::help_heading`, and `Command::subcommand_help_heading`
fix(help): Use Command in place of Subcommand In switching to title case for help headings (#4123), it caused me to look at "subcommand" in a fresh light. I can't quite put my finger on it but "Subcommand" looks a bit sloppy. I also have recently been surveying other CLIs and they just use "command" as well. All of them are commands anyways, just some are children of others (subcommands) while others are not (root or top-level commands, or just command). Context is good enough for clarifying subcommands from root commands. This is part of #4132
2022-08-31 02:38:37 +00:00
- *(help)* "Command" is used as the section heading for subcommands and `COMMAND` for the value name. To get the old behavior, see `Command::subcommand_help_heading` and `Arg::subcommand_value_name`
fix(help)!: Make `DeriveDisplayOrder` the default, removing it Force sorting with `next_display_order(None)` Fixes #2808
2022-07-22 20:43:49 +00:00
- *(env)* Parse `--help` and `--version` like any `ArgAction::SetTrue` flag (#3776)
docs: Note change in derive behavior
2022-07-24 02:24:11 +00:00
- *(derive)* Changed the default for arguments from `parse` to `value_parser`., removing `parse` support
fix(help)!: Make `DeriveDisplayOrder` the default, removing it Force sorting with `next_display_order(None)` Fixes #2808
2022-07-22 20:43:49 +00:00
- *(derive)* `subcommand_required(true).arg_required_else_help(true)` is set instead of `SubcommandRequiredElseHelp` (#3280)
fix(derive): Remove deprecated arg_enum attribute
2022-08-26 18:29:10 +00:00
- *(derive)* Remove `arg_enum` attribute in favor of `value_enum`
fix(derive): Remove structopt attribute support
2022-08-26 21:06:10 +00:00
- *(derive)* Remove `structopt()` attributes in favor of `clap()`
fix(error):! Merge EmptyValue into InvalidValue There isn't a reason to programmatically differentiate them so this merges them simplify programamtic cases and to hopefully reduce binary size.
2022-07-22 14:03:28 +00:00
chore: Bump MSRV to 1.60.0 While at it, this cleans up all of the features. For some reason, I couldn't do `dep:clap_derive` though.
2022-08-11 02:32:04 +00:00
### Compatibility
MSRV is now 1.60.0
fix: Deprecate _os variants PR #4096 made them redundant
2022-08-29 17:42:30 +00:00
Deprecated
revert: Add some deprecated placeholders
2022-08-30 21:47:39 +00:00
- `Arg::use_value_delimiter` in favor of `Arg::value_delimiter`
- `Arg::requires_all` in favor of `Arg::requires_ifs` now that it takes an `ArgPredicate`
- `Arg::number_of_values` in favor of `Arg::num_args`
fix: Deprecate _os variants PR #4096 made them redundant
2022-08-29 17:42:30 +00:00
- `default_value_os`, `default_values_os`, `default_value_if_os`, and `default_value_ifs_os` as the non `_os` variants now accept either a `str` or an `OsStr`
fix(usage): Make `dont_collapse_args_in_usage` the default The setting was added to resolve #769. The reason it was optional is out of concern for applications with a lot of positional arguments. I think those cases are rare enough that we should just push people to override the usage. Positional arguments are generally important enough, even if optional, to show. As a side effect, this fixed some bugs with `dont_collapse_args_in_usage` where it would repeat an argument in a smart usage. As a side effect, smart usage now shows `--` when it should
2022-08-30 14:54:30 +00:00
- `Command::dont_collapse_args_in_usage` is now the default and is deprecated
fix: Deprecate _os variants PR #4096 made them redundant
2022-08-29 17:42:30 +00:00
docs(changelog): Start v4 section
2022-04-29 13:21:23 +00:00
### Features
fix!: Rename Arg::number_of_values to Arg::num_args
2022-08-03 16:20:07 +00:00
- `Arg::num_args` now accepts ranges, allowing setting both the minimum and maximum number of values per occurrence
feat(parser): Make customizeing flags easier While `TypedValueParser` will generally make it easier to reuse value parsers, this was particularly written for flags. Besides having a concrete API to document, an advantage over `fn(&str) -> Result<bool, E>` value parsers is you get all of the benefits of the existing value parsers for environment variable parsing.
2022-08-19 03:07:04 +00:00
- Added `TypedValueParser::map` to make it easier to reuse existing value parsers
perf(error): Allow custmizing formatting For now, there isn't much a custom implementation can do. Going from `Rich` to `Null` drops about 6 KiB from the binary This is a part of #1365 and #1384
2022-08-24 17:26:56 +00:00
- *(error)* `Error::apply` for changing the formatter for dropping binary size
docs(changelog): Start v4 section
2022-04-29 13:21:23 +00:00
- *(help)* Show `PossibleValue::help` in long help (`--help`) (#3312)
docs: Update changelog
2022-05-06 01:55:44 +00:00
### Fixes
docs: Update changelog
2022-05-10 20:28:50 +00:00
- Leading dashes in `Arg::long` are no longer allowed (#3691)
- Verify `required` is not used with conditional required settings (#3660)
fix!: Rename Arg::number_of_values to Arg::num_args
2022-08-03 16:20:07 +00:00
- Disallow more `value_names` than `num_args` (#2695)
fix!: Use value parsers for external subcommands This changes the default type as well to encourage preserving the full information for shelling out. If people need UTF-8, then they can change the value parser. Fixes #3733
2022-07-25 19:16:33 +00:00
- Replaced `cmd.allow_invalid_for_utf8_external_subcommands` with `cmd.external_subcommand_value_parser` (#3733)
- Changed the default type of `allow_external_subcommands` from `String` to `OsString`
fix(parser)!: Apply default_missing_value per occurrence This both simplifies the code and the model we present to the user, making more sense. There is room for further exploration of tying flag actions into this.
2022-07-28 01:23:11 +00:00
- `Arg::default_missing_value` now applies per occurrence rather than if a value is missing across all occurrences
fix: arg!(--long [value]) to per occurrence values Before we did 0..=1 across all occurrences when what we really wanted was 0..=1 per occurrence. This makes it compatible with `ArgAction::Append`.
2022-07-28 02:00:31 +00:00
- `arg!(--long [value])` to accept `0..=1` per occurrence rather than across all occurrences, making it safe to use with `ArgAction::Append`
fix: Allow OsStr for some required_if_eq calls
2022-08-16 15:22:24 +00:00
- Allow `OsStr`s for `Arg::{required_if_eq,required_if_eq_any,required_if_eq_all}`
fix: Allow non-bool value_parsers for SetTrue Not sure if we could have originally made this work but it definitely does now that we use `default_missing_value` for this (#4000)
2022-08-19 02:35:27 +00:00
- Allow non-bool `value_parser`s for `ArgAction::SetTrue` / `ArgAction::SetFalse`
docs: Update changelog
2022-08-23 00:47:05 +00:00
- Can now pass runtime generated data to `Command`, `Arg`, `ArgGroup`, `PossibleValue`, etc without managing lifetimes
docs: Update changelog
2022-06-09 15:47:08 +00:00
- *(assert)* Always enforce that version is specified when the `ArgAction::Version` is used
fix(assert): Add missing track_caller attributes
2022-06-13 12:04:59 +00:00
- *(assert)* Add missing `#[track_caller]`s to make it easier to debug asserts
fix(assert)!: Ensure overrides_with IDs are valid
2022-07-25 17:05:56 +00:00
- *(assert)* Ensure `overrides_with` IDs are valid
fix(assert)!: Disallow self-overrides This will make it easier to drop support for multiple occurrences
2022-07-25 17:33:15 +00:00
- *(assert)* Ensure no self-`overrides_with` now that Actions replace it
fix(assert)!: Prevent repeated subcommand names Fixes #3888
2022-07-25 18:45:33 +00:00
- *(assert)* Ensure subcommand names are not duplicated
docs: Update changelog
2022-05-06 01:55:44 +00:00
- *(help)* Use `Command::display_name` in the help title rather than `Command::bin_name`
fix(help): Show when a flag 'ArgAction::Count's
2022-07-29 14:56:26 +00:00
- *(help)* Show when a flag is `ArgAction::Count` by adding an `...`
fix(help): Use a more neutral palette Fixes #2963
2022-08-25 19:33:03 +00:00
- *(help)* Use a more neutral palette for coloring
fix(help): Don't rely on ALL CAPS for headers I see them fulfilling two roles - A form of bolding - As a callback to their placeholder in usage However, it is a bit of an unpolished look and no other CLI seems to do it. This looks a bit more proefessional. We have colored help for formatting and I think the sections relation to usage will be clear enough.
2022-08-26 14:40:23 +00:00
- *(help)* Don't rely on ALL CAPS for help headers
fix(help): Shift focus to subcommands, when present In surveying various tools and CLI parsers, I noticed they list the subcommands first. This puts an emphasis on them which makes sense because that is most likely what an end user is supposed to pass in next. Listing them last aligns with the usage order but it probably doesn't outweigh the value of getting a user moving forward.
2022-08-26 15:59:27 +00:00
- *(help)* List subcommands first, focusing the emphasis on them
docs: Update changelog
2022-08-27 01:06:46 +00:00
- *(help)* Do not include global args in `cmd help help` (#4131)
docs: Fix link in changelog
2022-08-30 21:32:12 +00:00
- *(help)* Use `[positional]` in list when relevant (#4144)
fix(usage): Make `dont_collapse_args_in_usage` the default The setting was added to resolve #769. The reason it was optional is out of concern for applications with a lot of positional arguments. I think those cases are rare enough that we should just push people to override the usage. Positional arguments are generally important enough, even if optional, to show. As a side effect, this fixed some bugs with `dont_collapse_args_in_usage` where it would repeat an argument in a smart usage. As a side effect, smart usage now shows `--` when it should
2022-08-30 14:54:30 +00:00
- *(help)* Show all `[positional]` in usage
fix(help): Use Command in place of Subcommand In switching to title case for help headings (#4123), it caused me to look at "subcommand" in a fresh light. I can't quite put my finger on it but "Subcommand" looks a bit sloppy. I also have recently been surveying other CLIs and they just use "command" as well. All of them are commands anyways, just some are children of others (subcommands) while others are not (root or top-level commands, or just command). Context is good enough for clarifying subcommands from root commands. This is part of #4132
2022-08-31 02:38:37 +00:00
- *(help)* Polish up subcommands by referring to them as commands
fix!: Use display_name rather than bin_name in version output
2022-07-22 16:40:30 +00:00
- *(version)* Use `Command::display_name` rather than `Command::bin_name`
docs: Update changelog
2022-05-10 20:28:50 +00:00
- *(parser)* Assert on unknown args when using external subcommands (#3703)
- *(parser)* Always fill in `""` argument for external subcommands (#3263)
- *(derive)* Detect escaped external subcommands that look like built-in subcommands (#3703)
- *(derive)* Leave `Arg::id` as `verbatim` casing (#3282)
docs: Update changelog
2022-06-14 11:49:27 +00:00
- *(derive)* Default to `#[clap(value_parser, action)]` instead of `#[clap(parse)]` (#3827)
docs: Update changelog
2022-05-06 01:55:44 +00:00
docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
<!-- next-header -->
## [Unreleased] - ReleaseDate
docs: Forward integrate v3's changelog
2022-08-30 13:54:00 +00:00
## [3.2.18] - 2022-08-29
### Fixes
- *(help)* `Command::print_help` now respects `Command::colored_help`
- *(derive)* Improved error messages
## [3.2.17] - 2022-08-12
### Fixes
- *(derive)* Expose `#[clap(id = ...)]` attribute to match Arg's latest API
docs: Update changelog
2022-07-30 01:55:02 +00:00
## [3.2.16] - 2022-07-30
### Fixes
- Ensure required arguments appear in errors when they are also members of a group (#4004)
## [3.2.15] - 2022-07-25
docs: Update changelog
2022-07-25 18:29:28 +00:00
### Features
- *(derive)* New `default_values_t` and `default_values_os_t` attributes
chore: Release
2022-07-21 01:13:29 +00:00
## [3.2.14] - 2022-07-21
docs: Update changelog
2022-07-21 01:13:20 +00:00
### Fixes
docs: Fix typo in changelog
2022-08-16 18:15:50 +00:00
- A `multiple_values` positional followed by another positional now works with multiple flags
docs: Update changelog
2022-07-21 01:13:20 +00:00
chore: Release
2022-07-19 19:41:47 +00:00
## [3.2.13] - 2022-07-19
docs: Update changelog
2022-07-19 19:39:36 +00:00
### Documentation
- Pulled in tutorials, cookbook, and derive reference into rustdoc
chore: Release
2022-07-14 14:38:54 +00:00
## [3.2.12] - 2022-07-14
docs: Update changelog
2022-07-14 14:38:47 +00:00
### Fixes
- Allow an arg to declare a conflict with a group
chore: Release
2022-07-13 14:08:35 +00:00
## [3.2.11] - 2022-07-13
docs: Update changelog
2022-07-13 14:08:18 +00:00
### Features
- Added `Arg::get_all_short_aliaes` and `Arg::get_all_aliases`
chore: Release
2022-07-12 02:48:07 +00:00
## [3.2.10] - 2022-07-12
docs: Update changelog
2022-07-12 02:46:05 +00:00
### Fixes
- Loosen lifetime on `Command::mut_subcommand`
chore: Release
2022-06-30 13:25:54 +00:00
## [3.2.8] - 2022-06-30
docs: Update changelog
2022-06-30 13:25:46 +00:00
### Features
- Added `Command::mut_subcommand` to mirror `Command::mut_arg`
chore: Release
2022-06-28 13:04:18 +00:00
## [3.2.7] - 2022-06-28
docs: Update changelog
2022-06-28 13:03:17 +00:00
### Fixes
- Global arguments should override env-sourced arguments
chore: Release
2022-06-21 14:32:04 +00:00
## [3.2.6] - 2022-06-21
docs: Update changelog
2022-06-21 14:31:11 +00:00
### Fixes
- Don't panic when parsing `--=`
chore: Release
2022-06-15 16:50:16 +00:00
## [3.2.5] - 2022-06-15
docs: Update changelog
2022-06-15 16:50:02 +00:00
### Fixes
- *(derive)* Fix regression with `#[clap(default_value_os_t ...)]` introduced in v3.2.3
chore: Release
2022-06-14 20:01:42 +00:00
## [3.2.4] - 2022-06-14
docs: Update changelog
2022-06-14 20:01:19 +00:00
### Fixes
- *(derive)* Provide more clearer deprecation messages for `#[clap(parse)]` attribute (#3832)
chore: Release
2022-06-14 16:19:59 +00:00
## [3.2.3] - 2022-06-14
docs: Update changelog
2022-06-14 16:19:23 +00:00
### Fixes
- Moved deprecations to be behind the `deprecated` Cargo.toml feature (#3830)
- For now, it is disabled by default though we are considering enabling it by
default as we release the next major version to help draw attention to the
deprecation migration path
chore: Release
2022-06-14 12:02:40 +00:00
## [3.2.2] - 2022-06-14
docs: Update changelog
2022-06-14 11:49:27 +00:00
### Fixes
- *(derive)* Improve the highlighted code for deprecation warnings
**gated behind `unstable-v4`**
- *(derive)* Default to `#[clap(value_parser, action)]` instead of `#[clap(parse)]` (#3827)
chore: Release
2022-06-13 14:37:47 +00:00
## [3.2.1] - 2022-06-13
chore: Release
2022-06-13 14:31:29 +00:00
## [3.2.0] - 2022-06-13
docs: Update changelog
2022-06-08 16:32:52 +00:00
### Compatibility
MSRV is now 1.56.0 (#3732)
Behavior
- Defaults no longer satisfy `required` and its variants (#3793)
docs(change): Note debug/release assert change
2022-06-14 13:48:36 +00:00
- When misusing `ArgMatches::value_of` and friends, debug asserts were turned into panics
docs: Update changelog
2022-06-08 16:32:52 +00:00
Moving (old location deprecated)
- `clap::{PossibleValue, ValueHint}` to `clap::builder::{PossibleValue, ValueHint}`
- `clap::{Indices, OsValues, ValueSource, Values}` to `clap::parser::{Indices, OsValues, ValueSource, Values}`
- `clap::ArgEnum` to `clap::ValueEnum` (#3799)
Replaced
- `Arg::allow_invalid_utf8` with `Arg::value_parser(value_parser!(PathBuf))` (#3753)
- `Arg::validator` / `Arg::validator_os` with `Arg::value_parser` (#3753)
- `Arg::validator_regex` with users providing their own `builder::TypedValueParser` (#3756)
- `Arg::forbid_empty_values` with `builder::NonEmptyStringValueParser` / `builder::PathBufValueParser` (#3753)
- `Arg::possible_values` with `Arg::value_parser([...])`, `builder::PossibleValuesParser`, or `builder::EnumValueParser` (#3753)
perf(parser): Take up less memory with ArgAction::Count Someone should not reasonably expect a coun flag to go up to billions, millions, or even thousands. 255 should be sufficient for anyone, right? The original type was selected to be consistent with `ArgMatches::occurrences_of` but that is also used for tracking how many values appear which can be large with `xargs`. I'm still conflicted on what the "right type" is an wish we could support any numeric type. When I did a search on github though, every case was for debug/quiet flags and only supported 2-3 occurrences, making a `u8` overkill. This came out of a discussion on #3792
2022-06-09 16:09:36 +00:00
- `Arg::max_occurrences` with `arg.action(ArgAction::Count).value_parser(value_parser!(u8).range(..N))` for flags (#3797)
docs: Update changelog
2022-06-08 16:32:52 +00:00
- `Arg::multiple_occurrences` with `ArgAction::Append` or `ArgAction::Count` though positionals will need `Arg::multiple_values` (#3772, #3797)
- `Command::args_override_self` with `ArgAction::Set` (#2627, #3797)
- `AppSettings::NoAutoVersion` with `ArgAction` or `Command::disable_version_flag` (#3800)
- `AppSettings::NoHelpVersion` with `ArgAction` or `Command::disable_help_flag` / `Command::disable_help_subcommand` (#3800)
- `ArgMatches::{value_of, value_of_os, value_of_os_lossy, value_of_t}` with `ArgMatches::{get_one,remove_one}` (#3753)
- `ArgMatches::{values_of, values_of_os, values_of_os_lossy, values_of_t}` with `ArgMatches::{get_many,remove_many}` (#3753)
- `ArgMatches::is_valid_arg` with `ArgMatches::{try_get_one,try_get_many}` (#3753)
- `ArgMatches::occurrences_of` with `ArgMatches::value_source` or `ArgAction::Count` (#3797)
fix(parser): Deprecate ArgMatches::is_present
2022-06-10 01:03:28 +00:00
- `ArgMatches::is_present` with `ArgMatches::contains_id` or `ArgAction::SetTrue` (#3797)
docs: Update changelog
2022-06-08 16:32:52 +00:00
- `ArgAction::StoreValue` with `ArgAction::Set` or `ArgAction::Append` (#3797)
- `ArgAction::IncOccurrences` with `ArgAction::SetTrue` or `ArgAction::Count` (#3797)
docs: Go into more details on derive deprecation
2022-06-14 12:01:42 +00:00
- *(derive)* `#[clap(parse(...))]` replaced with: (#3589, #3794)
- For default parsers (no `parse` attribute), deprecation warnings can be
silenced by opting into the new behavior by adding either `#[clap(action)]`
or `#[clap(value_parser)]` (ie requesting the default behavior for these
attributes). Alternatively, the `unstable-v4` feature changes the default
away from `parse` to `action`/`value_parser`.
- For `#[clap(parse(from_flag))]` replaced with `#[clap(action = ArgAction::SetTrue)]` (#3794)
- For `#[clap(parse(from_occurrences))]` replaced with `#[clap(action = ArgAction::Count)]` though the field's type must be `u8` (#3794)
- For `#[clap(parse(from_os_str)]` for `PathBuf`, replace it with
`#[clap(value_parser)]` (as mentioned earlier this will call
`value_parser!(PathBuf)` which will auto-select the right `ValueParser`
automatically).
- For `#[clap(parse(try_from_str = ...)]`, replace it with `#[clap(value_parser = ...)]`
- For most other cases, a type implementing `TypedValueParser` will be needed and specify it with `#[clap(value_parser = ...)]`
docs: Update changelog
2022-06-08 16:32:52 +00:00
docs: Put compatibility first in changelog
2022-06-14 13:47:10 +00:00
### Features
- Parsed, typed arguments via `Arg::value_parser` / `ArgMatches::{get_one,get_many}` (#2683, #3732)
- Several built-in `TypedValueParser`s available with an API open for expansion
- `value_parser!(T)` macro for selecting a parser for a given type (#3732) and open to expansion via the `ValueParserFactory` trait (#3755)
- `[&str]` is implicitly a value parser for possible values
- All `ArgMatches` getters do not assume required arguments (#2505)
- Add `ArgMatches::remove_*` variants to transfer ownership
- Add `ArgMatches::try_*` variants to avoid panics for developer errors (#3621)
- Add a `get_raw` to access the underlying `OsStr`s
- `PathBuf` value parsers imply `ValueHint::AnyPath` for completions (#3732)
- Explicit control over parsing via `Arg::action` (#3774)
- `ArgAction::StoreValue`: existing `takes_value(true)` behavior
- `ArgAction::IncOccurrences`: existing `takes_value(false)` behavior
- `ArgAction::Help`: existing `--help` behavior
- `ArgAction::Version`: existing `--version` behavior
- `ArgAction::Set`: Overwrite existing values (like `Arg::multiple_occurrences` mixed with `Command::args_override_self`) (#3777)
- `ArgAction::Append`: like `Arg::multiple_occurrences` (#3777)
- `ArgAction::SetTrue`: Treat `--flag` as `--flag=true` (#3775)
- Implies `Arg::default_value("false")` (#3786)
- Parses `Arg::env` via `Arg::value_parser`
- `ArgAction::SetFalse`: Treat `--flag` as `--flag=false` (#3775)
- Implies `Arg::default_value("true")` (#3786)
- Parses `Arg::env` via `Arg::value_parser`
- `ArgAction::Count`: Treat `--flag --flag --flag` as `--flag=1 --flag=2 --flag=3` (#3775)
- Implies `Arg::default_value("0")` (#3786)
- Parses `Arg::env` via `Arg::value_parser`
- *(derive)* Opt-in to new `Arg::value_parser` / `Arg::action` with either `#[clap(value_parser)]` (#3589, #3742) / `#[clap(action)]` attributes (#3794)
- Default `ValueParser` is determined by `value_parser!` (#3199, #3496)
- Default `ArgAction` is determine by a hard-coded lookup on the type (#3794)
- `Command::multicall` is now stable for busybox-like programs and REPLs (#2861, #3684)
- `ArgMatches::{try_,}contains_id` for checking if there are values for an argument that mirrors the new `get_{one,many}` API
### Fixes
- Don't correct argument id in `default_value_ifs_os`(#3815)
*parser*
- Set `ArgMatches::value_source` and `ArgMatches::occurrences_of` for external subcommands (#3732)
- Use value delimiter for `Arg::default_missing_values` (#3761, #3765)
- Split`Arg::default_value` / `Arg::env` on value delimiters independent of whether `--` was used (#3765)
- Allow applying defaults to flags (#3294, 3775)
- Defaults no longer satisfy `required` and its variants (#3793)
chore: Release
2022-05-10 20:29:16 +00:00
## [3.1.18] - 2022-05-10
docs: Update changelog
2022-05-10 20:28:50 +00:00
### Fixes
- Fix deprecated `arg_enum!` for users migrating to clap3 (#3717)
- Verify all `required_unless_present_all` arguments exist
- Verify group members exist before processing group members (#3711)
- *(help)* Use `...` when not enough `value_names` are supplied
**gated behind `unstable-v4`**
- Verify `required` is not used with conditional required settings (#3660)
- Disallow more `value_names` than `number_of_values` (#2695)
- *(parser)* Assert on unknown args when using external subcommands (#3703)
- *(parser)* Always fill in `""` argument for external subcommands (#3263)
- *(derive)* Detect escaped external subcommands that look like built-in subcommands (#3703)
- *(derive)* Leave `Arg::id` as `verbatim` casing (#3282)
chore: Release
2022-05-06 16:57:48 +00:00
## [3.1.17] - 2022-05-06
docs: Update changelog
2022-05-06 16:57:39 +00:00
### Fixes
- Allow value names for `arg!` macro to have dashes when quoted, like longs
chore: Release
2022-05-06 02:04:09 +00:00
## [3.1.16] - 2022-05-06
docs: Update changelog
2022-05-06 01:55:44 +00:00
### Fixes
- *(parser)* `Arg::exclusive` overrides `Arg::required`, like other conflicts
- *(error)* Don't duplicate arguments in usage
- *(error)* Don't show hidden arguments in conflict error usage
- *(help)* New `help_template` variable `{name}` to fix problems with `{bin}`
- *(help)* Don't wrap URLs
**gated behind `unstable-v4`**
- Leading dashes in `Arg::long` are no longer allowed
- *(help)* Use `Command::display_name` in the help title rather than `Command::bin_name`
chore: Release
2022-05-02 18:02:10 +00:00
## [3.1.15] - 2022-05-02
docs: Update chaneglog
2022-05-02 18:02:03 +00:00
### Fixes
- *(error)* Render actual usage for unrecognized subcommands
- *(multicall)* Improve bad command error
- *(multicall)* Always require a multicall command
- *(multicall)* Disallow arguments on multicall parent command
- *(multicall)* More consistent with rest of clap errors
chore: Release
2022-05-01 01:21:33 +00:00
## [3.1.14] - 2022-05-01
docs: Update chaneglog
2022-05-01 01:21:22 +00:00
### Fixes
- Panic when calling `Command::build` with a required positional argument nested several layers in subcommands
chore: Release
2022-04-30 11:36:33 +00:00
## [3.1.13] - 2022-04-30
docs: Update changelog
2022-04-30 11:35:38 +00:00
### Fixes
- Help subcommand and `Command::write_help` now report required arguments in usage in more circumstances
- Unknown subcommand for help subcommand flag now reports an error with more context
- More details reported when using `debug` feature
- Allow disabling `color` feature with `debug` feature enabled
chore: Release
2022-04-22 11:52:05 +00:00
## [3.1.12] - 2022-04-22
docs: Update changelog
2022-04-22 11:51:59 +00:00
### Fixes
- Regression in 3.1.11 where the (output) streams were crossed
chore: Release
2022-04-22 01:08:49 +00:00
## [3.1.11] - 2022-04-22
docs: Update changelog
2022-04-22 01:08:35 +00:00
### Fixes
- Implied conflicts override `Arg::required`, making the behavior consistent with how we calculate conflicts for error reporting
- Members of a mutually exclusive `ArgGroup` override `Arg::required`, making the behavior consistent with how we calculate conflicts for error reporting
- `Arg::overrides_with` always override `Arg::required`, not just when the parser processes an override
chore: Release
2022-04-19 15:31:52 +00:00
## [3.1.10] - 2022-04-19
docs: Update changelog
2022-04-22 01:08:35 +00:00
### Features
docs: Update changelog
2022-04-19 15:28:28 +00:00
- Expose `Command::build` for custom help generation or other command introspection needs
chore: Release
2022-04-15 19:39:14 +00:00
## [3.1.9] - 2022-04-15
docs: Update changelog
2022-04-15 19:38:58 +00:00
### Fixes
- Pin the `clap_derive` version so a compatible version is always used with `clap`
chore: Release
2022-04-01 14:15:32 +00:00
## [3.1.8] - 2022-04-01
docs: Update changelog
2022-04-01 14:15:18 +00:00
### Fixes
- Add `Debug` impls to more types
chore: Release
2022-03-31 17:22:40 +00:00
## [3.1.7] - 2022-03-31
docs: Update changelog
2022-03-31 17:22:13 +00:00
### Fixes
docs: Remove unnecessary backtick in changelog
2022-04-08 04:23:24 +00:00
- *(derive)* Abort, rather than ignore, when deriving `ArgEnum` with non-unit unskipped variants
docs: Update changelog
2022-03-31 17:22:13 +00:00
chore: Release
2022-03-07 16:40:48 +00:00
## [3.1.6] - 2022-03-07
docs: Update changelog
2022-03-07 16:40:30 +00:00
### Fixes
- Don't panic when validating delimited defaults (#3541)
- Make it clearer that `cargo` feature is needed
- Documentation improvements
chore: Release
2022-03-02 15:49:11 +00:00
## [3.1.5] - 2022-03-02
docs: Update changelog
2022-03-02 15:49:04 +00:00
### Fixes
- Dependency upgrade
chore: Release
2022-03-02 15:20:00 +00:00
## [3.1.4] - 2022-03-02
docs: Update changelog
2022-03-02 15:19:04 +00:00
### Features
- *(help)* Show `PossibleValue::help` in long help (`--help`) **(gated behind `unstable-v4`)** (#3312)
chore: Release
2022-02-28 16:03:45 +00:00
## [3.1.3] - 2022-02-28
docs: Update changelog
2022-02-28 16:03:30 +00:00
### Fixes
- Don't panic when validating delimited defaults (#3514)
chore: Release
2022-02-23 15:39:40 +00:00
## [3.1.2] - 2022-02-23
docs: Update changelog
2022-02-23 15:38:44 +00:00
### Fixes
- *(derive)* Allow other attribute with a subcommand that has subcommands
### Documentation
- *(examples)* List example topics
- *(derive)* Clarify syntax and relation to builder API
chore: Release
2022-02-21 13:50:28 +00:00
## [3.1.1] - 2022-02-21
docs: Update changelog
2022-02-21 13:50:20 +00:00
### Fixes
- Track caller for `ArgMatches` assertions so the user more easily sees where they need to fix the call
chore: Release
2022-02-16 17:59:45 +00:00
## [3.1.0] - 2022-02-16
docs: Update changelogs
2022-02-15 16:49:00 +00:00
### Compatibility
Changes in behavior of note that are not guaranteed to be compatible across releases:
- *(help)* `help` subcommand shows long help like `--help`, rather than short help (`-h`), deprecated `clap::AppSettings::UseLongFormatForHelpSubcommand` (#3440)
- *(help)* Pacman-style subcommands are now ordered the same as usage errors (#3470)
- *(help)* Pacman-style subcommands use standard alternate syntax in usage (#3470)
### Deprecations
- `clap::Command` is now preferred over `clap::App` (#3089 in #3472)
- `clap::command!` is now preferred over `clap::app_from_crate` (#3089 in #3474)
- `clap::CommandFactory::command` is now preferred over `clap::IntoApp::into_app` (#3089 in #3473)
- *(help)* `help` subcommand shows long help like `--help`, rather than short help (`-h`), deprecated `clap::AppSettings::UseLongFormatForHelpSubcommand` (#3440)
- *(error)* Deprecate `clap::AppSettings::WaitOnError`, leaving it to the user to implement
- *(validation)* `clap::Command::subcommand_required(true).arg_required_else_help(true)` is now preferred over `clap::AppSettings::SubcommandRequiredElseHelp` (#3280)
- *(builder)* `clap::AppSettings` are nearly all deprecated and replaced with builder methods and getters (#2717)
docs(changelog): Add missing deprecation
2022-02-15 17:28:59 +00:00
- *(builder)* `clap::ArgSettings` is deprecated and replaced with builder methods and getters (#2717)
docs: Update changelogs
2022-02-15 16:49:00 +00:00
- *(builder)* `clap::Arg::id` and `clap::ArgGroup::id` are now preferred over `clap::Arg::name` and `clap::ArgGroup::name` (#3335)
- *(help)* `clap::Command::next_help_heading` is now preferred over `clap::Command::help_heading` (#1807, #1553)
- *(error)* `clap::error::ErrorKind` is now preferred over `clap::ErrorKind` (#3395)
- *(error)* `clap::Error::kind()` is now preferred over `clap::Error::kind`
- *(error)* `clap::Error::context()` is now preferred over `clap::Error::info` (#2628)
Note: All items deprecated in 3.0.0 are now hidden in the documentation. (#3458)
### Features
- *(matches)* Add `clap::ArgMatches::value_source` to determine what insert the value (#1345)
- *(help)* Override derived display order with `clap::Command::next_display_order` (#1807)
- *(error)* Show possible values when an argument doesn't have a value (#3320)
- *(error)* New `clap::Error::context` API to open the door for fully-custom error messages (#2628)
- *(error)* `clap::error::ErrorKind` now implements `Display`
### Fixes
- *(builder)* Some functions were renamed for consistency and fixing spelling issues
- *(builder)* Allow `clap::Command::color` to override previous calls (#3449)
- *(parse)* Propagate globals with multiple subcommands (#3428)
- *(validation)* Give `ArgRequiredElseHelp` precedence over `SubcommandRequired` (#3456)
- *(validation)* Default values no longer count as "present" for conflicts, requires, `clap::Command::arg_required_else_help`, etc (#3076, #1264)
- *(assert)* Report invalid defaults (#3202)
- *(help)* Clarify how to handle `-h` conflicts (#3403)
- *(help)* Make it easier to debug the addition of help flags (#3425)
- *(help)* Pacman-style subcommands are now separated with spaces (#3470)
- *(help)* Pacman-style subcommands are now ordered the same as usage errors (#3470)
- *(help)* Pacman-style subcommands use standard alternate syntax in usage (#3470)
- *(error)* Be consistent in showing of required attributes between errors / usage (#3390)
- *(error)* Show user's order of possible values, like in `--help` (#1549)
- *(error)* Allow customizing error type in `clap::error::Result` (#3395)
### Performance
- *(error)* Reduced stack size of `clap::Error` (#3395)
### Documentation
- *(builder)* Correct data take accepted for `clap::Arg::validator`
- *(derive)* Clarify `parse` attribute
- *(tutorial)* Demonstrate custom parsing
- *(example)* Consistently list out required feature flags (#3448)
chore: Release
2022-02-01 22:11:53 +00:00
## [3.0.14] - 2022-02-01
docs: Update changelog
2022-02-01 22:10:44 +00:00
### Features
- Added `ArgMatches::args_present()` to check if any args are present
- Added `Error::kind()` as we work to deprecate direct member access for `Error`
- Added `App::get_version`
- Added `App::get_long_version`
- Added `App::get_author`
- Added `App::get_subcommand_help_heading`
- Added `App::get_subcommand_value_name`
- Added `App::get_after_help`
- Added `App::get_after_long_help`
### Performance
- Misc binary size reductions
chore: Release
2022-01-26 21:54:12 +00:00
## [3.0.13] - 2022-01-26
docs: Update changelog
2022-01-26 21:53:25 +00:00
### Fixes
- Show optional flag values wrapped in `[]`
chore: Release
2022-01-24 21:34:27 +00:00
## [3.0.12] - 2022-01-24
docs: Update changelog
2022-01-24 21:33:12 +00:00
### Features
- *(derive)* Support for `default_value_os_t`
chore: Release
2022-01-24 16:54:50 +00:00
## [3.0.11] - 2022-01-24
docs: Update changelog
2022-01-24 16:54:04 +00:00
### Fixes
- Ensure conflicts work when they target a group with a default value
chore: Release
2022-01-18 20:59:58 +00:00
## [3.0.10] - 2022-01-18
docs: Update changelog
2022-01-18 20:59:48 +00:00
### Fixes
- Resolve `panic!` from v3.0.8 when using `global_setting(PropagateVersion)`.
chore: Release
2022-01-18 02:34:09 +00:00
## [3.0.9] - 2022-01-17
docs: Update changelog
2022-01-18 02:33:52 +00:00
### Features
- Added `App::find_subcommand_mut`
chore: Release
2022-01-17 15:37:45 +00:00
## [3.0.8] - 2022-01-17
docs: Update changelog
2022-01-17 15:37:22 +00:00
### Fixes
- Respected `DisableColoredHelp` on `cmd help help`
- Provide a little more context when completing arguments for `cmd help`
- Provide more context for some asserts
- Small documentation improvements
chore: Release
2022-01-12 17:12:42 +00:00
## [3.0.7] - 2022-01-12
docs: Update changelogs
2022-01-12 17:11:53 +00:00
### Fixes
- Shift more asserts from parsing to `App` building (ie will now run in `App::debug_assert`)
**derive**
- Documentation fixes
chore: Release
2022-01-10 22:16:18 +00:00
## [3.0.6] - 2022-01-10
docs: Update changelog
2022-01-10 22:13:50 +00:00
### Fixes
**derive**
- Don't assume user does `use clap::ArgEnum` (#3277)
- Documentation fixes
chore: Release
2022-01-05 22:28:24 +00:00
## [3.0.5] - 2022-01-05
docs: Update changelog
2022-01-05 22:27:11 +00:00
### Fixes
- Provide hack to workaround [inability to detect external subcommands aliasing when escaped](https://github.com/clap-rs/clap/issues/3263) (#3264)
**docs:**
- Cleaned up code blocks in tutorials (#3261)
- Clean up quotes in `ArgMatches` asserts
- List correct replacement for deprecated `Parser::from_clap` (#3257)
chore: Release
2022-01-04 19:07:10 +00:00
## [3.0.4] - 2022-01-04
docs: Update changelog
2022-01-04 19:07:01 +00:00
### Features
- For very limited cases, like `cargo`, expose `ArgMatches::is_valid_arg` to avoid panicing on undefined arguments
chore: Release
2022-01-04 17:42:50 +00:00
## [3.0.3] - 2022-01-04
docs: Update changelog
2022-01-04 17:42:35 +00:00
### Fixes
- Specify cause of debug assert failure
chore: Release
2022-01-04 15:49:41 +00:00
## [3.0.2] - 2022-01-04
docs: Update changeog
2022-01-04 15:48:50 +00:00
### Fixes
- Ignore `Last` when checking hyphen values (see #3249 for details)
- Help catch bugs with `#[must_use]`
chore: Release
2022-01-03 18:12:28 +00:00
## [3.0.1] - 2022-01-03
docs: Update changelog
2022-01-03 18:11:11 +00:00
### Fixes
- Don't panic when getting number of values (#3241)
- Don't warn when using `default_value_t` derive attribute with a `Subcommand` (#3245)
Documentation
- Added `name` attribute to `ArgEnum` variant derive reference
chore: Release
2021-12-31 20:34:55 +00:00
## [3.0.0] - 2021-12-31
docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
**Note:** clap v3 has been in development for several years and has changed
hands multiple times. Unfortunately, our changelog might be incomplete,
whether in changes or their motivation.
doc: Call out release highlights
2021-12-04 02:44:50 +00:00
### Highlights
docs: Add special note
2021-12-08 17:21:47 +00:00
A special thanks to the maintainers, contributors, beta users, and sponsors who
have helped along this journey, especially kbknapp.
doc: Call out release highlights
2021-12-04 02:44:50 +00:00
**[StructOpt](https://docs.rs/structopt/) Integration**
[StructOpt](https://docs.rs/structopt/) provides a serde-like declarative
approach to defining your parser. The main benefits we've seen so far from integrating are:
- Tighter feedback between the design of clap and the derives
- More universal traits. Crates exist for common CLI patterns
([example](https://github.com/rust-cli/clap-verbosity-flag))
and we've re-designed the `StructOpt` traits so crates built on clap3 can be
reused not just with other derives but also people using the builder API.
People can even hand implement these so people using the builder API won't
have the pay the cost for derives.
**Custom Help Headings**
Previously, clap automatically grouped arguments in the help as either
`ARGS`, `FLAGS`, `OPTIONS`, and `SUBCOMMANDS`.
You can now override the default group with `Arg::help_heading` and
`App::subcommand_help_heading`. To apply a heading to a series of arguments,
you can set `App::help_heading`.
docs: Clarify deprecations
2021-12-08 17:11:26 +00:00
**Deprecations**
While a lot of deprecations have been added to clean up the API (overloaded
meaning of `Arg::multiple`) or make things more consistent, some particular
highlights are:
- `clap_app!` has been deprecated in favor of the builder API with `arg!` ([clap-rs/clap#2835](https://github.com/clap-rs/clap/issues/2835))
- `Arg::from_usage` has been deprecated in favor of `arg!` ([clap-rs/clap#3087](https://github.com/clap-rs/clap/issues/3087))
- [Porting example](https://github.com/clap-rs/clap/commit/4c4a2b86a08ef9e2d63010aab4909dd5a013dfb0)
- The YAML API has been deprecated in favor the builder or derive APIs ([clap-rs/clap#3087](https://github.com/clap-rs/clap/issues/3087))
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
### Migrating
**From clap v2**
docs: Encourage CLI testing
2021-12-06 20:58:56 +00:00
1. Add CLI tests, `-h` and `--help` output at a minimum (recommendation: [trycmd](https://docs.rs/trycmd/) for snapshot testing)
2. Update your dependency
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
1. *If you use `no-default-features`:* add the `std` feature
docs: Encourage CLI testing
2021-12-06 20:58:56 +00:00
3. Resolve compiler errors
4. Resolve behavior changes
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
1. Refactor your `App` creation to a function and add a test similar to the one below, resolving any of its assertions
2. Look over the "subtle changes" under BREAKING CHANGES
3. *If using builder:* test your application under various circumstances to see if `ArgMatches` asserts regarding `AllowInvalidUtf8`.
docs: Encourage CLI testing
2021-12-06 20:58:56 +00:00
5. *At your leisure:* resolve deprecation notices
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
Example test:
```rust
docs: Fix example test code
2021-12-06 20:56:45 +00:00
fn app() -> clap::App<'static> {
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
...
}
#[test]
fn verify_app() {
docs(tutorial): Encourage `App::debug_assert`
2021-12-23 14:41:52 +00:00
app().debug_assert();
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
}
```
**From structopt 0.3.25**
docs(faq): Raise visibility of migration guide Part of #3422
2022-02-08 23:31:12 +00:00
<a name="migrate-structopt"></a>
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
docs: Encourage CLI testing
2021-12-06 20:58:56 +00:00
1. Add CLI tests, `-h` and `--help` output at a minimum (recommendation: [trycmd](https://docs.rs/trycmd/) for snapshot testing)
Fix CHANGELOG for structopt migration
2022-02-17 10:18:15 +00:00
2. Replace your dependency from `structopt = "..."` to `clap = { version = "3.0", features = ["derive"] }`
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
1. *If you use `no-default-features`:* add the `std` feature
docs: Encourage CLI testing
2021-12-06 20:58:56 +00:00
3. Resolve compiler errors, including
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
1. Update your `use` statements from `structopt` and `structopt::clap` to `clap`
docs: Encourage CLI testing
2021-12-06 20:58:56 +00:00
4. Resolve behavior changes
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
1. Add a test similar to the one below, resolving any of its assertions
2. Look over the "subtle changes" under BREAKING CHANGES
docs: Encourage CLI testing
2021-12-06 20:58:56 +00:00
5. *At your leisure:* resolve deprecation notices
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
Example test:
```rust
#[derive(clap::StructOpt)]
struct Args {
...
}
#[test]
fn verify_app() {
use clap::IntoApp;
Args::into_app().debug_assert()
}
```
**From clap v3.0.0-beta.5**
docs: Encourage CLI testing
2021-12-06 20:58:56 +00:00
1. Add CLI tests, `-h` and `--help` output at a minimum (recommendation: [trycmd](https://docs.rs/trycmd/) for snapshot testing)
2. Update your dependency
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
1. Add in `derive`, `env`, `cargo`, or `unicode` feature flags as needed
docs: Encourage CLI testing
2021-12-06 20:58:56 +00:00
3. Resolve compiler errors
docs(change): Fix formatting
2021-12-09 03:01:41 +00:00
1. *If you use `yaml`, `clap_app!`, or usage parser:* revert any changes you made for clap3
docs(change): Update link
2021-12-09 03:03:27 +00:00
2. Change `Arg::about` `Arg::long_about` back to `help` and `long_help` and change `PossibleValue::about` to `help` ([clap-rs/clap#3075](https://github.com/clap-rs/clap/issues/3075))
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
3. Change `AppSettings::HelpRequired` to `AppSettings::HelpExpected`
4. Change `PossibleValue::hidden` to `PossibleValue::hide`
5. Change `App::subcommand_placeholder` to `App::subcommand_value_name` / `App::subcommand_help_heading`
docs: Encourage CLI testing
2021-12-06 20:58:56 +00:00
4. Resolve behavior changes
docs(change): Fix formatting
2021-12-09 03:01:41 +00:00
1. Add the above listed test appropriate for your application and resolve any problems it reports
2. *If using `derive`:* see the structopt breaking changes section for `Vec` changes
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
3. *If using builder:* test your application under various circumstances to see if `ArgMatches` asserts regarding `AllowInvalidUtf8`.
docs: Encourage CLI testing
2021-12-06 20:58:56 +00:00
5. *At your leisure:* resolve deprecation notices
doc: Write up migration guide
2021-12-04 02:44:37 +00:00
docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
### BREAKING CHANGES
**From clap 2**
Subtle changes (i.e. compiler won't catch):
- `AppSettings::UnifiedHelpMessage` is now default behaviour
- `{flags}` and `{unified}` will assert if present in `App::help_template`
- See [clap-rs/clap#2807](https://github.com/clap-rs/clap/issues/2807)
docs: Update changelog
2021-12-04 18:01:31 +00:00
- `AppSettings::EnableColoredHelp` is now the default behavior but can be
opted-out with `AppSettings::DisableColoredHelp`
([clap-rs/clap#2806](https://github.com/clap-rs/clap/issues/2806))
docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
- `App::override_usage` no longer implies a leading `\t`, allowing multi lined usages
- `Arg::require_equals` no longer implies `ArgSettings::ForbidEmptyValues` ([#2233](https://github.com/clap-rs/clap/issues/2233))
- `Arg::require_delimiter` no longer implies `ArgSettings::TakesValue` and `ArgSettings::UseValueDelimiter` ([#2233](https://github.com/clap-rs/clap/issues/2233))
- `Arg::env`, `Arg::env_os`, `Arg::last`, `Arg::require_equals`, `Arg::allow_hyphen_values`,
`Arg::hide_possible_values`, `Arg::hide_default_value`, `Arg::hide_env_values`,
`Arg::case_insensitive` and `Arg::multiple_values` no longer imply `ArgSettings::TakesValue` ([#2233](https://github.com/clap-rs/clap/issues/2233))
docs(changelog): Fix typo
2021-12-23 22:07:29 +00:00
- `ArgMatches::is_present` no longer checks subcommand names
docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
- Some env variable values are now considered false for flags, not just "not-present" ([clap-rs/clap#2539](https://github.com/clap-rs/clap/issues/2539))
- Changed `...`s meaning in usage parser. Before, it always meant `multiple` which is still true for `--option [val]...`. Now `[name]... --option [val]` results in `ArgSettings::MultipleOccurrences`.
docs(changelog): Call out more breaking changes
2022-01-05 16:28:42 +00:00
- Usage exit code changed from `1` to `2` ([clap-rs/clap#1327](https://github.com/clap-rs/clap/issues/1327))
- Reject `--foo=bar` when `takes_value(false)` ([clap-rs/clap#1543](https://github.com/clap-rs/clap/issues/1543))
docs: Note case in #3309
2022-01-18 16:30:51 +00:00
- No longer accept an arbitrary number of `-` for long arguments (`-----long`)
docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
Easier to catch changes:
- When using `no-default-features`, you now have to specify the `std` feature (reserved for future work)
- Gated env support behind `env` feature flag
- Impacts `Arg::env`, `Arg::env_os`, `Arg::hide_env_values`, `ArgSettings::HideEnvValues`
- See [clap-rs/clap#2694](https://github.com/clap-rs/clap/pull/2694)
- Gated crate information behind `cargo` feature flag
- Impacts `crate_name!`, `crate_version!`, `crate_authors!`, `crate_description!`, `app_from_crate!`
- `AppSettings::StrictUtf8` is now default behaviour and asserts if
`AppSettings::AllowInvalidUtf8ForExternalSubcommands` and
`ArgSettings::AllowInvalidUtf8` and `ArgMatches::value_of_os` aren't used
together
- `AppSettings::AllowInvalidUtf8` has been removed
- [clap-rs/clap#751](https://github.com/clap-rs/clap/issues/751)
- `Arg::short` and `Arg::value_delimiter` now take a `char` instead of a `&str`
- `ArgMatches` panics on unknown arguments
- Removed `VersionlessSubcommands`, making it the default (see [clap-rs/clap#2812](https://github.com/clap-rs/clap/issues/2812))
fix(complete): Give crates more specific names `clap_generate` originally intended to be "generate anything". With `fig`, we already broke one part out. With #3174's man support, we are also looking at keeping it separate: - More freedom to iterate on the API - Uniqueness (and potential weight) of its dependencies - man generation is normally more for distribution while completions are a mix of being distributed with the app or the app generating the completions (which will be exacerbated if we move most completion parsing logic to be in Rust) So `clap_generate` is having a lot more limited of a role than the original name conveys. I worry the generic name will be a hindrance to people discovering and using it (yes, documentation can help but there are limits). I hesitated because we are on the verge of releasing 3.0. However, doing it even later will be even more disruptive because more people will be using it (crates.io lists ~70 people using `clap_generate`). To ease things, we are still releasing `clap_generate` as a wrapper around `clap_complete`.
2021-12-31 17:59:15 +00:00
- Completion generation has been split out into [clap_complete](./clap_complete).
docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
- Removed `ArgSettings::EmptyValues` in favor of `ArgSettings::ForbidEmptyValues`
- Validator signatures have been loosed:
- `Arg::validator` now takes first argument as `Fn(&str) -> Result<O, E: ToString>` instead of
Started on automatic upgrader
2020-05-11 09:13:35 +00:00
`Fn(String) -> Result<(), String>`
docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
- `Arg::validator_os` now takes first argument as `Fn(&OsStr) -> Result<O, OsString>` instead of
Started on automatic upgrader
2020-05-11 09:13:35 +00:00
`Fn(&OsStr) -> Result<(), OsString>`
docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
- `Arg::value_name` now sets, rather than appends (see [clap-rs/clap#2634](https://github.com/clap-rs/clap/issues/2634))
- Upgrade `yaml-rust` from 0.3 to 0.4
- Replaced `ArgGroup::from(BTreeMap)` to `ArgGroup::from(yaml)`
- Replaced `ArgMatches::usage` with `App::generate_usage`
- Replaced `Arg::settings` with `Arg::setting(Setting1 | Setting2)`
- `App` and `Arg` now need only one lifetime
- Removed deprecated `App::with_defaults`, replaced with `app_from_crate`
- Removed deprecated `AppSettings::PropagateGlobalValuesDown` (now the default)
- Some `App` functions, like `App::write_help` now take `&mut self` instead of `&self`
- `Error::message` is now private, use `Error::to_string`
- `Arg::default_value_if`, `Arg::default_value_if_os`, `Arg::default_value_ifs`,
`Arg::default_value_ifs_os` now takes the default value parameter as an option ([clap-rs/clap#1406](https://github.com/clap-rs/clap/issues/1406))
- Changed `App::print_help` & `App::print_long_help` to now return `std::io::Result`
- Changed `App::write_help` & `App::write_long_help` to now return `std::io::Result`
- Changed `Arg::index`, `Arg::number_of_values`, `Arg::min_values`, `Arg::max_values` to taking `usize` instead of u64
- Changed `Error::info` to type `Vec<String>` instead of `Option<Vec<String>>`
- Changed `ArgMatches::subcommand` to now return `Option<(&str, &ArgMatches)>`
- Renamed `ErrorKind::MissingArgumentOrSubcommand` to `ErrorKind::DisplayHelpOnMissingArgumentOrSubcommand`
- Renamed `ErrorKind::HelpDisplayed` to `ErrorKind::DisplayHelp`
- Renamed `ErrorKind::VersionDisplayed` to `ErrorKind::DisplayVersion`
docs: Update changelog
2021-12-15 17:02:12 +00:00
- Added `#[non_exhaustive]` to `clap::{ValueHint, ErrorKind, AppSettings, ArgSettings}` ([clap-rs/clap#3167](https://github.com/clap-rs/clap/pull/3167))
docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
**From structopt 0.3.25**
- By default, the `App` isn't initialized with crate information anymore. Now opt-in via `#[clap(author)]`, `#[clap(about)]`, `#[clap(version)]` ([clap-rs/clap#3034](https://github.com/clap-rs/clap/issues/3034))
- `#[clap(default_value)]` is replaced with `#[clap(default_value_t)]` ([clap-rs/clap#1694](https://github.com/clap-rs/clap/issues/1694))
- Subcommands nested under subcommands now needs a `#[clap(subcommand)]` attribute ([clap-rs/clap#2587](https://github.com/clap-rs/clap/pull/2587))
- `Vec<_>` and `Option<Vec<_>>` have changed from `multiple` to `multiple_occurrences`
On top of the clap 2 changes
### Performance
**From clap 2**
- Split out non-default `unicode` feature flag for faster builds and smaller binaries for ASCII-only CLIs.
- Split out non-default `env` feature flag for faster builds and smaller binaries.
### Features
**From clap 2**
- Integration of `structopt::StructOpt` via `clap::Parser` (requires `derive` feature flag)
- Custom help headings
- `App::help_heading` (apply to all future args)
- `Arg::help_heading` (apply to current arg)
- `App::subcommand_help_heading` along with `App::subcommand_value_name` (apply to subcommands)
- See [clap-rs/clap#805](https://github.com/clap-rs/clap/issues/805)
- `AppSettings::UnifiedHelpMessage` is now default behaviour ([clap-rs/clap#2807](https://github.com/clap-rs/clap/issues/2807))
- Deriving of `ArgEnum` for generating `Arg::possible_values` (requires `derive` feature flag)
- Disable built-in help/version behavior with `AppSettings::NoAutoHelp` and `AppSettings::NoAutoVersion`
- Change an existing arg with new builder method `mut_arg` (particularly helpful for `--help` and `--version`)
- Provide extra context in long help messages (`--help`) with `before_long_help` and `after_long_help` ([clap-rs/clap#1903](https://github.com/clap-rs/clap/issues/1903))
- Detect missing help descriptions via debug asserts by enabling `AppSettings::HelpExpected`
- Aliases for short flags ([clap-rs/clap#1896](https://github.com/clap-rs/clap/issues/1896))
- Validate UTF-8 values, rather than panicing during `ArgMatches::value_of` thanks to `AppSettings::AllowInvalidUtf8ForExternalSubcommands` and `ArgSettings::AllowInvalidUtf8`
- Debug builds will assert when the `ArgMatches` calls do not match the UTF-8 setting.
- See [clap-rs/clap#751](https://github.com/clap-rs/clap/issues/751)
- `clap::PossibleValue` to allow
- Hiding ([clap-rs/clap#2756](https://github.com/clap-rs/clap/issues/2756))
- Completion help for possible values for args ([clap-rs/clap#2731](https://github.com/clap-rs/clap/issues/2731))
- Allow arguments to conflict with all others via `Arg::exclusive` ([clap-rs/clap#1583](https://github.com/clap-rs/clap/issues/1583))
- Validate arguments with a regex (required `regex` feature flag)
- See [clap-rs/clap](https://github.com/clap-rs/clap/issues/1968)
- `Arg::default_missing_value` for cases like `--color[=<WHEN>]` ([clap-rs/clap#1587](https://github.com/clap-rs/clap/pull/1587))
- `clap::App::color` / `clap::ColorChoice` to specify color setting for the app
- Custom error reporting with `App::error`
feat: `App::debug_assert` test helper This will especially be important for users migrating from clap2 so they can catch problems earlier in the process.
2021-12-03 20:12:03 +00:00
- `App::debug_assert` test helper
docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
- Replace `Arg::multiple(bool)` with `Arg::multiple_values` / `Arg::multiple_occurrences`
- Positionals can be either
- Added support for flag subcommands like pacman ([clap-rs/clap#1361](https://github.com/clap-rs/clap/issues/1361))
- Partial parsing via `AppSettings::IgnoreErrors` ([clap-rs/clap#1880](https://github.com/clap-rs/clap/issues/1880))
- Enable `cmd help` to print long help (`--help` instead of `-h`) with `AppSettings::UseLongFormatForHelpSubcommand` ([clap-rs/clap#2435](https://github.com/clap-rs/clap/issues/2435))
- Allow long arg abbreviations like we do with subcommands via `AppSettings::InferLongArgs` ([clap-rs/clap#2435](https://github.com/clap-rs/clap/issues/2435))
- Detect subcommands among positional arguments with `AppSettings::SubcommandPrecedenceOverArg`
- Give completion scripts hints with `Arg::value_hint` ([clap-rs/clap#1793](https://github.com/clap-rs/clap/pull/1793))
- Allow unsetting defaults with
- `Arg::default_value_if`, `Arg::default_value_if_os`, `Arg::default_value_ifs`,
`Arg::default_value_ifs_os` ([clap-rs/clap#1406](https://github.com/clap-rs/clap/issues/1406))
- Interpret some env variable values as `false` for flags, in addition to "not-present" ([clap-rs/clap#2539](https://github.com/clap-rs/clap/issues/2539))
- `n`, `no`, `f`, `false`, `off`, `0`
- Added `arg!` macro for creating an `Arg` from a compile-time usage parser
- *(Experimental)* Busybox-like multi-call support
- See `AppSettings::Multicall` behind `unstable-multicall` feature flag
- See [clap-rs/clap#1120](https://github.com/clap-rs/clap/issues/1120)
- *(Experimental)* Alias an argument to anything group of arguments
- See `App::replace` behind `unstable-replace` feature flag
- See [clap-rs#1603](https://github.com/clap-rs/clap/issues/1603)
- *(Experimental)* Grouping of multiple values within multiple occurrences
- See `ArgMatches::grouped_values_of` behind `unstable-grouped` feature flag
- See [clap-rs/clap#1026](https://github.com/clap-rs/clap/issues/1026)
**From structopt 0.3.25**
- Allow defaulting with native types via new `default_value_t [= <expr>]` attribute ([clap-rs/clap#1694](https://github.com/clap-rs/clap/issues/1694))
- New `update` API
- New `arg_enum` attribute for integrating with `ArgEnum` trait
On top of the clap 2 changes
### Fixes
**From clap 2**
- Correctly handle colored output on Windows
- Only generate version flags when `App::version`, `App::long_version` are set
(see [clap-rs/clap#2812](https://github.com/clap-rs/clap/issues/2812))
- General completion script improvements
- Limited default help text wrapping to 100 when `wrap_help` feature is not enabled
- Be more specific than `Arg::multiple` with `Arg::multiple_values` and `Arg::multiple_occurrences`
- `app_from_crate!` defaults to separating multiple authors with `", "`
- Ensure all examples work
- `IgnoreCase` is now unicode aware (requires `unicode` feature flag)
- Always respect `ColorChoice::Never`, even if that means we skip colors in some cases
- `ArgMatches` panics on unknown arguments
fix: Gracefully handle empty authors
2021-12-06 17:29:07 +00:00
- Gracefully handle empty `authors` field in `Cargo.toml` with `app_from_crate`
docs: Update changelog
2021-12-15 17:02:12 +00:00
- Do not show `--help` in `cmd help` with `DisableHelpFlag` ([clap-rs/clap#3169](https://github.com/clap-rs/clap/pull/3169))
- Do not show `--help` in `cmd help help` that doesn't work ([clap-rs/clap#3169](https://github.com/clap-rs/clap/pull/3169))
docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
**From structopt 0.3.25**
- Support `SubcommandsNegateReqs` by allowing required `Option<_>`s ([clap-rs/clap#2255](https://github.com/clap-rs/clap/issues/2255))
- Infer `AllowInvalidUtf8` based on parser ([clap-rs/clap#751](https://github.com/clap-rs/clap/issues/2255))
fix: Gracefully handle empty authors
2021-12-06 17:29:07 +00:00
- Gracefully handle empty `authors` field in `Cargo.toml`
fix(derive): Treat `default_value_os` like `default_value` The test went from panicing to not-panicing Fixes #3031
2021-12-13 22:19:12 +00:00
- Don't panic with `default_value_os` but treat it like `default_value` ([clap-rs/clap#3031](https://github.com/clap-rs/clap/issues/3031))
docs: Update changelog
2021-12-15 17:02:12 +00:00
- When using `flatten` and `subcommand`, ensure our doc comment always overrides the nested container's doc comment, whether it has only `about` or `about` and `long_about` ([clap-rs/clap#3175](]https://github.com/clap-rs/clap/pull/3175))
docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
On top of the clap 2 changes
### Minimum Required Rust
- As of this release, `clap` requires `rustc 1.54.0` or greater.
docs(change): Fix links
2021-12-08 17:45:45 +00:00
## [2.34.0] - 2021-11-30
docs(change): Add v2 changelog This hasn't been cherry-picked in a while
2021-12-08 17:42:39 +00:00
- Updates to Rust 2018 edition and bumps the MSRV to Rust 1.46
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## [2.33.4] - 2021-11-29
docs(change): Add v2 changelog This hasn't been cherry-picked in a while
2021-12-08 17:42:39 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
### Bug Fixes
docs(change): Add v2 changelog This hasn't been cherry-picked in a while
2021-12-08 17:42:39 +00:00
* **prevents `panic`:** swallows broken pipe errors on error output ([7a729bc4](https://github.com/kbknapp/clap-rs/commit/7a729bc4df2646b05f6bf15f001124cd39d076ce))
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## [2.33.3] - 2020-08-13
docs(change): Add v2 changelog This hasn't been cherry-picked in a while
2021-12-08 17:42:39 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
### Improvements
docs(change): Add v2 changelog This hasn't been cherry-picked in a while
2021-12-08 17:42:39 +00:00
* Suppress deprecation warnings when using `crate_*` macros.
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## [2.33.2] - 2020-08-5
docs(change): Add v2 changelog This hasn't been cherry-picked in a while
2021-12-08 17:42:39 +00:00
#### Documentation
* Fixed links to `2.x` examples. Now they point to the right place.
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## [2.33.1] - 2020-05-11
docs(change): Add v2 changelog This hasn't been cherry-picked in a while
2021-12-08 17:42:39 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
### Bug Fixes
docs(change): Add v2 changelog This hasn't been cherry-picked in a while
2021-12-08 17:42:39 +00:00
* Windows: Prevent some panics when parsing invalid Unicode on Windows ([922c645](https://github.com/clap-rs/clap/commit/922c64508389170c9c77f1c8a4e597d14d3ed2f0), closes [#1905](https://github.com/clap-rs/clap/issues/1905))
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
### Documentation
docs(change): Add v2 changelog This hasn't been cherry-picked in a while
2021-12-08 17:42:39 +00:00
* fixes versions referenced in the README ([d307466a](https://github.com/kbknapp/clap-rs/commit/d307466af1013f172b8ec0252f01a473e2192d6b))
* **README.md:**
* cuts down the number of examples to reduce confusion ([6e508ee0](https://github.com/kbknapp/clap-rs/commit/6e508ee09e7153de4adf4e88b0aa6418a537dadd))
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
### Improvements
docs(change): Add v2 changelog This hasn't been cherry-picked in a while
2021-12-08 17:42:39 +00:00
* **Deps:** doesnt compile ansi_term on Windows since its not used ([b57ee946](https://github.com/kbknapp/clap-rs/commit/b57ee94609da3ddc897286cfba968f26ff961491), closes [#1155](https://github.com/kbknapp/clap-rs/issues/1155))
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
### Minimum Required Rust
docs(change): Add v2 changelog This hasn't been cherry-picked in a while
2021-12-08 17:42:39 +00:00
* As of this release, `clap` requires `rustc 1.36.0` or greater.
docs(change): Fix links
2021-12-08 17:45:45 +00:00
## [2.33.0] - 2019-04-06
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### New Sponsor
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Stephen Oats is now a sponsor \o/ ([823457c0](https://github.com/clap-rs/clap/commit/823457c0ef5e994ed7080cf62addbfe1aa3b1833))
* **SPONSORS.md:** fixes Josh Triplett's info in the sponsor document ([24cb5740](https://github.com/clap-rs/clap/commit/24cb574090a11159b48bba105d5ec2dfb0a20e4e))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Completions:** adds completion support for Elvish. ([e9d0562a](https://github.com/clap-rs/clap/commit/e9d0562a1dc5dfe731ed7c767e6cee0af08f0cf9))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
* There is a new setting to disable automatic building of `--help` and `-h` flags (`AppSettings::DisableAutoHelp`)
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **arg_matches.rs:** add Debug implementations ([47192b7a](https://github.com/clap-rs/clap/commit/47192b7a2d84ec716b81ae4af621e008a8762dc9))
* **macros:** Support shorthand syntax for ArgGroups ([df9095e7](https://github.com/clap-rs/clap/commit/df9095e75bb1e7896415251d0d4ffd8a0ebcd559))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Refer to macOS rather than OSX. ([ab0d767f](https://github.com/clap-rs/clap/commit/ab0d767f3a5a57e2bbb97d0183c2ef63c8c77a6c))
* **README.md:** use https for all links ([96a7639a](https://github.com/clap-rs/clap/commit/96a7639a36bcb184c3f45348986883115ef1ab3a))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* add debug assertion for missing args in subcommand ArgGroup ([2699d9e5](https://github.com/clap-rs/clap/commit/2699d9e51e7eadc258ba64c4e347c5d1fef61343))
* Restore compat with Rust 1.21 ([6b263de1](https://github.com/clap-rs/clap/commit/6b263de1d42ede692ec5ee55019ad2fc6386f92e))
* Don't mention unused subcommands ([ef92e2b6](https://github.com/clap-rs/clap/commit/ef92e2b639ed305bdade4741f60fa85cb0101c5a))
* **OsValues:** Add `ExactSizeIterator` implementation ([356c69e5](https://github.com/clap-rs/clap/commit/356c69e508fd25a9f0ea2d27bf80ae1d9a8d88f4))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
* **arg_enum!:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Fix comma position for valid values. ([1f1f9ff3](https://github.com/clap-rs/clap/commit/1f1f9ff3fa38a43231ef8be9cfea89a32e53f518))
* Invalid expansions of some trailing-comma patterns ([7023184f](https://github.com/clap-rs/clap/commit/7023184fca04e852c270341548d6a16207d13862))
* **completions:** improve correctness of completions when whitespace is involved ([5a08ff29](https://github.com/clap-rs/clap/commit/5a08ff295b2aa6ce29420df6252a0e3ff4441bdc))
* **help message:** Unconditionally uses long description for subcommands ([6acc8b6a](https://github.com/clap-rs/clap/commit/6acc8b6a621a765cbf513450188000d943676a30), closes [#897](https://github.com/clap-rs/clap/issues/897))
* **macros:** fixes broken pattern which prevented calling multi-argument Arg methods ([9e7a352e](https://github.com/clap-rs/clap/commit/9e7a352e13aaf8025d80f2bac5c47fb32528672b))
* **parser:** Better interaction between AllowExternalSubcommands and SubcommandRequired ([9601c95a](https://github.com/clap-rs/clap/commit/9601c95a03d2b82bf265c328b4769238f1b79002))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Minimum Required Rust
* As of this release, `clap` requires `rustc 1.31.0` or greater.
## v2.32.0 (2018-06-26)
#### Minimum Required Rust
* As of this release, `clap` requires `rustc 1.21.0` or greater.
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Completions:** adds completion support for Elvish. ([e9d0562a](https://github.com/clap-rs/clap/commit/e9d0562a1dc5dfe731ed7c767e6cee0af08f0cf9))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **macros:** Support shorthand syntax for ArgGroups ([df9095e7](https://github.com/clap-rs/clap/commit/df9095e75bb1e7896415251d0d4ffd8a0ebcd559))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **OsValues:** Add `ExactSizeIterator` implementation ([356c69e5](https://github.com/clap-rs/clap/commit/356c69e508fd25a9f0ea2d27bf80ae1d9a8d88f4))
* **arg_enum!:** Invalid expansions of some trailing-comma patterns ([7023184f](https://github.com/clap-rs/clap/commit/7023184fca04e852c270341548d6a16207d13862))
* **help message:** Unconditionally uses long description for subcommands ([6acc8b6a](https://github.com/clap-rs/clap/commit/6acc8b6a621a765cbf513450188000d943676a30), closes [#897](https://github.com/clap-rs/clap/issues/897))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Refer to macOS rather than OSX. ([ab0d767f](https://github.com/clap-rs/clap/commit/ab0d767f3a5a57e2bbb97d0183c2ef63c8c77a6c))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.31.2 (2018-03-19)
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Fish Completions:** fixes a bug that only allowed a single completion in in Fish Shell ([e8774a8](https://github.com/clap-rs/clap/pull/1214/commits/e8774a84ee4a319c888036e7c595ab46451d8e48), closes [#1212](https://github.com/clap-rs/clap/issues/1212))
* **AllowExternalSubcommands**: fixes a bug where external subcommands would be blocked by a similarly named subcommand (suggestions were getting in the way). ([a410e85](https://github.com/clap-rs/clap/pull/1215/commits/a410e855bcd82b05f9efa73fa8b9774dc8842c6b))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Fixes some typos in the `README.md` ([c8e685d7](https://github.com/clap-rs/clap/commit/c8e685d76adee2a3cc06cac6952ffcf6f9548089))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.31.1 (2018-03-06)
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **AllowMissingPositional:** improves the ability of AllowMissingPositional to allow 'skipping' to the last positional arg with '--' ([df20e6e2](https://github.com/clap-rs/clap/commit/df20e6e24b4e782be0b423b484b9798e3e2efe2f))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
## v2.31.0 (2018-03-04)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Arg Indices:** adds the ability to query argument value indices ([f58d0576](https://github.com/clap-rs/clap/commit/f58d05767ec8133c8eb2de117cb642b9ae29ccbc))
* **Indices:** implements an Indices<Item=&usize> iterator ([1e67be44](https://github.com/clap-rs/clap/commit/1e67be44f0ccf161cc84c4e6082382072e89c302))
* **Raw Args** adds a convenience function to `Arg` that allows implying all of `Arg::last` `Arg::allow_hyphen_values` and `Arg::multiple(true)` ([66a78f29](https://github.com/clap-rs/clap/commit/66a78f2972786f5fe7c07937a1ac23da2542afd2))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Fix some typos and markdown issues. ([935ba0dd](https://github.com/clap-rs/clap/commit/935ba0dd547a69c3f636c5486795012019408794))
* **Arg Indices:** adds the documentation for the arg index querying methods ([50bc0047](https://github.com/clap-rs/clap/commit/50bc00477afa64dc6cdc5de161d3de3ba1d105a7))
* **CONTRIBUTING.md:** fix url to clippy upstream repo to point to https://github.com/rust-lang-nursery/rust-clippy instead of https://github.com/Manishearth/rust-clippy ([42407d7f](https://github.com/clap-rs/clap/commit/42407d7f21d794103cda61f49d2615aae0a4bcd9))
* **Values:** improves the docs example of the Values iterator ([74075d65](https://github.com/clap-rs/clap/commit/74075d65e8db1ddb5e2a4558009a5729d749d1b6))
* Updates readme to hint that the `wrap_help` feature is a thing ([fc7ab227](https://github.com/clap-rs/clap/commit/66a78f2972786f5fe7c07937a1ac23da2542afd2))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Cargo.toml: use codegen-units = 1 in release and bench profiles ([19f425ea](https://github.com/clap-rs/clap/commit/66a78f2972786f5fe7c07937a1ac23da2542afd2))
* Adds WASM support (clap now compiles on WASM!) ([689949e5](https://github.com/clap-rs/clap/commit/689949e57d390bb61bc69f3ed91f60a2105738d0))
* Uses the short help tool-tip for PowerShell completion scripts ([ecda22ce](https://github.com/clap-rs/clap/commit/ecda22ce7210ce56d7b2d1a5445dd1b8a2959656))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
## v2.30.0 (2018-02-13)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **YAML:** Adds a missing conversion from `Arg::last` when instantiating from a YAML file ([aab77c81a5](https://github.com/clap-rs/clap/pull/1175/commits/aab77c81a519b045f95946ae0dd3e850f9b93070), closes [#1160](https://github.com/clap-rs/clap/issues/1173))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Bash Completions:** instead of completing a generic option name, all bash completions fall back to file completions UNLESS `Arg::possible_values` was used ([872f02ae](https://github.com/clap-rs/clap/commit/872f02aea900ffa376850a279eb164645e1234fa))
* **Deps:** No longer needlessly compiles `ansi_term` on Windows since its not used ([b57ee946](https://github.com/clap-rs/clap/commit/b57ee94609da3ddc897286cfba968f26ff961491), closes [#1155](https://github.com/clap-rs/clap/issues/1155))
* **Help Message:** changes the `[values: foo bar baz]` array to `[possible values: foo bar baz]` for consistency with the API ([414707e4e97](https://github.com/clap-rs/clap/pull/1176/commits/414707e4e979d07bfe555247e5d130c546673708), closes [#1160](https://github.com/clap-rs/clap/issues/1160))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.29.4 (2018-02-06)
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Overrides Self:** fixes a bug where options with multiple values couldn't ever have multiple values ([d95907cf](https://github.com/clap-rs/clap/commit/d95907cff6d011a901fe35fa00b0f4e18547a1fb))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.29.3 (2018-02-05)
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Overrides:** clap now supports arguments which override with themselves ([6c7a0010](https://github.com/clap-rs/clap/commit/6c7a001023ca1eac1cc6ffe6c936b4c4a2aa3c45), closes [#976](https://github.com/clap-rs/clap/issues/976))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Requirements:** fixes an issue where conflicting args would still show up as required ([e06cefac](https://github.com/clap-rs/clap/commit/e06cefac97083838c0a4e1444dcad02a5c3f911e), closes [#1158](https://github.com/clap-rs/clap/issues/1158))
* Fixes a bug which disallows proper nesting of `--` ([73993fe](https://github.com/clap-rs/clap/commit/73993fe30d135f682e763ec93dcb0814ed518011), closes [#1161](https://github.com/clap-rs/clap/issues/1161))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
#### New Settings
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **AllArgsOverrideSelf:** adds a new convenience setting to allow all args to override themselves ([4670325d](https://github.com/clap-rs/clap/commit/4670325d1bf0369addec2ae2bcb56f1be054c924))
Backport changelog from v2
2020-06-06 15:41:52 +00:00
Update changelog to reflect the correct minimum version
2020-02-02 08:31:09 +00:00
## v2.29.2 (2018-01-16)
chore: increase version
2018-01-16 20:01:53 +00:00
#### Features
* **completions/zsh.rs:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Escape possible values for options ([25561dec](https://github.com/clap-rs/clap/commit/25561decf147d329b64634a14d9695673c2fc78f))
* Implement positional argument possible values completion ([f3b0afd2](https://github.com/clap-rs/clap/commit/f3b0afd2bef8b7be97162f8a7802ddf7603dff36))
* Complete positional arguments properly ([e39aeab8](https://github.com/clap-rs/clap/commit/e39aeab8487596046fbdbc6a226e5c8820585245))
chore: increase version
2018-01-16 20:01:53 +00:00
#### Bug Fixes
* **completions/zsh.rs:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Add missing autoload for is-at-least ([a6522607](https://github.com/clap-rs/clap/commit/a652260795d1519f6ec2a7a09ccc1258499cad7b))
* Don't pass -S to _arguments if Zsh is too old ([16b4f143](https://github.com/clap-rs/clap/commit/16b4f143ff466b7ef18a267bc44ade0f9639109b))
* Maybe fix completions with mixed positionals and subcommands ([1146f0da](https://github.com/clap-rs/clap/commit/1146f0da154d6796fbfcb09db8efa3593cb0d898))
* **completions/zsh.zsh:** Remove redundant code from output ([0e185b92](https://github.com/clap-rs/clap/commit/0e185b922ed1e0fd653de00b4cd8d567d72ff68e), closes [#1142](https://github.com/clap-rs/clap/issues/1142))
chore: increase version
2018-01-16 20:01:53 +00:00
chore: increase version
2018-01-09 16:08:47 +00:00
### 2.29.1 (2018-01-09)
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes broken links. ([56e734b8](https://github.com/clap-rs/clap/commit/56e734b839303d733d2e5baf7dac39bd7b97b8e4))
* updates contributors list ([e1313a5a](https://github.com/clap-rs/clap/commit/e1313a5a0f69d8f4016f73b860a63af8318a6676))
chore: increase version
2018-01-09 16:08:47 +00:00
#### Performance
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* further debloating by removing generics from error cases ([eb8d919e](https://github.com/clap-rs/clap/commit/eb8d919e6f3443db279ba0c902f15d76676c02dc))
* debloats clap by deduplicating logic and refactors ([03e413d7](https://github.com/clap-rs/clap/commit/03e413d7175d35827cd7d8908d47dbae15a849a3))
chore: increase version
2018-01-09 16:08:47 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes the ripgrep benchmark by adding a value to a flag that expects it ([d26ab2b9](https://github.com/clap-rs/clap/commit/d26ab2b97cf9c0ea675b440b7b0eaf6ac3ad01f4))
* **bash completion:** Change the bash completion script code generation to support hyphens. ([ba7f1d18](https://github.com/clap-rs/clap/commit/ba7f1d18eba7a07ce7f57e0981986f66c994b639))
* **completions/zsh.rs:** Fix completion of long option values ([46365cf8](https://github.com/clap-rs/clap/commit/46365cf8be5331ba04c895eb183e2f230b5aad51))
chore: increase version
2018-01-09 16:08:47 +00:00
chore: increase version
2017-12-02 20:11:52 +00:00
## 2.29.0 (2017-12-02)
#### API Additions
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Arg:** adds Arg::hide_env_values(bool) which allows one to hide any current env values and display only the key in help messages ([fb41d062](https://github.com/clap-rs/clap/commit/fb41d062eedf37cb4f805c90adca29909bd197d7))
chore: increase version
2017-12-02 20:11:52 +00:00
chore: increase version
2017-11-28 12:46:17 +00:00
## 2.28.0 (2017-11-28)
chore: increase version
2017-11-27 15:28:28 +00:00
The minimum required Rust is now 1.20. This was done to start using bitflags 1.0 and having >1.0 deps is a *very good* thing!
chore: increase version
2017-11-28 12:46:17 +00:00
#### Documentation
chore: increase version
2017-11-27 15:28:28 +00:00
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* changes the demo version to 2.28 to stay in sync ([ce6ca492](https://github.com/clap-rs/clap/commit/ce6ca492c7510ab6474075806360b96081b021a9))
* Fix URL path to github hosted files ([ce72aada](https://github.com/clap-rs/clap/commit/ce72aada56a9581d4a6cb4bf9bdb861c3906f8df), closes [#1106](https://github.com/clap-rs/clap/issues/1106))
* fix typo ([002b07fc](https://github.com/clap-rs/clap/commit/002b07fc98a1c85acb66296b1eec0b2aba906125))
* **README.md:** updates the readme and pulls out some redundant sections ([db6caf86](https://github.com/clap-rs/clap/commit/db6caf8663747e679d2f4ed3bd127f33476754aa))
chore: increase version
2017-11-27 15:28:28 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* adds '[SUBCOMMAND]' to usage strings with only AppSettings::AllowExternalSubcommands is used with no other subcommands ([e78bb757](https://github.com/clap-rs/clap/commit/e78bb757a3df16e82d539e450c06767a6bfcf859), closes [#1093](https://github.com/clap-rs/clap/issues/1093))
chore: increase version
2017-11-27 15:28:28 +00:00
chore: increase version
2017-11-28 12:46:17 +00:00
#### API Additions
chore: increase version
2017-11-27 15:28:28 +00:00
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Adds Arg::case_insensitive(bool) which allows matching Arg::possible_values without worrying about ASCII case ([1fec268e](https://github.com/clap-rs/clap/commit/1fec268e51736602e38e67c76266f439e2e0ef12), closes [#1118](https://github.com/clap-rs/clap/issues/1118))
* Adds the traits to be used with the clap-derive crate to be able to use Custom Derive ([6f4c3412](https://github.com/clap-rs/clap/commit/6f4c3412415e882f5ca2cc3fbd6d4dce79440828))
chore: increase version
2017-11-27 15:28:28 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Fixes a regression where --help couldn't be overridden ([a283d69f](https://github.com/clap-rs/clap/commit/a283d69fc08aa016ae1bf9ba010012abecc7ba69), closes [#1112](https://github.com/clap-rs/clap/issues/1112))
* fixes a bug that allowed options to pass parsing when no value was provided ([2fb75821](https://github.com/clap-rs/clap/commit/2fb758219c7a60d639da67692e100b855a8165ac), closes [#1105](https://github.com/clap-rs/clap/issues/1105))
* ignore PropagateGlobalValuesDown deprecation warning ([f61ce3f5](https://github.com/clap-rs/clap/commit/f61ce3f55fe65e16b3db0bd4facdc4575de22767), closes [#1086](https://github.com/clap-rs/clap/issues/1086))
chore: increase version
2017-11-27 15:28:28 +00:00
#### Deps
* Updates `bitflags` to 1.0
chore: increase version
2017-10-26 13:28:11 +00:00
## v2.27.1 (2017-10-24)
#### Bug Fixes
* Adds `term_size` as an optional dependency (with feature `wrap_help`) to fix compile bug
chore: increase version
2017-10-24 22:31:33 +00:00
## v2.27.0 (2017-10-24)
Fix typo in minimum required Rust version
2017-10-25 01:51:21 +00:00
** This release raises the minimum required version of Rust to 1.18 **
chore: increase version
2017-10-24 22:31:33 +00:00
** This release also contains a very minor breaking change to fix a bug **
The only CLIs affected will be those using unrestrained multiple values and subcommands where the
chore: increase version
2017-10-26 13:28:11 +00:00
subcommand name can coincide with one of the multiple values.
chore: increase version
2017-10-24 22:31:33 +00:00
docs: Update old repo location
2021-12-07 14:14:41 +00:00
See the commit [0c223f54](https://github.com/clap-rs/clap/commit/0c223f54ed46da406bc8b43a5806e0b227863b31) for full details.
chore: increase version
2017-10-24 22:31:33 +00:00
#### Bug Fixes
* Values from global args are now propagated UP and DOWN!
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes a bug where using AppSettings::AllowHyphenValues would allow invalid arguments even when there is no way for them to be valid ([77ed4684](https://github.com/clap-rs/clap/commit/77ed46841fc0263d7aa32fcc5cc49ef703b37c04), closes [#1066](https://github.com/clap-rs/clap/issues/1066))
* when an argument requires a value and that value happens to match a subcommand name, its parsed as a value ([0c223f54](https://github.com/clap-rs/clap/commit/0c223f54ed46da406bc8b43a5806e0b227863b31), closes [#1031](https://github.com/clap-rs/clap/issues/1031), breaks [#](https://github.com/clap-rs/clap/issues/), [#](https://github.com/clap-rs/clap/issues/))
* fixes a bug that prevented number_of_values and default_values to be used together ([5eb342a9](https://github.com/clap-rs/clap/commit/5eb342a99dde07b0f011048efde3e283bc1110fc), closes [#1050](https://github.com/clap-rs/clap/issues/1050), [#1056](https://github.com/clap-rs/clap/issues/1056))
* fixes a bug that didn't allow args with default values to have conflicts ([58b5b4be](https://github.com/clap-rs/clap/commit/58b5b4be315280888d50d9b15119b91a9028f050), closes [#1071](https://github.com/clap-rs/clap/issues/1071))
* fixes a panic when using global args and calling App::get_matches_from_safe_borrow multiple times ([d86ec797](https://github.com/clap-rs/clap/commit/d86ec79742c77eb3f663fb30e225954515cf25bb), closes [#1076](https://github.com/clap-rs/clap/issues/1076))
* fixes issues and potential regressions with global args values not being propagated properly or at all ([a43f9dd4](https://github.com/clap-rs/clap/commit/a43f9dd4aaf1864dd14a3c28dec89ccdd70c61e5), closes [#1010](https://github.com/clap-rs/clap/issues/1010), [#1061](https://github.com/clap-rs/clap/issues/1061), [#978](https://github.com/clap-rs/clap/issues/978))
* fixes a bug where default values are not applied if the option supports zero values ([9c248cbf](https://github.com/clap-rs/clap/commit/9c248cbf7d8a825119bc387c23e9a1d1989682b0), closes [#1047](https://github.com/clap-rs/clap/issues/1047))
chore: increase version
2017-10-24 22:31:33 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* adds additional blurbs about using multiples with subcommands ([03455b77](https://github.com/clap-rs/clap/commit/03455b7751a757e7b2f6ffaf2d16168539c99661))
* updates the docs to reflect changes to global args and that global args values can now be propagated back up the stack ([ead076f0](https://github.com/clap-rs/clap/commit/ead076f03ada4c322bf3e34203925561ec496d87))
* add html_root_url attribute ([e67a061b](https://github.com/clap-rs/clap/commit/e67a061bcf567c6518d6c2f58852e01f02764b22))
* sync README version numbers with crate version ([5536361b](https://github.com/clap-rs/clap/commit/5536361bcda29887ed86bb68e43d0b603cbc423f))
chore: increase version
2017-10-24 22:31:33 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* args that have require_delimiter(true) is now reflected in help and usage strings ([dce61699](https://github.com/clap-rs/clap/commit/dce616998ed9bd95e8ed3bec1f09a4883da47b85), closes [#1052](https://github.com/clap-rs/clap/issues/1052))
* if all subcommands are hidden, the subcommands section of the help message is no longer displayed ([4ae7b046](https://github.com/clap-rs/clap/commit/4ae7b0464750bc07ec80ece38e43f003fdd1b8ae), closes [#1046](https://github.com/clap-rs/clap/issues/1046))
chore: increase version
2017-10-24 22:31:33 +00:00
#### Breaking Changes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* when an argument requires a value and that value happens to match a subcommand name, its parsed as a value ([0c223f54](https://github.com/clap-rs/clap/commit/0c223f54ed46da406bc8b43a5806e0b227863b31), closes [#1031](https://github.com/clap-rs/clap/issues/1031), breaks [#](https://github.com/clap-rs/clap/issues/), [#](https://github.com/clap-rs/clap/issues/))
chore: increase version
2017-10-24 22:31:33 +00:00
#### Deprecations
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **AppSettings::PropagateGlobalValuesDown:** this setting is no longer required to propagate values down or up ([2bb5ddce](https://github.com/clap-rs/clap/commit/2bb5ddcee61c791ca1aaca494fbeb4bd5e277488))
chore: increase version
2017-10-24 22:31:33 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.26.2 (2017-09-14)
chore: increase version
2017-09-14 17:39:24 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* if all subcommands are hidden, the subcommands section of the help message is no longer displayed ([4ae7b046](https://github.com/clap-rs/clap/commit/4ae7b0464750bc07ec80ece38e43f003fdd1b8ae), closes [#1046](https://github.com/clap-rs/clap/issues/1046))
chore: increase version
2017-09-14 17:39:24 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes a bug where default values are not applied if the option supports zero values ([9c248cbf](https://github.com/clap-rs/clap/commit/9c248cbf7d8a825119bc387c23e9a1d1989682b0), closes [#1047](https://github.com/clap-rs/clap/issues/1047))
chore: increase version
2017-09-14 17:39:24 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.26.1 (2017-09-14)
chore: increase version
2017-09-14 03:55:00 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes using require_equals(true) and min_values(0) together ([10ae208f](https://github.com/clap-rs/clap/commit/10ae208f68518eff6e98166724065745f4083174), closes [#1044](https://github.com/clap-rs/clap/issues/1044))
* escape special characters in zsh and fish completions ([87e019fc](https://github.com/clap-rs/clap/commit/87e019fc84ba6193a8c4ddc26c61eb99efffcd25))
* avoid panic generating default help msg if term width set to 0 due to bug in textwrap 0.7.0 ([b3eadb0d](https://github.com/clap-rs/clap/commit/b3eadb0de516106db4e08f078ad32e8f6d6e7a57))
* Change `who's` -> `whose` ([53c1ffe8](https://github.com/clap-rs/clap/commit/53c1ffe87f38b05d8804a0f7832412a952845349))
* adds a debug assertion to ensure all args added to groups actually exist ([7ad123e2](https://github.com/clap-rs/clap/commit/7ad123e2c02577e3ca30f7e205181e896b157d11), closes [#917](https://github.com/clap-rs/clap/issues/917))
* fixes a bug where args that allow values to start with a hyphen couldn't contain a double hyphen -- as a value ([ab2f4c9e](https://github.com/clap-rs/clap/commit/ab2f4c9e563e36ec739a4b55d5a5b76fdb9e9fa4), closes [#960](https://github.com/clap-rs/clap/issues/960))
* fixes a bug where positional argument help text is misaligned ([54c16836](https://github.com/clap-rs/clap/commit/54c16836dea4651806a2cfad53146a83fa3abf21))
* **Help Message:** fixes long_about not being usable ([a8257ea0](https://github.com/clap-rs/clap/commit/a8257ea0ffb812e552aca256c4a3d2aebfd8065b), closes [#1043](https://github.com/clap-rs/clap/issues/1043))
* **Suggestions:** output for flag after subcommand ([434ea5ba](https://github.com/clap-rs/clap/commit/434ea5ba71395d8c1afcf88e69f0b0d8339b01a1))
chore: increase version
2017-09-14 03:55:00 +00:00
chore: increase version
2017-07-29 19:29:39 +00:00
## v2.26.0 (2017-07-29)
Minimum version of Rust is now v1.13.0 (Stable)
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* bumps unicode-segmentation to v1.2 ([cd7b40a2](https://github.com/clap-rs/clap/commit/cd7b40a21c77bae17ba453c5512cb82b7d1ce474))
chore: increase version
2017-07-29 19:29:39 +00:00
#### Performance
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* update textwrap to version 0.7.0 ([c2d4e637](https://github.com/clap-rs/clap/commit/c2d4e63756a6f070e38c16dff846e9b0a53d6f93))
chore: increase version
2017-07-29 19:29:39 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.25.1 (2017-07-21)
chore: increase version
2017-07-21 13:55:15 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* impl Default for Values + OsValues for any lifetime. ([fb7d6231f1](https://github.com/clap-rs/clap/commit/fb7d6231f13a2f79f411e62dca210b7dc9994c18))
chore: increase version
2017-07-21 13:55:15 +00:00
#### Documentation
* Various documentation typos and grammar fixes
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.25.0 (2017-06-20)
chore: increase version * chore: disables mention-bots finding reviewers and pinging tons of people * docs(README.md): added a warning about using ~ deps * chore: increase version
2017-06-20 02:57:54 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* use textwrap crate for wrapping help texts ([b93870c1](https://github.com/clap-rs/clap/commit/b93870c10ae3bd90d233c586a33e086803117285))
chore: increase version * chore: disables mention-bots finding reviewers and pinging tons of people * docs(README.md): added a warning about using ~ deps * chore: increase version
2017-06-20 02:57:54 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Suggestions:** suggests to use flag after subcommand when applicable ([2671ca72](https://github.com/clap-rs/clap/commit/2671ca7260119d4311d21c4075466aafdd9da734))
chore: increase version * chore: disables mention-bots finding reviewers and pinging tons of people * docs(README.md): added a warning about using ~ deps * chore: increase version
2017-06-20 02:57:54 +00:00
* Bumps bitflags crate to v0.9
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Change `who's` -> `whose` ([53c1ffe8](https://github.com/clap-rs/clap/commit/53c1ffe87f38b05d8804a0f7832412a952845349))
chore: increase version * chore: disables mention-bots finding reviewers and pinging tons of people * docs(README.md): added a warning about using ~ deps * chore: increase version
2017-06-20 02:57:54 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **App::template:** adds details about the necessity to use AppSettings::UnifiedHelpMessage when using {unified} tags in the help template ([cbea3d5a](https://github.com/clap-rs/clap/commit/cbea3d5acf3271a7a734498c4d99c709941c331e), closes [#949](https://github.com/clap-rs/clap/issues/949))
* **Arg::allow_hyphen_values:** updates the docs to include warnings for allow_hyphen_values and multiple(true) used together ([f9b0d657](https://github.com/clap-rs/clap/commit/f9b0d657835d3f517f313d70962177dc30acf4a7))
chore: increase version * chore: disables mention-bots finding reviewers and pinging tons of people * docs(README.md): added a warning about using ~ deps * chore: increase version
2017-06-20 02:57:54 +00:00
* **README.md:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* added a warning about using ~ deps ([821929b5](https://github.com/clap-rs/clap/commit/821929b51bd60213955705900a436c9a64fcb79f), closes [#964](https://github.com/clap-rs/clap/issues/964))
* **clap_app!:** adds using the @group specifier to the macro docs ([826048cb](https://github.com/clap-rs/clap/commit/826048cb3cbc0280169303f1498ff0a2b7395883), closes [#932](https://github.com/clap-rs/clap/issues/932))
chore: increase version * chore: disables mention-bots finding reviewers and pinging tons of people * docs(README.md): added a warning about using ~ deps * chore: increase version
2017-06-20 02:57:54 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.24.2 (2017-05-15)
chore: increase version'
2017-05-15 22:37:00 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* adds a debug assertion to ensure all args added to groups actually exist ([14f6b8f3](https://github.com/clap-rs/clap/commit/14f6b8f3a2f6df73aeeec9c54a54909b1acfc158), closes [#917](https://github.com/clap-rs/clap/issues/917))
* fixes a bug where args that allow values to start with a hyphen couldn't contain a double hyphen -- as a value ([ebf73a09](https://github.com/clap-rs/clap/commit/ebf73a09db6f3c03c19cdd76b1ba6113930e1643), closes [#960](https://github.com/clap-rs/clap/issues/960))
* fixes a bug where positional argument help text is misaligned ([54c16836](https://github.com/clap-rs/clap/commit/54c16836dea4651806a2cfad53146a83fa3abf21))
chore: increase version'
2017-05-15 22:37:00 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **App::template:** adds details about the necessity to use AppSettings::UnifiedHelpMessage when using {unified} tags in the help template ([cf569438](https://github.com/clap-rs/clap/commit/cf569438f309c199800bb8e46c9f140187de69d7), closes [#949](https://github.com/clap-rs/clap/issues/949))
* **Arg::allow_hyphen_values:** updates the docs to include warnings for allow_hyphen_values and multiple(true) used together ([ded5a2f1](https://github.com/clap-rs/clap/commit/ded5a2f15474d4a5bd46a67b130ccb8b6781bd01))
* **clap_app!:** adds using the @group specifier to the macro docs ([fe85fcb1](https://github.com/clap-rs/clap/commit/fe85fcb1772b61f13b20b7ea5290e2437a76190c), closes [#932](https://github.com/clap-rs/clap/issues/932))
chore: increase version'
2017-05-15 22:37:00 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.24.0 (2017-05-07)
chore: increase version
2017-05-07 00:23:01 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes a bug where args with last(true) and required(true) set were not being printed in the usage string ([3ac533fe](https://github.com/clap-rs/clap/commit/3ac533fedabf713943eedf006f830a5a486bbe80), closes [#944](https://github.com/clap-rs/clap/issues/944))
* fixes a bug that was printing the arg name, instead of value name when Arg::last(true) was used ([e1fe8ac3](https://github.com/clap-rs/clap/commit/e1fe8ac3bc1f9cf4e36df0d881f8419755f1787b), closes [#940](https://github.com/clap-rs/clap/issues/940))
* fixes a bug where flags were parsed as flags AND positional values when specific combinations of settings were used ([20f83292](https://github.com/clap-rs/clap/commit/20f83292d070038b8cee2a6b47e91f6b0a2f7871), closes [#946](https://github.com/clap-rs/clap/issues/946))
chore: increase version
2017-05-07 00:23:01 +00:00
chore: increase version
2017-05-05 01:11:41 +00:00
## v2.24.0 (2017-05-05)
chore: increase version
2017-04-19 03:19:24 +00:00
chore: increase version
2017-05-05 01:11:41 +00:00
#### Documentation
chore: increase version
2017-04-19 03:19:24 +00:00
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **README.md:** fix some typos ([fa34deac](https://github.com/clap-rs/clap/commit/fa34deac079f334c3af97bb7fb151880ba8887f8))
chore: increase version
2017-04-19 03:19:24 +00:00
chore: increase version
2017-05-05 01:11:41 +00:00
#### API Additions
chore: increase version
2017-04-19 03:19:24 +00:00
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Arg:** add `default_value_os` ([d5ef8955](https://github.com/clap-rs/clap/commit/d5ef8955414b1587060f7218385256105b639c88))
* **arg_matches.rs:** Added a Default implementation for Values and OsValues iterators. ([0a4384e3](https://github.com/clap-rs/clap/commit/0a4384e350eed74c2a4dc8964c203f21ac64897f))
chore: increase version
2017-04-19 03:19:24 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.23.2 (2017-04-19)
chore: increase version
2017-04-19 03:19:24 +00:00
chore: increase version
2017-05-05 01:11:41 +00:00
#### Bug Fixes
chore: increase version
2017-04-09 18:40:43 +00:00
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **PowerShell Completions:** fixes a bug where powershells completions cant be used if no subcommands are defined ([a8bce558](https://github.com/clap-rs/clap/commit/a8bce55837dc4e0fb187dc93180884a40ae09c6f), closes [#931](https://github.com/clap-rs/clap/issues/931))
chore: increase version
2017-04-09 18:40:43 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* bumps term_size to take advantage of better terminal dimension handling ([e05100b7](https://github.com/clap-rs/clap/commit/e05100b73d74066a90876bf38f952adf5e8ee422))
* **PowerShell Completions:** massively dedups subcommand names in the generate script to make smaller scripts that are still functionally equiv ([85b0e1cc](https://github.com/clap-rs/clap/commit/85b0e1cc4b9755dda75a93d898d79bc38631552b))
chore: increase version
2017-04-09 18:40:43 +00:00
chore: increase version
2017-05-05 01:11:41 +00:00
#### Documentation
chore: increase version
2017-04-09 18:40:43 +00:00
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Fix a typo the minimum rust version required ([71dabba3](https://github.com/clap-rs/clap/commit/71dabba3ea0a17c88b0e2199c9d99f0acbf3bc17))
chore: increase version
2017-04-09 18:40:43 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.23.1 (2017-04-05)
chore: increase version
2017-04-05 14:50:35 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes a missing newline character in the autogenerated help and version messages in some instances ([5ae9007d](https://github.com/clap-rs/clap/commit/5ae9007d984ae94ae2752df51bcbaeb0ec89bc15))
chore: increase version
2017-04-05 14:50:35 +00:00
chore: increase version
2017-04-05 05:09:16 +00:00
## v2.23.0 (2017-04-05)
#### API Additions
* `App::long_about`
* `App::long_version`
* `App::print_long_help`
* `App::write_long_help`
* `App::print_long_version`
* `App::write_long_version`
* `Arg::long_help`
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* allows distinguishing between short and long version messages (-V/short or --version/long) ([59272b06](https://github.com/clap-rs/clap/commit/59272b06cc213289dc604dbc694cb95d383a5d68))
* allows distinguishing between short and long help with subcommands in the same manner as args ([6b371891](https://github.com/clap-rs/clap/commit/6b371891a1702173a849d1e95f9fecb168bf6fc4))
* allows specifying a short help vs a long help (i.e. varying levels of detail depending on if -h or --help was used) ([ef1b24c3](https://github.com/clap-rs/clap/commit/ef1b24c3a0dff2f58c5e2e90880fbc2b69df20ee))
* **clap_app!:** adds support for arg names with hyphens similar to longs with hyphens ([f7a88779](https://github.com/clap-rs/clap/commit/f7a8877978c8f90e6543d4f0d9600c086cf92cd7), closes [#869](https://github.com/clap-rs/clap/issues/869))
chore: increase version
2017-04-05 05:09:16 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes a bug that wasn't allowing help and version to be properly overridden ([8b2ceb83](https://github.com/clap-rs/clap/commit/8b2ceb8368bcb70689fadf1c7f4b9549184926c1), closes [#922](https://github.com/clap-rs/clap/issues/922))
chore: increase version
2017-04-05 05:09:16 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **clap_app!:** documents the `--("some-arg")` method for using args with hyphens inside them ([bc08ef3e](https://github.com/clap-rs/clap/commit/bc08ef3e185393073d969d301989b6319c616c1f), closes [#919](https://github.com/clap-rs/clap/issues/919))
chore: increase version
2017-04-05 05:09:16 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.22.2 (2017-03-30)
chore: increase version
2017-03-30 17:35:36 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Custom Usage Strings:** fixes the usage string regression when using help templates ([0e4fd96d](https://github.com/clap-rs/clap/commit/0e4fd96d74280d306d09e60ac44f938a82321769))
chore: increase version
2017-03-30 17:35:36 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.22.1 (2017-03-24)
chore: increase version
2017-03-24 03:54:19 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **usage:** fixes a big regression with custom usage strings ([2c41caba](https://github.com/clap-rs/clap/commit/2c41caba3c7d723a2894e315d04da796b0e97759))
chore: increase version
2017-03-24 03:54:19 +00:00
chore: increase version
2017-03-23 00:29:40 +00:00
## v2.22.0 (2017-03-23)
#### API Additions
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **App::name:** adds the ability to change the name of the App instance after creation ([d49e8292](https://github.com/clap-rs/clap/commit/d49e8292b026b06e2b70447cd9f08299f4fcba76), closes [#908](https://github.com/clap-rs/clap/issues/908))
* **Arg::hide_default_value:** adds ability to hide the default value of an argument from the help string ([89e6ea86](https://github.com/clap-rs/clap/commit/89e6ea861e16a1ad56757ca12f6b32d02253e44a), closes [#902](https://github.com/clap-rs/clap/issues/902))
chore: increase version
2017-03-23 00:29:40 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.21.3 (2017-03-23)
chore: increase version
2017-03-23 00:16:47 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **yaml:** adds support for loading author info from yaml ([e04c390c](https://github.com/clap-rs/clap/commit/e04c390c597a55fa27e724050342f16c42f1c5c9))
chore: increase version
2017-03-23 00:16:47 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.21.2 (2017-03-17)
chore: increase version
2017-03-17 01:50:26 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* add fish subcommand help support ([f8f68cf8](https://github.com/clap-rs/clap/commit/f8f68cf8251669aef4539a25a7c1166f0ac81ea6))
* options that use `require_equals(true)` now display the equals sign in help messages, usage strings, and errors" ([c8eb0384](https://github.com/clap-rs/clap/commit/c8eb0384d394d2900ccdc1593099c97808a3fa05), closes [#903](https://github.com/clap-rs/clap/issues/903))
chore: increase version
2017-03-17 01:50:26 +00:00
#### Bug Fixes
* setting the max term width now correctly propagates down through child subcommands
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.21.1 (2017-03-12)
chore: increase version
2017-03-12 16:56:23 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **ArgRequiredElseHelp:** fixes the precedence of this error to prioritize over other error messages ([74b751ff](https://github.com/clap-rs/clap/commit/74b751ff2e3631e337b7946347c1119829a41c53), closes [#895](https://github.com/clap-rs/clap/issues/895))
* **Positionals:** fixes some regression bugs resulting from old asserts in debug mode. ([9a3bc98e](https://github.com/clap-rs/clap/commit/9a3bc98e9b55e7514b74b73374c5ac8b6e5e0508), closes [#896](https://github.com/clap-rs/clap/issues/896))
chore: increase version
2017-03-12 16:56:23 +00:00
chore: increase version
2017-03-09 22:12:01 +00:00
## v2.21.0 (2017-03-09)
#### Performance
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* doesn't run `arg_post_processing` on multiple values anymore ([ec516182](https://github.com/clap-rs/clap/commit/ec5161828729f6a53f0fccec8648f71697f01f78))
* changes internal use of `VecMap` to `Vec` for matched values of `Arg`s ([22bf137a](https://github.com/clap-rs/clap/commit/22bf137ac581684c6ed460d2c3c640c503d62621))
* vastly reduces the amount of cloning when adding non-global args minus when they're added from `App::args` which is forced to clone ([8da0303b](https://github.com/clap-rs/clap/commit/8da0303bc02db5fe047cfc0631a9da41d9dc60f7))
* refactor to remove unneeded vectors and allocations and checks for significant performance increases ([0efa4119](https://github.com/clap-rs/clap/commit/0efa4119632f134fc5b8b9695b007dd94b76735d))
chore: increase version
2017-03-09 22:12:01 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Fix examples link in CONTRIBUTING.md ([60cf875d](https://github.com/clap-rs/clap/commit/60cf875d67a252e19bb85054be57696fac2c57a1))
chore: increase version
2017-03-09 22:12:01 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* when `AppSettings::SubcommandsNegateReqs` and `ArgsNegateSubcommands` are used, a new more accurate double line usage string is shown ([50f02300](https://github.com/clap-rs/clap/commit/50f02300d81788817acefef0697e157e01b6ca32), closes [#871](https://github.com/clap-rs/clap/issues/871))
chore: increase version
2017-03-09 22:12:01 +00:00
#### API Additions
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Arg::last:** adds the ability to mark a positional argument as 'last' which means it should be used with `--` syntax and can be accessed early ([6a7aea90](https://github.com/clap-rs/clap/commit/6a7aea9043b83badd9ab038b4ecc4c787716147e), closes [#888](https://github.com/clap-rs/clap/issues/888))
* provides `default_value_os` and `default_value_if[s]_os` ([0f2a3782](https://github.com/clap-rs/clap/commit/0f2a378219a6930748d178ba350fe5925be5dad5), closes [#849](https://github.com/clap-rs/clap/issues/849))
* provides `App::help_message` and `App::version_message` which allows one to override the auto-generated help/version flag associated help ([389c413](https://github.com/clap-rs/clap/commit/389c413b7023dccab8c76aa00577ea1d048e7a99), closes [#889](https://github.com/clap-rs/clap/issues/889))
chore: increase version
2017-03-09 22:12:01 +00:00
#### New Settings
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **InferSubcommands:** adds a setting to allow one to infer shortened subcommands or aliases (i.e. for subcommmand "test", "t", "te", or "tes" would be allowed assuming no other ambiguities) ([11602032](https://github.com/clap-rs/clap/commit/11602032f6ff05881e3adf130356e37d5e66e8f9), closes [#863](https://github.com/clap-rs/clap/issues/863))
chore: increase version
2017-03-09 22:12:01 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* doesn't print the argument sections in the help message if all args in that section are hidden ([ce5ee5f5](https://github.com/clap-rs/clap/commit/ce5ee5f5a76f838104aeddd01c8ec956dd347f50))
* doesn't include the various [ARGS] [FLAGS] or [OPTIONS] if the only ones available are hidden ([7b4000af](https://github.com/clap-rs/clap/commit/7b4000af97637703645c5fb2ac8bb65bd546b95b), closes [#882](https://github.com/clap-rs/clap/issues/882))
* now correctly shows subcommand as required in the usage string when AppSettings::SubcommandRequiredElseHelp is used ([8f0884c1](https://github.com/clap-rs/clap/commit/8f0884c1764983a49b45de52a1eddf8d721564d8))
* fixes some memory leaks when an error is detected and clap exits ([8c2dd287](https://github.com/clap-rs/clap/commit/8c2dd28718262ace4ae0db98563809548e02a86b))
* fixes a trait that's marked private accidentally, but should be crate internal public ([1ae21108](https://github.com/clap-rs/clap/commit/1ae21108015cea87e5360402e1747025116c7878))
* **Completions:** fixes a bug that tried to propagate global args multiple times when generating multiple completion scripts ([5e9b9cf4](https://github.com/clap-rs/clap/commit/5e9b9cf4dd80fa66a624374fd04e6545635c1f94), closes [#846](https://github.com/clap-rs/clap/issues/846))
chore: increase version
2017-03-09 22:12:01 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Options:** adds the ability to require the equals syntax with options --opt=val ([f002693d](https://github.com/clap-rs/clap/commit/f002693dec6a6959c4e9590cb7b7bfffd6d6e5bc), closes [#833](https://github.com/clap-rs/clap/issues/833))
chore: increase version
2017-03-09 22:12:01 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.20.5 (2017-02-18)
chore: increase version
2017-02-18 16:44:38 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **clap_app!:** fixes a critical bug of a missing fragment specifier when using `!property` style tags. ([5635c1f94](https://github.com/clap-rs/clap/commit/5e9b9cf4dd80fa66a624374fd04e6545635c1f94))
chore: increase version
2017-02-18 16:44:38 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.20.4 (2017-02-15)
chore: increase version
2017-02-15 16:06:48 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Completions:** fixes a bug that tried to propagate global args multiple times when generating multiple completion scripts ([5e9b9cf4](https://github.com/clap-rs/clap/commit/5e9b9cf4dd80fa66a624374fd04e6545635c1f94), closes [#846](https://github.com/clap-rs/clap/issues/846))
chore: increase version
2017-02-15 16:06:48 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Fix examples link in CONTRIBUTING.md ([60cf875d](https://github.com/clap-rs/clap/commit/60cf875d67a252e19bb85054be57696fac2c57a1))
chore: increase version
2017-02-15 16:06:48 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.20.3 (2017-02-03)
Call this PR "Raid" cause it's squashin bugs! (#843) * tests: adds tests for default values triggering conditional requirements * fix: fixes a bug where default values should have triggered a conditional requirement but didnt Closes #831 * tests: adds tests for missing conditional requirements in usage string of errors * fix: fixes a bug where conditionally required args werent appearing in errors * tests: adds tests for completion generators * tests: adds tests for completions with binaries names that have underscores * fix: fixes a bug where ZSH completions would panic if the binary name had an underscore in it Closes #581 * fix: fixes bash completions for commands that have an underscore in the name Closes #581 * chore: fix the category for crates.io * docs(Macros): adds a warning about changing values in Cargo.toml not triggering a rebuild automatically Closes #838 * fix(Completions): fixes a bug where global args weren't included in the generated completion scripts Closes #841 * fix: fixes a println->debugln typo * chore: increase version
2017-02-03 22:43:49 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Macros:** adds a warning about changing values in Cargo.toml not triggering a rebuild automatically ([112aea3e](https://github.com/clap-rs/clap/commit/112aea3e42ae9e0c0a2d33ebad89496dbdd95e5d), closes [#838](https://github.com/clap-rs/clap/issues/838))
Call this PR "Raid" cause it's squashin bugs! (#843) * tests: adds tests for default values triggering conditional requirements * fix: fixes a bug where default values should have triggered a conditional requirement but didnt Closes #831 * tests: adds tests for missing conditional requirements in usage string of errors * fix: fixes a bug where conditionally required args werent appearing in errors * tests: adds tests for completion generators * tests: adds tests for completions with binaries names that have underscores * fix: fixes a bug where ZSH completions would panic if the binary name had an underscore in it Closes #581 * fix: fixes bash completions for commands that have an underscore in the name Closes #581 * chore: fix the category for crates.io * docs(Macros): adds a warning about changing values in Cargo.toml not triggering a rebuild automatically Closes #838 * fix(Completions): fixes a bug where global args weren't included in the generated completion scripts Closes #841 * fix: fixes a println->debugln typo * chore: increase version
2017-02-03 22:43:49 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes a println->debugln typo ([279aa62e](https://github.com/clap-rs/clap/commit/279aa62eaf08f56ce090ba16b937bc763cbb45be))
* fixes bash completions for commands that have an underscore in the name ([7f5cfa72](https://github.com/clap-rs/clap/commit/7f5cfa724f0ac4e098f5fe466c903febddb2d994), closes [#581](https://github.com/clap-rs/clap/issues/581))
* fixes a bug where ZSH completions would panic if the binary name had an underscore in it ([891a2a00](https://github.com/clap-rs/clap/commit/891a2a006f775e92c556dda48bb32fac9807c4fb), closes [#581](https://github.com/clap-rs/clap/issues/581))
* allow final word to be wrapped in wrap_help ([564c5f0f](https://github.com/clap-rs/clap/commit/564c5f0f1730f4a2c1cdd128664f1a981c31dcd4), closes [#828](https://github.com/clap-rs/clap/issues/828))
* fixes a bug where global args weren't included in the generated completion scripts ([9a1e006e](https://github.com/clap-rs/clap/commit/9a1e006eb75ad5a6057ebd119aa90f7e06c0ace8), closes [#841](https://github.com/clap-rs/clap/issues/841))
Call this PR "Raid" cause it's squashin bugs! (#843) * tests: adds tests for default values triggering conditional requirements * fix: fixes a bug where default values should have triggered a conditional requirement but didnt Closes #831 * tests: adds tests for missing conditional requirements in usage string of errors * fix: fixes a bug where conditionally required args werent appearing in errors * tests: adds tests for completion generators * tests: adds tests for completions with binaries names that have underscores * fix: fixes a bug where ZSH completions would panic if the binary name had an underscore in it Closes #581 * fix: fixes bash completions for commands that have an underscore in the name Closes #581 * chore: fix the category for crates.io * docs(Macros): adds a warning about changing values in Cargo.toml not triggering a rebuild automatically Closes #838 * fix(Completions): fixes a bug where global args weren't included in the generated completion scripts Closes #841 * fix: fixes a println->debugln typo * chore: increase version
2017-02-03 22:43:49 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.20.2 (2017-02-03)
Issues 839,840 (#842) * fix: fixes a critical bug where subcommand settings were being propogated too far Closes #832 * imp: adds ArgGroup::multiple to the supported YAML fields for building ArgGroups from YAML Closes #840 * chore: increase version
2017-02-03 20:46:25 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes a critical bug where subcommand settings were being propagated too far ([74648c94](https://github.com/clap-rs/clap/commit/74648c94b893df542bfa5bb595e68c7bb8167e36), closes [#832](https://github.com/clap-rs/clap/issues/832))
Issues 839,840 (#842) * fix: fixes a critical bug where subcommand settings were being propogated too far Closes #832 * imp: adds ArgGroup::multiple to the supported YAML fields for building ArgGroups from YAML Closes #840 * chore: increase version
2017-02-03 20:46:25 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* adds ArgGroup::multiple to the supported YAML fields for building ArgGroups from YAML ([d8590037](https://github.com/clap-rs/clap/commit/d8590037ce07dafd8cd5b26928aa4a9fd3018288), closes [#840](https://github.com/clap-rs/clap/issues/840))
Issues 839,840 (#842) * fix: fixes a critical bug where subcommand settings were being propogated too far Closes #832 * imp: adds ArgGroup::multiple to the supported YAML fields for building ArgGroups from YAML Closes #840 * chore: increase version
2017-02-03 20:46:25 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.20.1 (2017-01-31)
chore: increase version
2017-01-29 23:52:04 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* allow final word to be wrapped in wrap_help ([564c5f0f](https://github.com/clap-rs/clap/commit/564c5f0f1730f4a2c1cdd128664f1a981c31dcd4), closes [#828](https://github.com/clap-rs/clap/issues/828))
* actually show character in debug output ([84d8c547](https://github.com/clap-rs/clap/commit/84d8c5476de95b7f37d61888bc4f13688b712434))
* include final character in line length ([aff4ba18](https://github.com/clap-rs/clap/commit/aff4ba18da8147e1259b04b0bfbc1fcb5c78a3c0))
chore: increase version
2017-01-29 23:52:04 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* updates libc and term_size deps for the libc version conflict ([6802ac4a](https://github.com/clap-rs/clap/commit/6802ac4a59c142cda9ec55ca0c45ae5cb9a6ab55))
chore: increase version
2017-01-29 23:52:04 +00:00
chore: increase version (#837)
2017-01-31 01:55:02 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fix link from app_from_crate! to crate_authors! (#822) ([5b29be9b](https://github.com/clap-rs/clap/commit/5b29be9b073330ab1f7227cdd19fe4aab39d5dcb))
* fix spelling of "guaranteed" ([4f30a65b](https://github.com/clap-rs/clap/commit/4f30a65b9c03eb09607eb91a929a6396637dc105))
chore: increase version (#837)
2017-01-31 01:55:02 +00:00
chore: increase version
2017-01-04 04:37:44 +00:00
#### New Settings
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **ArgsNegateSubcommands:** disables args being allowed between subcommands ([5e2af8c9](https://github.com/clap-rs/clap/commit/5e2af8c96adb5ab75fa2d1536237ebcb41869494), closes [#793](https://github.com/clap-rs/clap/issues/793))
* **DontCollapseArgsInUsage:** disables the collapsing of positional args into `[ARGS]` in the usage string ([c2978afc](https://github.com/clap-rs/clap/commit/c2978afc61fb46d5263ab3b2d87ecde1c9ce1553), closes [#769](https://github.com/clap-rs/clap/issues/769))
* **DisableHelpSubcommand:** disables building the `help` subcommand ([a10fc859](https://github.com/clap-rs/clap/commit/a10fc859ee20159fbd9ff4337be59b76467a64f2))
* **AllowMissingPositional:** allows one to implement `$ prog [optional] <required>` style CLIs where the second positional argument is required, but the first is optional ([1110fdc7](https://github.com/clap-rs/clap/commit/1110fdc7a345c108820dc45783a9bf893fa4c214), closes [#636](https://github.com/clap-rs/clap/issues/636))
* **PropagateGlobalValuesDown:** automatically propagats global arg's values down through *used* subcommands ([985536c8](https://github.com/clap-rs/clap/commit/985536c8ebcc09af98aac835f42a8072ad58c262), closes [#694](https://github.com/clap-rs/clap/issues/694))
chore: increase version
2017-01-04 04:37:44 +00:00
#### API Additions
##### Arg
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Arg::value_terminator:** adds the ability to terminate multiple values with a given string or char ([be64ce0c](https://github.com/clap-rs/clap/commit/be64ce0c373efc106384baca3f487ea99fe7b8cf), closes [#782](https://github.com/clap-rs/clap/issues/782))
* **Arg::default_value_if[s]:** adds new methods for *conditional* default values (such as a particular value from another argument was used) ([eb4010e7](https://github.com/clap-rs/clap/commit/eb4010e7b21724447ef837db11ac441915728f22))
* **Arg::requires_if[s]:** adds the ability to *conditionally* require additional args (such as if a particular value was used) ([198449d6](https://github.com/clap-rs/clap/commit/198449d64393c265f0bc327aaeac23ec4bb97226))
* **Arg::required_if[s]:** adds the ability for an arg to be *conditionally* required (i.e. "arg X is only required if arg Y was used with value Z") ([ee9cfddf](https://github.com/clap-rs/clap/commit/ee9cfddf345a6b5ae2af42ba72aa5c89e2ca7f59))
* **Arg::validator_os:** adds ability to validate values which may contain invalid UTF-8 ([47232498](https://github.com/clap-rs/clap/commit/47232498a813db4f3366ccd3e9faf0bff56433a4))
chore: increase version
2017-01-04 04:37:44 +00:00
##### Macros
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **crate_description!:** Uses the `Cargo.toml` description field to fill in the `App::about` method at compile time ([4d9a82db](https://github.com/clap-rs/clap/commit/4d9a82db8e875e9b64a9c2a5c6e22c25afc1279d), closes [#778](https://github.com/clap-rs/clap/issues/778))
* **crate_name!:** Uses the `Cargo.toml` name field to fill in the `App::new` method at compile time ([4d9a82db](https://github.com/clap-rs/clap/commit/4d9a82db8e875e9b64a9c2a5c6e22c25afc1279d), closes [#778](https://github.com/clap-rs/clap/issues/778))
* **app_from_crate!:** Combines `crate_version!`, `crate_name!`, `crate_description!`, and `crate_authors!` into a single macro call to build a default `App` instance from the `Cargo.toml` fields ([4d9a82db](https://github.com/clap-rs/clap/commit/4d9a82db8e875e9b64a9c2a5c6e22c25afc1279d), closes [#778](https://github.com/clap-rs/clap/issues/778))
chore: increase version
2017-01-04 04:37:44 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **no_cargo:** adds a `no_cargo` feature to disable Cargo-env-var-dependent macros for those *not* using `cargo` to build their crates (#786) ([6fdd2f9d](https://github.com/clap-rs/clap/commit/6fdd2f9d693aaf1118fc61bd362273950703f43d))
chore: increase version
2017-01-04 04:37:44 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Options:** fixes a critical bug where options weren't forced to have a value ([5a5f2b1e](https://github.com/clap-rs/clap/commit/5a5f2b1e9f598a0d0280ef3e98abbbba2bc41132), closes [#665](https://github.com/clap-rs/clap/issues/665))
* fixes a bug where calling the help of a subcommand wasn't ignoring required args of parent commands ([d3d34a2b](https://github.com/clap-rs/clap/commit/d3d34a2b51ef31004055b0ab574f766d801c3adf), closes [#789](https://github.com/clap-rs/clap/issues/789))
* **Help Subcommand:** fixes a bug where the help subcommand couldn't be overridden ([d34ec3e0](https://github.com/clap-rs/clap/commit/d34ec3e032d03e402d8e87af9b2942fe2819b2da), closes [#787](https://github.com/clap-rs/clap/issues/787))
* **Low Index Multiples:** fixes a bug which caused combinations of LowIndexMultiples and `Arg::allow_hyphen_values` to fail parsing ([26c670ca](https://github.com/clap-rs/clap/commit/26c670ca16d2c80dc26d5c1ce83380ace6357318))
chore: increase version
2017-01-04 04:37:44 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Default Values:** improves the error message when default values are involved ([1f33de54](https://github.com/clap-rs/clap/commit/1f33de545036e7fd2f80faba251fca009bd519b8), closes [#774](https://github.com/clap-rs/clap/issues/774))
* **YAML:** adds conditional requirements and conditional default values to YAML ([9a4df327](https://github.com/clap-rs/clap/commit/9a4df327893486adb5558ffefba790c634ccdc6e), closes [#764](https://github.com/clap-rs/clap/issues/764))
* Support `--("some-arg-name")` syntax for defining long arg names when using `clap_app!` macro ([f41ec962](https://github.com/clap-rs/clap/commit/f41ec962c243a5ffff8b1be1ae2ad63970d3d1d4))
* Support `("some app name")` syntax for defining app names when using `clap_app!` macro ([9895b671](https://github.com/clap-rs/clap/commit/9895b671cff784f35cf56abcd8270f7c2ba09699), closes [#759](https://github.com/clap-rs/clap/issues/759))
* **Help Wrapping:** long app names (with spaces), authors, and descriptions are now wrapped appropriately ([ad4691b7](https://github.com/clap-rs/clap/commit/ad4691b71a63e951ace346318238d8834e04ad8a), closes [#777](https://github.com/clap-rs/clap/issues/777))
chore: increase version
2017-01-04 04:37:44 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Conditional Default Values:** fixes the failing doc tests of Arg::default_value_ifs ([4ef09101](https://github.com/clap-rs/clap/commit/4ef091019c083b4db1a0c13f1c1e95ac363259f2))
* **Conditional Requirements:** adds docs for Arg::requires_ifs ([7f296e29](https://github.com/clap-rs/clap/commit/7f296e29db7d9036e76e5dbcc9c8b20dfe7b25bd))
* **README.md:** fix some typos ([f22c21b4](https://github.com/clap-rs/clap/commit/f22c21b422d5b287d1a1ac183a379ee02eebf54f))
* **src/app/mod.rs:** fix some typos ([5c9b0d47](https://github.com/clap-rs/clap/commit/5c9b0d47ca78dea285c5b9dec79063d24c3e451a))
chore: increase version
2017-01-04 04:37:44 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.19.3 (2016-12-28)
chore: increase version
2016-12-28 09:25:08 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes a bug where calling the help of a subcommand wasn't ignoring required args of parent commands ([a0ee4993](https://github.com/clap-rs/clap/commit/a0ee4993015ea97b06b5bc9f378d8bcb18f1c51c), closes [#789](https://github.com/clap-rs/clap/issues/789))
chore: increase version
2016-12-28 09:25:08 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.19.2 (2016-12-08)
chore: increase version
2016-12-08 20:41:03 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **ZSH Completions:** escapes square brackets in ZSH completions ([7e17d5a3](https://github.com/clap-rs/clap/commit/7e17d5a36b2cc2cc77e7b15796b14d639ed3cbf7), closes [#771](https://github.com/clap-rs/clap/issues/771))
chore: increase version
2016-12-08 20:41:03 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Examples:** adds subcommand examples ([0e0f3354](https://github.com/clap-rs/clap/commit/0e0f33547a6901425afc1d9fbe19f7ae3832d9a4), closes [#766](https://github.com/clap-rs/clap/issues/766))
* **README.md:** adds guidance on when to use ~ in version pinning, and clarifies breaking change policy ([591eaefc](https://github.com/clap-rs/clap/commit/591eaefc7319142ba921130e502bb0729feed907), closes [#765](https://github.com/clap-rs/clap/issues/765))
chore: increase version
2016-12-08 20:41:03 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.19.1 (2016-12-01)
chore: increase version
2016-12-01 23:53:26 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Messages:** fixes help message alignment when specific settings are used on options ([cd94b318](https://github.com/clap-rs/clap/commit/cd94b3188d63b63295a319e90e826bca46befcd2), closes [#760](https://github.com/clap-rs/clap/issues/760))
chore: increase version
2016-12-01 23:53:26 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Bash Completion:** allows bash completion to fall back to traditional bash completion upon no matching completing function ([b1b16d56](https://github.com/clap-rs/clap/commit/b1b16d56d8fddf819bdbe24b3724bb6a9f3fa613)))
chore: increase version
2016-12-01 23:53:26 +00:00
chore: increase version
2016-11-21 02:00:26 +00:00
## v2.19.0 (2016-11-21)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* allows specifying AllowLeadingHyphen style values, but only for specific args vice command wide ([c0d70feb](https://github.com/clap-rs/clap/commit/c0d70febad9996a77a54107054daf1914c50d4ef), closes [#742](https://github.com/clap-rs/clap/issues/742))
chore: increase version
2016-11-21 02:00:26 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Required Unless:** fixes a bug where having required_unless set doesn't work when conflicts are also set ([d20331b6](https://github.com/clap-rs/clap/commit/d20331b6f7940ac3a4e919999f8bb4780875125d), closes [#753](https://github.com/clap-rs/clap/issues/753))
* **ZSH Completions:** fixes an issue where zsh completions caused panics if there were no subcommands ([49e7cdab](https://github.com/clap-rs/clap/commit/49e7cdab76dd1ccc07221e360f07808ec62648aa), closes [#754](https://github.com/clap-rs/clap/issues/754))
chore: increase version
2016-11-21 02:00:26 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Validators:** improves the error messages for validators ([65eb3385](https://github.com/clap-rs/clap/commit/65eb33859d3ff53e7d3277f02a9d3fd9038a9dfb), closes [#744](https://github.com/clap-rs/clap/issues/744))
chore: increase version
2016-11-21 02:00:26 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* updates the docs landing page ([01e1e33f](https://github.com/clap-rs/clap/commit/01e1e33f377934099a4a725fab5cd6c5ff50eaa2))
* adds the macro version back to the readme ([45eb9bf1](https://github.com/clap-rs/clap/commit/45eb9bf130329c3f3853aba0342c2fe3c64ff80f))
* fix broken docs links ([808e7cee](https://github.com/clap-rs/clap/commit/808e7ceeb86d4a319bdc270f51c23a64621dbfb3))
* **Compatibility Policy:** adds an official compatibility policy to ([760d66dc](https://github.com/clap-rs/clap/commit/760d66dc17310b357f257776624151da933cd25d), closes [#740](https://github.com/clap-rs/clap/issues/740))
* **Contributing:** updates the readme to improve the readability and contributing sections ([eb51316c](https://github.com/clap-rs/clap/commit/eb51316cdfdc7258d287ba13b67ef2f42bd2b8f6))
chore: increase version
2016-11-21 02:00:26 +00:00
chore: increase version
2016-11-05 23:58:30 +00:00
## v2.18.0 (2016-11-05)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Completions:** adds completion support for PowerShell. ([cff82c88](https://github.com/clap-rs/clap/commit/cff82c880e21064fca63351507b80350df6caadf), closes [#729](https://github.com/clap-rs/clap/issues/729))
chore: increase version
2016-11-05 23:58:30 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.17.1 (2016-11-02)
chore: increase version
2016-11-02 03:33:53 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Low Index Multiples:** fixes a bug where using low index multiples was propagated to subcommands ([33924e88](https://github.com/clap-rs/clap/commit/33924e884461983c4e6b5ea1330fecc769a4ade7), closes [#725](https://github.com/clap-rs/clap/issues/725))
chore: increase version
2016-11-02 03:33:53 +00:00
chore: increase version
2016-11-01 20:28:15 +00:00
## v2.17.0 (2016-11-01)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Positional Args:** allows specifying the second to last positional argument as multiple(true) ([1ced2a74](https://github.com/clap-rs/clap/commit/1ced2a7433ea8937a1b260ea65d708f32ca7c95e), closes [#725](https://github.com/clap-rs/clap/issues/725))
chore: increase version
2016-11-01 20:28:15 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.16.4 (2016-10-31)
chore: increase version
2016-10-31 04:41:14 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Error Output:** conflicting errors are now symmetrical, meaning more consistent and less confusing ([3d37001d](https://github.com/clap-rs/clap/commit/3d37001d1dc647d73cc597ff172f1072d4beb80d), closes [#718](https://github.com/clap-rs/clap/issues/718))
chore: increase version
2016-10-31 04:41:14 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Fix typo in example `13a_enum_values_automatic` ([c22fbc07](https://github.com/clap-rs/clap/commit/c22fbc07356e556ffb5d1a79ec04597d149b915e))
* **README.md:** fixes failing yaml example (#715) ([21fba9e6](https://github.com/clap-rs/clap/commit/21fba9e6cd8c163012999cd0ce271ec8780c5695))
chore: increase version
2016-10-31 04:41:14 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **ZSH Completions:** fixes bug that caused panic on subcommands with aliases ([5c70e1a0](https://github.com/clap-rs/clap/commit/5c70e1a01bc977e44c10015d18bb8e215c32dfc8), closes [#714](https://github.com/clap-rs/clap/issues/714))
* **debug:** fixes the debug feature (#716) ([6c11ccf4](https://github.com/clap-rs/clap/commit/6c11ccf443d46258d51f7cda33fbcc81e7fe8e90))
chore: increase version
2016-10-31 04:41:14 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.16.3 (2016-10-28)
chore: increase version
2016-10-28 02:03:46 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Derive display order after propagation ([9cb6facf](https://github.com/clap-rs/clap/commit/9cb6facf507aff7cddd124b8c29714d2b0e7bd13), closes [#706](https://github.com/clap-rs/clap/issues/706))
* **yaml-example:** inconsistent args ([847f7199](https://github.com/clap-rs/clap/commit/847f7199219ead5065561d91d64780d99ae4b587))
chore: increase version
2016-10-28 02:03:46 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.16.2 (2016-10-25)
chore: increase version
2016-10-25 14:37:57 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Fish Completions:** fixes a bug where single quotes are not escaped ([780b4a18](https://github.com/clap-rs/clap/commit/780b4a18281b6f7f7071e1b9db2290fae653c406), closes [#704](https://github.com/clap-rs/clap/issues/704))
chore: increase version
2016-10-25 14:37:57 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.16.1 (2016-10-24)
chore: increase version
2016-10-24 09:59:07 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Message:** fixes a regression bug where args with multiple(true) threw off alignment ([ebddac79](https://github.com/clap-rs/clap/commit/ebddac791f3ceac193d5ad833b4b734b9643a7af), closes [#702](https://github.com/clap-rs/clap/issues/702))
chore: increase version
2016-10-24 09:59:07 +00:00
chore: increase version
2016-10-23 23:36:51 +00:00
## v2.16.0 (2016-10-23)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Completions:** adds ZSH completion support ([3e36b0ba](https://github.com/clap-rs/clap/commit/3e36b0bac491d3f6194aee14604caf7be26b3d56), closes [#699](https://github.com/clap-rs/clap/issues/699))
chore: increase version
2016-10-23 23:36:51 +00:00
chore: increase version
2016-10-21 17:28:24 +00:00
## v2.15.0 (2016-10-21)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **AppSettings:** adds new setting `AppSettings::AllowNegativeNumbers` ([ab064546](https://github.com/clap-rs/clap/commit/ab06454677fb6aa9b9f804644fcca2168b1eaee3), closes [#696](https://github.com/clap-rs/clap/issues/696))
chore: increase version
2016-10-21 17:28:24 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **app/settings.rs:** moves variants to roughly alphabetical order ([9ed4d4d7](https://github.com/clap-rs/clap/commit/9ed4d4d7957a23357aef60081e45639ab9e3905f))
chore: increase version
2016-10-21 17:28:24 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.14.1 (2016-10-20)
chore: update version
2016-10-20 23:47:51 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Improve documentation around features ([4ee85b95](https://github.com/clap-rs/clap/commit/4ee85b95d2d16708a016a3ba4e6e2c93b89b7fad))
* reword docs for ErrorKind and app::Settings ([3ccde7a4](https://github.com/clap-rs/clap/commit/3ccde7a4b8f7a2ea8b916a5415c04a8ff4b5cb7a))
* fix tests that fail when the "suggestions" feature is disabled ([996fc381](https://github.com/clap-rs/clap/commit/996fc381763a48d125c7ea8a58fed057fd0b4ac6))
* fix the OsString-using doc-tests ([af9e1a39](https://github.com/clap-rs/clap/commit/af9e1a393ce6cdda46a03c8a4f48df222b015a24))
* tag non-rust code blocks as such instead of ignoring them ([0ba9f4b1](https://github.com/clap-rs/clap/commit/0ba9f4b123f281952581b6dec948f7e51dd22890))
* **ErrorKind:** improve some errors about subcommands ([9f6217a4](https://github.com/clap-rs/clap/commit/9f6217a424da823343d7b801b9c350dee3cd1906))
* **yaml:** make sure the doc-tests don't fail before "missing file" ([8c0f5551](https://github.com/clap-rs/clap/commit/8c0f55516f4910c78c9f8a2bdbd822729574f95b))
chore: update version
2016-10-20 23:47:51 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Stabilize clap_app! ([cd516006](https://github.com/clap-rs/clap/commit/cd516006e35c37b005f329338560a0a53d1f3e00))
* **with_defaults:** Deprecate App::with_defaults() ([26085409](https://github.com/clap-rs/clap/commit/2608540940c8bb66e517b65706bc7dea55510682), closes [#638](https://github.com/clap-rs/clap/issues/638))
chore: update version
2016-10-20 23:47:51 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes a bug that made determining when to auto-wrap long help messages inconsistent ([468baadb](https://github.com/clap-rs/clap/commit/468baadb8398fc1d37897b0c49374aef4cf97dca), closes [#688](https://github.com/clap-rs/clap/issues/688))
* **Completions:** fish completions for nested subcommands ([a61eaf8a](https://github.com/clap-rs/clap/commit/a61eaf8aade76cfe90ccc0f7125751ebf60e3254))
* **features:** Make lints not enable other nightly-requiring features ([835f75e3](https://github.com/clap-rs/clap/commit/835f75e3ba20999117363ed9f916464d777f36ef))
chore: update version
2016-10-20 23:47:51 +00:00
chore: increase version
2016-10-05 01:20:35 +00:00
## v2.14.0 (2016-10-05)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **arg_aliases:** Ability to alias arguments ([33b5f6ef](https://github.com/clap-rs/clap/commit/33b5f6ef2c9612ecabb31f96b824793e46bfd3dd), closes [#669](https://github.com/clap-rs/clap/issues/669))
* **flag_aliases:** Ability to alias flags ([40d6dac9](https://github.com/clap-rs/clap/commit/40d6dac973927dded6ab423481634ef47ee7bfd7))
chore: increase version
2016-10-05 01:20:35 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **UsageParser:** Handle non-ascii names / options. ([1d6a7c6e](https://github.com/clap-rs/clap/commit/1d6a7c6e7e6aadc527346aa822f19d8587f714f3), closes [#664](https://github.com/clap-rs/clap/issues/664))
chore: increase version
2016-10-05 01:20:35 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* typo ([bac417fa](https://github.com/clap-rs/clap/commit/bac417fa1cea3d32308334c7cccfcf54546cd9d8))
chore: increase version
2016-10-05 01:20:35 +00:00
chore: increase version
2016-09-18 19:52:50 +00:00
## v2.13.0 (2016-09-18)
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* updates README.md with new website information and updated video tutorials info ([0c19c580](https://github.com/clap-rs/clap/commit/0c19c580cf50f1b82ff32f70b36708ae2bcac132))
* updates the docs about removing implicit value_delimiter(true) ([c81bc722](https://github.com/clap-rs/clap/commit/c81bc722ebb8a86d22be89b5aec98df9fe222a08))
* **Default Values:** adds better examples on using default values ([57a8d9ab](https://github.com/clap-rs/clap/commit/57a8d9abb2f973c235a8a14f8fc031673d7a7460), closes [#418](https://github.com/clap-rs/clap/issues/418))
chore: increase version
2016-09-18 19:52:50 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Value Delimiters:** fixes the confusion around implicitly setting value delimiters. (default is now `false`) ([09d4d0a9](https://github.com/clap-rs/clap/commit/09d4d0a9038d7ce2df55c2aec95e16f36189fcee), closes [#666](https://github.com/clap-rs/clap/issues/666))
chore: increase version
2016-09-18 19:52:50 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.12.1 (2016-09-13)
chore: increase version
2016-09-13 03:28:12 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Wrapping:** fixes a regression-bug where the old {n} newline char stopped working ([92ac353b](https://github.com/clap-rs/clap/commit/92ac353b48b7caa2511ad2a046d94da93c236cf6), closes [#661](https://github.com/clap-rs/clap/issues/661))
chore: increase version
2016-09-13 03:28:12 +00:00
chore: increase version
2016-09-13 01:59:46 +00:00
## v2.12.0 (2016-09-13)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help:** adds ability to hide the possible values on a per argument basis ([9151ef73](https://github.com/clap-rs/clap/commit/9151ef739871f2e74910c342299c0de196b95dec), closes [#640](https://github.com/clap-rs/clap/issues/640))
* **help:** allow for limiting detected terminal width ([a43e28af](https://github.com/clap-rs/clap/commit/a43e28af85c9a9deaedd5ef735f4f13008daab29), closes [#653](https://github.com/clap-rs/clap/issues/653))
chore: increase version
2016-09-13 01:59:46 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Wrapping:** removes the verbage about using `'{n}'` to insert newlines in help text ([c5a2b352](https://github.com/clap-rs/clap/commit/c5a2b352ca600f5b802290ad945731066cd53611))
* **Value Delimiters:** updates the docs for the Arg::multiple method WRT value delimiters and default settings ([f9d17a06](https://github.com/clap-rs/clap/commit/f9d17a060aa53f10d0a6e1a7eed5d989d1a59533))
* **appsettings:** Document AppSetting::DisableVersion ([94501965](https://github.com/clap-rs/clap/commit/945019654d2ca67eb2b1d6014fdf80b84d528d30), closes [#589](https://github.com/clap-rs/clap/issues/589))
chore: increase version
2016-09-13 01:59:46 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **AllowLeadingHyphen:** fixes a bug where valid args aren't recognized with this setting ([a9699e4d](https://github.com/clap-rs/clap/commit/a9699e4d7cdc9a06e73b845933ff1fe6d76f016a), closes [#588](https://github.com/clap-rs/clap/issues/588))
chore: increase version
2016-09-13 01:59:46 +00:00
#### Improvements
* **Help Wrapping:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* clap now ignores hard newlines in help messages and properly re-aligns text, but still wraps if the term width is too small ([c7678523](https://github.com/clap-rs/clap/commit/c76785239fd42adc8ca04f9202b6fec615aa9f14), closes [#617](https://github.com/clap-rs/clap/issues/617))
* makes some minor changes to when next line help is automatically used ([01cae799](https://github.com/clap-rs/clap/commit/01cae7990a33167ac35103fb36c811b4fe6eb98f))
* **Value Delimiters:** changes the default value delimiter rules ([f9e69254](https://github.com/clap-rs/clap/commit/f9e692548e8c94de15f909432de301407d6bb834), closes [#655](https://github.com/clap-rs/clap/issues/655))
* **YAML:** supports setting Arg::require_delimiter from YAML ([b9b55a39](https://github.com/clap-rs/clap/commit/b9b55a39dfebcdbdc05dca2692927e503db50816))
chore: increase version
2016-09-13 01:59:46 +00:00
#### Performance
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **help:** fix redundant contains() checks ([a8afed74](https://github.com/clap-rs/clap/commit/a8afed7428bf0733f8e93bb11ad6c00d9e970fcc))
chore: increase version
2016-09-13 01:59:46 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.11.3 (2016-09-07)
chore: increase version
2016-09-07 21:40:38 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Wrapping:** removes the verbage about using `'{n}'` to insert newlines in help text ([c5a2b352](https://github.com/clap-rs/clap/commit/c5a2b352ca600f5b802290ad945731066cd53611))
chore: increase version
2016-09-07 21:40:38 +00:00
#### Improvements
* **Help Wrapping:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* clap now ignores hard newlines in help messages and properly re-aligns text, but still wraps if the term width is too small ([c7678523](https://github.com/clap-rs/clap/commit/c76785239fd42adc8ca04f9202b6fec615aa9f14), closes [#617](https://github.com/clap-rs/clap/issues/617))
* makes some minor changes to when next line help is automatically used ([01cae799](https://github.com/clap-rs/clap/commit/01cae7990a33167ac35103fb36c811b4fe6eb98f))
* **YAML:** supports setting Arg::require_delimiter from YAML ([b9b55a39](https://github.com/clap-rs/clap/commit/b9b55a39dfebcdbdc05dca2692927e503db50816))
chore: increase version
2016-09-07 21:40:38 +00:00
chore: increase version
2016-09-06 00:16:09 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.11.2 (2016-09-06)
chore: increase version
2016-09-06 00:16:09 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Wrapping:** makes some minor changes to when next line help is automatically used ([5658b117](https://github.com/clap-rs/clap/commit/5658b117aec3e03adff9c8c52a4c4bc1fcb4e1ff))
chore: increase version
2016-09-06 00:16:09 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.11.1 (2016-09-05)
chore: increase version
2016-09-05 21:06:41 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Settings:** fixes an issue where settings weren't propagated down through grandchild subcommands ([b3efc107](https://github.com/clap-rs/clap/commit/b3efc107515d78517b20798ff3890b8a2b04498e), closes [#638](https://github.com/clap-rs/clap/issues/638))
chore: increase version
2016-09-05 21:06:41 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Errors:** Errors with custom description ([58512f2f](https://github.com/clap-rs/clap/commit/58512f2fcb430745f1ee6ee8f1c67f62dc216c73))
chore: increase version
2016-09-05 21:06:41 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **help:** use term_size instead of home-grown solution ([fc7327e9](https://github.com/clap-rs/clap/commit/fc7327e9dcf4258ef2baebf0a8714d9c0622855b))
chore: increase version
2016-09-05 21:06:41 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.11.0 (2016-08-28)
Issues rollup (#637) * feat: adds App::with_defaults to automatically use crate_authors! and crate_version! macros One can now use ```rust let a = App::with_defaults("My Program"); // same as let a2 = App::new("My Program") .version(crate_version!()) .author(crate_authors!()); ``` Closes #600 * imp(YAML Errors): vastly improves error messages when using YAML When errors are made while developing, the panic error messages have been improved instead of relying on the default panic message which is extremely unhelpful. Closes #574 * imp(Completions): uses standard conventions for bash completion files, namely '{bin}.bash-completion' Closes #567 * imp(Help): automatically moves help text to the next line and wraps when term width is determined to be too small, or help text is too long Now `clap` will check if it should automatically place long help messages on the next line after the flag/option. This is determined by checking to see if the space taken by flag/option plus spaces and values doesn't leave enough room for the entirety of the help message, with the single exception of of if the flag/option/spaces/values is less than 25% of the width. Closes #597 * tests: updates help tests to new forced new line rules * fix(Groups): fixes some usage strings that contain both args in groups and ones that conflict with each other Args that conflict *and* are in a group will now only display in the group and not in the usage string itself. Closes #616 * chore: updates dep graph Closes #633 * chore: clippy run * style: changes debug header to match other Rust projects * chore: increase version
2016-08-28 03:42:31 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Groups:** fixes some usage strings that contain both args in groups and ones that conflict with each other ([3d782def](https://github.com/clap-rs/clap/commit/3d782def57725e2de26ca5a5bc5cc2e40ddebefb), closes [#616](https://github.com/clap-rs/clap/issues/616))
Issues rollup (#637) * feat: adds App::with_defaults to automatically use crate_authors! and crate_version! macros One can now use ```rust let a = App::with_defaults("My Program"); // same as let a2 = App::new("My Program") .version(crate_version!()) .author(crate_authors!()); ``` Closes #600 * imp(YAML Errors): vastly improves error messages when using YAML When errors are made while developing, the panic error messages have been improved instead of relying on the default panic message which is extremely unhelpful. Closes #574 * imp(Completions): uses standard conventions for bash completion files, namely '{bin}.bash-completion' Closes #567 * imp(Help): automatically moves help text to the next line and wraps when term width is determined to be too small, or help text is too long Now `clap` will check if it should automatically place long help messages on the next line after the flag/option. This is determined by checking to see if the space taken by flag/option plus spaces and values doesn't leave enough room for the entirety of the help message, with the single exception of of if the flag/option/spaces/values is less than 25% of the width. Closes #597 * tests: updates help tests to new forced new line rules * fix(Groups): fixes some usage strings that contain both args in groups and ones that conflict with each other Args that conflict *and* are in a group will now only display in the group and not in the usage string itself. Closes #616 * chore: updates dep graph Closes #633 * chore: clippy run * style: changes debug header to match other Rust projects * chore: increase version
2016-08-28 03:42:31 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* moves docs to docs.rs ([03209d5e](https://github.com/clap-rs/clap/commit/03209d5e1300906f00bafec1869c2047a92e5071), closes [#634](https://github.com/clap-rs/clap/issues/634))
Issues rollup (#637) * feat: adds App::with_defaults to automatically use crate_authors! and crate_version! macros One can now use ```rust let a = App::with_defaults("My Program"); // same as let a2 = App::new("My Program") .version(crate_version!()) .author(crate_authors!()); ``` Closes #600 * imp(YAML Errors): vastly improves error messages when using YAML When errors are made while developing, the panic error messages have been improved instead of relying on the default panic message which is extremely unhelpful. Closes #574 * imp(Completions): uses standard conventions for bash completion files, namely '{bin}.bash-completion' Closes #567 * imp(Help): automatically moves help text to the next line and wraps when term width is determined to be too small, or help text is too long Now `clap` will check if it should automatically place long help messages on the next line after the flag/option. This is determined by checking to see if the space taken by flag/option plus spaces and values doesn't leave enough room for the entirety of the help message, with the single exception of of if the flag/option/spaces/values is less than 25% of the width. Closes #597 * tests: updates help tests to new forced new line rules * fix(Groups): fixes some usage strings that contain both args in groups and ones that conflict with each other Args that conflict *and* are in a group will now only display in the group and not in the usage string itself. Closes #616 * chore: updates dep graph Closes #633 * chore: clippy run * style: changes debug header to match other Rust projects * chore: increase version
2016-08-28 03:42:31 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Completions:** uses standard conventions for bash completion files, namely '{bin}.bash-completion' ([27f5bbfb](https://github.com/clap-rs/clap/commit/27f5bbfbcc9474c2f57c2b92b1feb898ae46ee70), closes [#567](https://github.com/clap-rs/clap/issues/567))
* **Help:** automatically moves help text to the next line and wraps when term width is determined to be too small, or help text is too long ([150964c4](https://github.com/clap-rs/clap/commit/150964c4e7124d54476c9d9b4b3f2406f0fd00e5), closes [#597](https://github.com/clap-rs/clap/issues/597))
* **YAML Errors:** vastly improves error messages when using YAML ([f43b7c65](https://github.com/clap-rs/clap/commit/f43b7c65941c53adc0616b8646a21dc255862eb2), closes [#574](https://github.com/clap-rs/clap/issues/574))
Issues rollup (#637) * feat: adds App::with_defaults to automatically use crate_authors! and crate_version! macros One can now use ```rust let a = App::with_defaults("My Program"); // same as let a2 = App::new("My Program") .version(crate_version!()) .author(crate_authors!()); ``` Closes #600 * imp(YAML Errors): vastly improves error messages when using YAML When errors are made while developing, the panic error messages have been improved instead of relying on the default panic message which is extremely unhelpful. Closes #574 * imp(Completions): uses standard conventions for bash completion files, namely '{bin}.bash-completion' Closes #567 * imp(Help): automatically moves help text to the next line and wraps when term width is determined to be too small, or help text is too long Now `clap` will check if it should automatically place long help messages on the next line after the flag/option. This is determined by checking to see if the space taken by flag/option plus spaces and values doesn't leave enough room for the entirety of the help message, with the single exception of of if the flag/option/spaces/values is less than 25% of the width. Closes #597 * tests: updates help tests to new forced new line rules * fix(Groups): fixes some usage strings that contain both args in groups and ones that conflict with each other Args that conflict *and* are in a group will now only display in the group and not in the usage string itself. Closes #616 * chore: updates dep graph Closes #633 * chore: clippy run * style: changes debug header to match other Rust projects * chore: increase version
2016-08-28 03:42:31 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* adds App::with_defaults to automatically use crate_authors! and crate_version! macros ([5520bb01](https://github.com/clap-rs/clap/commit/5520bb012c127dfd299fd55699443c744d8dcd5b), closes [#600](https://github.com/clap-rs/clap/issues/600))
Issues rollup (#637) * feat: adds App::with_defaults to automatically use crate_authors! and crate_version! macros One can now use ```rust let a = App::with_defaults("My Program"); // same as let a2 = App::new("My Program") .version(crate_version!()) .author(crate_authors!()); ``` Closes #600 * imp(YAML Errors): vastly improves error messages when using YAML When errors are made while developing, the panic error messages have been improved instead of relying on the default panic message which is extremely unhelpful. Closes #574 * imp(Completions): uses standard conventions for bash completion files, namely '{bin}.bash-completion' Closes #567 * imp(Help): automatically moves help text to the next line and wraps when term width is determined to be too small, or help text is too long Now `clap` will check if it should automatically place long help messages on the next line after the flag/option. This is determined by checking to see if the space taken by flag/option plus spaces and values doesn't leave enough room for the entirety of the help message, with the single exception of of if the flag/option/spaces/values is less than 25% of the width. Closes #597 * tests: updates help tests to new forced new line rules * fix(Groups): fixes some usage strings that contain both args in groups and ones that conflict with each other Args that conflict *and* are in a group will now only display in the group and not in the usage string itself. Closes #616 * chore: updates dep graph Closes #633 * chore: clippy run * style: changes debug header to match other Rust projects * chore: increase version
2016-08-28 03:42:31 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.10.4 (2016-08-25)
chore: increase version
2016-08-25 22:52:15 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Wrapping:** fixes a bug where help is wrapped incorrectly and causing a panic with some non-English characters ([d0b442c7](https://github.com/clap-rs/clap/commit/d0b442c7beeecac9764406bc3bd171ced0b8825e), closes [#626](https://github.com/clap-rs/clap/issues/626))
chore: increase version
2016-08-25 22:52:15 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.10.3 (2016-08-25)
chore: increase version
2016-08-25 01:55:01 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help:** adds new short hand way to use source formatting and ignore term width in help messages ([7dfdaf20](https://github.com/clap-rs/clap/commit/7dfdaf200ebb5c431351a045b48f5e0f0d3f31db), closes [#625](https://github.com/clap-rs/clap/issues/625))
chore: increase version
2016-08-25 01:55:01 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Term Width:** adds details about set_term_width(0) ([00b8205d](https://github.com/clap-rs/clap/commit/00b8205d22639d1b54b9c453c55c785aace52cb2))
chore: increase version
2016-08-25 01:55:01 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Unicode:** fixes two bugs where non-English characters were stripped or caused a panic with help wrapping ([763a5c92](https://github.com/clap-rs/clap/commit/763a5c920e23efc74d190af0cb8b5dd714b2d67a), closes [#626](https://github.com/clap-rs/clap/issues/626))
chore: increase version
2016-08-25 01:55:01 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.10.2 (2016-08-22)
chore: increase version
2016-08-22 00:46:57 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes a bug where the help is printed twice ([a643fb28](https://github.com/clap-rs/clap/commit/a643fb283acd9905dc727c4579c5c9fa2ceaa7e7), closes [#623](https://github.com/clap-rs/clap/issues/623))
chore: increase version
2016-08-22 00:46:57 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.10.1 (2016-08-21)
chore: increase version
2016-08-21 00:11:11 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Subcommand:** fixes misleading usage string when using multi-level subcommmands ([e203515e](https://github.com/clap-rs/clap/commit/e203515e3ac495b405dbba4f78fb6af148fd282e), closes [#618](https://github.com/clap-rs/clap/issues/618))
chore: increase version
2016-08-21 00:11:11 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **YAML:** allows using lists or single values with arg declarations ([9ade2cd4](https://github.com/clap-rs/clap/commit/9ade2cd4b268d6d7fe828319ce6a523c641b9c38), closes [#614](https://github.com/clap-rs/clap/issues/614), [#613](https://github.com/clap-rs/clap/issues/613))
chore: increase version
2016-08-21 00:11:11 +00:00
chore: increase version
2016-07-29 02:28:47 +00:00
## v2.10.0 (2016-07-29)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Completions:** one can generate a basic fish completions script at compile time ([1979d2f2](https://github.com/clap-rs/clap/commit/1979d2f2f3216e57d02a97e624a8a8f6cf867ed9))
chore: increase version
2016-07-29 02:28:47 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **parser:** preserve external subcommand name ([875df243](https://github.com/clap-rs/clap/commit/875df24316c266920a073c13bbefbf546bc1f635))
chore: increase version
2016-07-29 02:28:47 +00:00
#### Breaking Changes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **parser:** preserve external subcommand name ([875df243](https://github.com/clap-rs/clap/commit/875df24316c266920a073c13bbefbf546bc1f635))
chore: increase version
2016-07-29 02:28:47 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **YAML:** fixes example 17's incorrect reference to arg_groups instead of groups ([b6c99e13](https://github.com/clap-rs/clap/commit/b6c99e1377f918e78c16c8faced70a71607da931), closes [#601](https://github.com/clap-rs/clap/issues/601))
chore: increase version
2016-07-29 02:28:47 +00:00
chore: increase version (#599)
2016-07-24 04:13:00 +00:00
### 2.9.3 (2016-07-24)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes bug where only first arg in list of required_unless_one is recognized ([1fc3b55b](https://github.com/clap-rs/clap/commit/1fc3b55bd6c8653b02e7c4253749c6b77737d2ac), closes [#575](https://github.com/clap-rs/clap/issues/575))
* **Settings:** fixes typo subcommandsrequired->subcommandrequired ([fc72cdf5](https://github.com/clap-rs/clap/commit/fc72cdf591d30f5d9375d0b5cc2a2ff3e812f9f6), closes [#593](https://github.com/clap-rs/clap/issues/593))
chore: increase version (#599)
2016-07-24 04:13:00 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Completions:** adds the ability to generate completions to io::Write object ([9f62cf73](https://github.com/clap-rs/clap/commit/9f62cf7378ba5acb5ce8c5bac89b4aa60c30755f))
* **Settings:** Add unset_setting and unset_settings fns to App (#598) ([0ceba231](https://github.com/clap-rs/clap/commit/0ceba231c6767cd6d88fdb1feeeea41deadf77ff), closes [#590](https://github.com/clap-rs/clap/issues/590))
chore: increase version (#599)
2016-07-24 04:13:00 +00:00
chore: increase version
2016-07-03 14:54:50 +00:00
### 2.9.2 (2016-07-03)
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Completions:** fixes the formatting of the Cargo.toml excerpt in the completions example ([722f2607](https://github.com/clap-rs/clap/commit/722f2607beaef56b6a0e433db5fd09492d9f028c))
chore: increase version
2016-07-03 14:54:50 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Completions:** fixes bug where --help and --version short weren't added to the completion list ([e9f2438e](https://github.com/clap-rs/clap/commit/e9f2438e2ce99af0ae570a2eaf541fc7f55b771b), closes [#536](https://github.com/clap-rs/clap/issues/536))
chore: increase version
2016-07-03 14:54:50 +00:00
chore: increase version
2016-07-02 02:16:47 +00:00
### 2.9.1 (2016-07-02)
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Completions:** allows multiple completions to be built by namespacing with bin name ([57484b2d](https://github.com/clap-rs/clap/commit/57484b2daeaac01c1026e8c84efc8bf099e0eb31))
chore: increase version
2016-07-02 02:16:47 +00:00
chore: increase version
2016-07-01 04:25:01 +00:00
## v2.9.0 (2016-07-01)
#### Documentation
chore: updates readme and changelog
2016-07-01 17:07:08 +00:00
* **Completions:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes some errors in the completion docs ([9b359bf0](https://github.com/clap-rs/clap/commit/9b359bf06255d3dad8f489308044b60a9d1e6a87))
* adds documentation for completion scripts ([c6c519e4](https://github.com/clap-rs/clap/commit/c6c519e40efd6c4533a9ef5efe8e74fd150391b7))
chore: increase version
2016-07-01 04:25:01 +00:00
#### Features
chore: updates readme and changelog
2016-07-01 17:07:08 +00:00
* **Completions:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* one can now generate a bash completions script at compile time! ([e75b6c7b](https://github.com/clap-rs/clap/commit/e75b6c7b75f729afb9eb1d2a2faf61dca7674634), closes [#376](https://github.com/clap-rs/clap/issues/376))
* completions now include aliases to subcommands, including all subcommand options ([0ab9f840](https://github.com/clap-rs/clap/commit/0ab9f84052a8cf65b5551657f46c0c270841e634), closes [#556](https://github.com/clap-rs/clap/issues/556))
* completions now continue completing even after first completion ([18fc2e5b](https://github.com/clap-rs/clap/commit/18fc2e5b5af63bf54a94b72cec5e1223d49f4806))
* allows matching on possible values in options ([89cc2026](https://github.com/clap-rs/clap/commit/89cc2026ba9ac69cf44c5254360bbf99236d4f89), closes [#557](https://github.com/clap-rs/clap/issues/557))
chore: increase version
2016-07-01 04:25:01 +00:00
chore: updates changelog and readme for release
2016-07-01 17:51:59 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **AllowLeadingHyphen:** fixes an issue where isn't ignored like it should be with this setting ([96c24c9a](https://github.com/clap-rs/clap/commit/96c24c9a8fa1f85e06138d3cdd133e51659e19d2), closes [#558](https://github.com/clap-rs/clap/issues/558))
chore: updates changelog and readme for release
2016-07-01 17:51:59 +00:00
chore: increase version
2016-06-30 03:25:14 +00:00
## v2.8.0 (2016-06-30)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Arg:** adds new setting `Arg::require_delimiter` which requires val delimiter to parse multiple values ([920b5595](https://github.com/clap-rs/clap/commit/920b5595ed72abfb501ce054ab536067d8df2a66))
chore: increase version
2016-06-30 03:25:14 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Declare term::Winsize as repr(C) ([5d663d90](https://github.com/clap-rs/clap/commit/5d663d905c9829ce6e7a164f1f0896cdd70236dd))
chore: increase version
2016-06-30 03:25:14 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Arg:** adds docs for ([49af4e38](https://github.com/clap-rs/clap/commit/49af4e38a5dae2ab0a7fc3b4147e2c053d532484))
chore: increase version
2016-06-30 03:25:14 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.7.1 (2016-06-29)
chore: increase version
2016-06-29 17:34:18 +00:00
#### Bug Fixes
* **Options:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* options with multiple values and using delimiters no longer parse additional values after a trailing space ([cdc500bd](https://github.com/clap-rs/clap/commit/cdc500bdde6abe238c36ade406ddafc2bafff583))
* using options with multiple values and with an = no longer parse args after the trailing space as values ([290f61d0](https://github.com/clap-rs/clap/commit/290f61d07177413cf082ada55526d83405f6d011))
chore: increase version
2016-06-29 17:34:18 +00:00
chore: increase version [ci skip]
2016-06-28 14:43:36 +00:00
## v2.7.0 (2016-06-28)
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fix typos ([43b3d40b](https://github.com/clap-rs/clap/commit/43b3d40b8c38b1571da75af86b5088be96cccec2))
* **ArgGroup:** vastly improves ArgGroup docs by adding better examples ([9e5f4f5d](https://github.com/clap-rs/clap/commit/9e5f4f5d734d630bca5535c3a0aa4fd4f9db3e39), closes [#534](https://github.com/clap-rs/clap/issues/534))
chore: increase version [ci skip]
2016-06-28 14:43:36 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **ArgGroup:** one can now specify groups which require AT LEAST one of the args ([33689acc](https://github.com/clap-rs/clap/commit/33689acc689b217a8c0ee439f1b1225590c38355), closes [#533](https://github.com/clap-rs/clap/issues/533))
chore: increase version [ci skip]
2016-06-28 14:43:36 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **App:** using `App::print_help` now prints the same as would have been printed by `--help` or the like ([e84cc018](https://github.com/clap-rs/clap/commit/e84cc01836bbe0527e97de6db9889bd9e0fd6ba1), closes [#536](https://github.com/clap-rs/clap/issues/536))
chore: increase version [ci skip]
2016-06-28 14:43:36 +00:00
* **Help:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* prevents invoking <cmd> help help and displaying incorrect help message ([e3d2893f](https://github.com/clap-rs/clap/commit/e3d2893f377942a2d4cf3c6ff04524d0346e6fdb), closes [#538](https://github.com/clap-rs/clap/issues/538))
* subcommand help messages requested via <cmd> help <sub> now correctly match <cmd> <sub> --help ([08ad1cff](https://github.com/clap-rs/clap/commit/08ad1cff4fec57224ea957a2891a057b323c01bc), closes [#539](https://github.com/clap-rs/clap/issues/539))
chore: increase version [ci skip]
2016-06-28 14:43:36 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **ArgGroup:** Add multiple ArgGroups per Arg ([902e182f](https://github.com/clap-rs/clap/commit/902e182f7a58aff11ff01e0a452abcdbdb2262aa), closes [#426](https://github.com/clap-rs/clap/issues/426))
* **Usage Strings:** `[FLAGS]` and `[ARGS]` are no longer blindly added to usage strings ([9b2e45b1](https://github.com/clap-rs/clap/commit/9b2e45b170aff567b038d8b3368880b6046c10c6), closes [#537](https://github.com/clap-rs/clap/issues/537))
* **arg_enum!:** allows using meta items like repr(C) with arg_enum!s ([edf9b233](https://github.com/clap-rs/clap/commit/edf9b2331c17a2cbcc13f961add4c55c2778e773), closes [#543](https://github.com/clap-rs/clap/issues/543))
chore: increase version [ci skip]
2016-06-28 14:43:36 +00:00
chore: increase version
2016-06-14 02:18:34 +00:00
## v2.6.0 (2016-06-14)
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* removes extra newline from help output ([86e61d19](https://github.com/clap-rs/clap/commit/86e61d19a748fb9870fcf1175308984e51ca1115))
* allows printing version to any io::Write object ([921f5f79](https://github.com/clap-rs/clap/commit/921f5f7916597f1d028cd4a65bfe76a01c801724))
* removes extra newline when printing version ([7e2e2cbb](https://github.com/clap-rs/clap/commit/7e2e2cbb4a8a0f050bb8072a376f742fc54b8589))
* **Aliases:** improves readability of asliases in help messages ([ca511de7](https://github.com/clap-rs/clap/commit/ca511de71f5b8c2ac419f1b188658e8c63b67846), closes [#526](https://github.com/clap-rs/clap/issues/526), [#529](https://github.com/clap-rs/clap/issues/529))
* **Usage Strings:** improves the default usage string when only a single positional arg is present ([ec86f2da](https://github.com/clap-rs/clap/commit/ec86f2dada1545a63fc72355e22fcdc4c466c215), closes [#518](https://github.com/clap-rs/clap/issues/518))
chore: increase version
2016-06-14 02:18:34 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help:** allows wrapping at specified term width (Even on Windows!) ([1761dc0d](https://github.com/clap-rs/clap/commit/1761dc0d27d0d621229d792be40c36fbf65c3014), closes [#451](https://github.com/clap-rs/clap/issues/451))
chore: increase version
2016-06-14 02:18:34 +00:00
* **Settings:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* adds new setting to stop delimiting values with -- or TrailingVarArg ([fc3e0f5a](https://github.com/clap-rs/clap/commit/fc3e0f5afda6d24cdb3c4676614beebe13e1e870), closes [#511](https://github.com/clap-rs/clap/issues/511))
* one can now set an AppSetting which is propagated down through child subcommands ([e2341835](https://github.com/clap-rs/clap/commit/e23418351a3b98bf08dfd7744bc14377c70d59ee), closes [#519](https://github.com/clap-rs/clap/issues/519))
* **Subcommands:** adds support for visible aliases ([7b10e7f8](https://github.com/clap-rs/clap/commit/7b10e7f8937a07fdb8d16a6d8df79ce78d080cd3), closes [#522](https://github.com/clap-rs/clap/issues/522))
chore: increase version
2016-06-14 02:18:34 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes bug where args are printed out of order with templates ([05abb534](https://github.com/clap-rs/clap/commit/05abb534864764102031a0d402e64ac65867aa87))
* fixes bug where one can't override version or help flags ([90d7d6a2](https://github.com/clap-rs/clap/commit/90d7d6a2ea8240122dd9bf8d82d3c4f5ebb5c703), closes [#514](https://github.com/clap-rs/clap/issues/514))
* fixes issue where before_help wasn't printed ([b3faff60](https://github.com/clap-rs/clap/commit/b3faff6030f76a23f26afcfa6a90169002ed7106))
* **Help:** `App::before_help` and `App::after_help` now correctly wrap ([1f4da767](https://github.com/clap-rs/clap/commit/1f4da7676e6e71aa8dda799f3eeefad105a47819), closes [#516](https://github.com/clap-rs/clap/issues/516))
* **Settings:** fixes bug where new color settings couldn't be converted from strs ([706a7c11](https://github.com/clap-rs/clap/commit/706a7c11b0900be594de6d5a3121938eff197602))
* **Subcommands:** subcommands with aliases now display help of the aliased subcommand ([5354d14b](https://github.com/clap-rs/clap/commit/5354d14b51f189885ba110e01e6b76cca3752992), closes [#521](https://github.com/clap-rs/clap/issues/521))
* **Windows:** fixes a failing windows build ([01e7dfd6](https://github.com/clap-rs/clap/commit/01e7dfd6c07228c0be6695b3c7bf9370d82860d4))
* **YAML:** adds missing YAML methods for App and Arg ([e468faf3](https://github.com/clap-rs/clap/commit/e468faf3f05950fd9f72d84b69aa2061e91c6c64), closes [#528](https://github.com/clap-rs/clap/issues/528))
chore: increase version
2016-06-14 02:18:34 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.5.2 (2016-05-31)
chore: increase version
2016-05-30 10:18:54 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* removes extra newline from help output ([86e61d19](https://github.com/clap-rs/clap/commit/86e61d19a748fb9870fcf1175308984e51ca1115))
* allows printing version to any io::Write object ([921f5f79](https://github.com/clap-rs/clap/commit/921f5f7916597f1d028cd4a65bfe76a01c801724))
* removes extra newline when printing version ([7e2e2cbb](https://github.com/clap-rs/clap/commit/7e2e2cbb4a8a0f050bb8072a376f742fc54b8589))
chore: increase version
2016-05-30 10:18:54 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes bug where args are printed out of order with templates ([3935431d](https://github.com/clap-rs/clap/commit/3935431d5633f577c0826ae2142794b301f4b8ca))
* fixes bug where one can't override version or help flags ([90d7d6a2](https://github.com/clap-rs/clap/commit/90d7d6a2ea8240122dd9bf8d82d3c4f5ebb5c703), closes [#514](https://github.com/clap-rs/clap/issues/514))
* fixes issue where before_help wasn't printed ([b3faff60](https://github.com/clap-rs/clap/commit/b3faff6030f76a23f26afcfa6a90169002ed7106))
chore: increase version
2016-05-30 10:18:54 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* inter-links all types and pages ([3312893d](https://github.com/clap-rs/clap/commit/3312893ddaef3f44d68d8d26ed3d08010be50d97), closes [#505](https://github.com/clap-rs/clap/issues/505))
* makes all publicly available types viewable in docs ([52ca6505](https://github.com/clap-rs/clap/commit/52ca6505b4fec7b5c2d53d160c072d395eb21da6))
chore: increase version
2016-05-30 10:18:54 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.5.1 (2016-05-11)
chore: increase version
2016-05-11 19:52:21 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Subcommand Aliases**: fixes lifetime issue when setting multiple aliases at once ([ac42f6cf0](https://github.com/clap-rs/clap/commit/ac42f6cf0de6c4920f703807d63061803930b18d))
chore: increase version
2016-05-11 19:52:21 +00:00
chore: increase version
2016-05-10 21:05:37 +00:00
## v2.5.0 (2016-05-10)
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **SubCommand Aliases:** adds feature to yaml configs too ([69592195](https://github.com/clap-rs/clap/commit/695921954dde46dfd483399dcdef482c9dd7f34a))
chore: increase version
2016-05-10 21:05:37 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **SubCommands:** adds support for subcommand aliases ([66b4dea6](https://github.com/clap-rs/clap/commit/66b4dea65c44d8f77ff522238a9237aed1bcab6d), closes [#469](https://github.com/clap-rs/clap/issues/469))
chore: increase version
2016-05-10 21:05:37 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.4.3 (2016-05-10)
chore: increase version
2016-05-10 00:27:10 +00:00
#### Bug Fixes
* **Usage Strings:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* now properly dedups args that are also in groups ([3ca0947c](https://github.com/clap-rs/clap/commit/3ca0947c166b4f8525752255e3a4fa6565eb9689), closes [#498](https://github.com/clap-rs/clap/issues/498))
* removes duplicate groups from usage strings ([f574fb8a](https://github.com/clap-rs/clap/commit/f574fb8a7cde4d4a2fa4c4481d59be2d0f135427))
chore: increase version
2016-05-10 00:27:10 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Groups:** formats positional args in groups in a better way ([fef11154](https://github.com/clap-rs/clap/commit/fef11154fb7430d1cbf04a672aabb366e456a368))
chore: increase version
2016-05-10 00:27:10 +00:00
* **Help:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* moves positionals to standard <> formatting ([03dfe5ce](https://github.com/clap-rs/clap/commit/03dfe5ceff1d63f172788ff688567ddad9fe119b))
* default help subcommand string has been shortened ([5b7fe8e4](https://github.com/clap-rs/clap/commit/5b7fe8e4161e43ab19e2e5fcf55fbe46791134e9), closes [#494](https://github.com/clap-rs/clap/issues/494))
chore: increase version
2016-05-10 00:27:10 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.4.3 (2016-05-10)
chore(Tests): had to remove external clap-test crate...sad face
2016-05-10 02:46:09 +00:00
* Ghost Release
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.4.3 (2016-05-10)
chore: increase version
2016-05-10 00:27:10 +00:00
chore(Tests): had to remove external clap-test crate...sad face
2016-05-10 02:46:09 +00:00
* Ghost Release
chore: increase version
2016-05-10 00:27:10 +00:00
chore: increase version
2016-05-02 18:42:39 +00:00
## v2.4.0 (2016-05-02)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help:** adds support for displaying info before help message ([29fbfa3b](https://github.com/clap-rs/clap/commit/29fbfa3b963f2f3ca7704bf5d3e1201531baa373))
* **Required:** adds allowing args that are required unless certain args are present ([af1f7916](https://github.com/clap-rs/clap/commit/af1f79168390ea7da4074d0d9777de458ea64971))
chore: increase version
2016-05-02 18:42:39 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* hides formatting from docs ([cb708093](https://github.com/clap-rs/clap/commit/cb708093a7cd057f08c98b7bd1ed54c2db86ae7e))
* **required_unless:** adds docs and examples for required_unless ([ca727b52](https://github.com/clap-rs/clap/commit/ca727b52423b9883acd88b2f227b2711bc144573))
chore: increase version
2016-05-02 18:42:39 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Required Args:** fixes issue where missing required args are sometimes duplicated in error messages ([3beebd81](https://github.com/clap-rs/clap/commit/3beebd81e7bc2faa4115ac109cf570e512c5477f), closes [#492](https://github.com/clap-rs/clap/issues/492))
chore: increase version
2016-05-02 18:42:39 +00:00
chore: increase version
2016-04-18 02:30:28 +00:00
## v2.3.0 (2016-04-18)
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **macros.rs:** Added write_nspaces macro (a new version of write_spaces) ([9d757e86](https://github.com/clap-rs/clap/commit/9d757e8678e334e5a740ac750c76a9ed4e785cba))
chore: increase version
2016-04-18 02:30:28 +00:00
* **parser.rs:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Provide a way to create a usage string without the USAGE: title ([a91d378b](https://github.com/clap-rs/clap/commit/a91d378ba0c91b5796457f8c6e881b13226ab735))
* Make Parser's create_usage public allowing to have function outside the parser to generate the help ([d51945f8](https://github.com/clap-rs/clap/commit/d51945f8b82ebb0963f4f40b384a9e8335783091))
* Expose Parser's flags, opts and positionals argument as iterators ([9b23e7ee](https://github.com/clap-rs/clap/commit/9b23e7ee40e51f7a823644c4496be955dc6c9d3a))
* **src/args:** Exposes argument display order by introducing a new Trait ([1321630e](https://github.com/clap-rs/clap/commit/1321630ef56955f152c73376d4d85cceb0bb4a12))
* **srs/args:** Added longest_filter to AnyArg trait ([65b3f667](https://github.com/clap-rs/clap/commit/65b3f667532685f854c699ddd264d326599cf7e5))
chore: increase version
2016-04-18 02:30:28 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Authors Macro:** adds a crate_authors macro ([38fb59ab](https://github.com/clap-rs/clap/commit/38fb59abf480eb2b6feca269097412f8b00b5b54), closes [#447](https://github.com/clap-rs/clap/issues/447))
chore: increase version
2016-04-18 02:30:28 +00:00
* **HELP:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* implements optional colored help messages ([abc8f669](https://github.com/clap-rs/clap/commit/abc8f669c3c8193ffc3a3b0ac6c3ac2198794d4f), closes [#483](https://github.com/clap-rs/clap/issues/483))
* Add a Templated Help system. ([81e121ed](https://github.com/clap-rs/clap/commit/81e121edd616f7285593f11120c63bcccae0d23e))
chore: increase version
2016-04-18 02:30:28 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **HELP:** Adjust Help to semantic changes introduced in 6933b84 ([8d23806b](https://github.com/clap-rs/clap/commit/8d23806bd67530ad412c34a1dcdcb1435555573d))
chore: increase version
2016-04-18 02:30:28 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.2.6 (2016-04-11)
chore: increase version
2016-04-11 18:50:38 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Arg Groups**: fixes bug where arg name isn't printed properly ([3019a685](https://github.com/clap-rs/clap/commit/3019a685eee747ccbe6be09ad5dddce0b1d1d4db), closes [#476](https://github.com/clap-rs/clap/issues/476))
chore: increase version
2016-04-11 18:50:38 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.2.5 (2016-04-03)
chore: increase version
2016-04-03 00:50:47 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Empty Values:** fixes bug where empty values weren't stored ([885d166f](https://github.com/clap-rs/clap/commit/885d166f04eb3fb581898ae5818c6c8032e5a686), closes [#470](https://github.com/clap-rs/clap/issues/470))
* **Help Message:** fixes bug where arg name is printed twice ([71acf1d5](https://github.com/clap-rs/clap/commit/71acf1d576946658b8bbdb5ae79e6716c43a030f), closes [#472](https://github.com/clap-rs/clap/issues/472))
chore: increase version
2016-04-03 00:50:47 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.2.4 (2016-03-30)
chore: increase version'
2016-03-30 02:32:15 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes compiling with debug cargo feature ([d4b55450](https://github.com/clap-rs/clap/commit/d4b554509928031ac0808076178075bb21f8c1da))
* **Empty Values:** fixes bug where empty values weren't stored ([885d166f](https://github.com/clap-rs/clap/commit/885d166f04eb3fb581898ae5818c6c8032e5a686), closes [#470](https://github.com/clap-rs/clap/issues/470))
chore: increase version'
2016-03-30 02:32:15 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.2.3 (2016-03-28)
chore: increase version
2016-03-28 15:28:36 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Subcommand:** fixes issue where help and version flags weren't properly displayed ([205b07bf](https://github.com/clap-rs/clap/commit/205b07bf2e6547851f1290f8cd6b169145e144f1), closes [#466](https://github.com/clap-rs/clap/issues/466))
chore: increase version
2016-03-28 15:28:36 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.2.2 (2016-03-27)
chore: increase version
2016-03-27 20:02:10 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Message:** fixes bug with wrapping in the middle of a unicode sequence ([05365ddc](https://github.com/clap-rs/clap/commit/05365ddcc252e4b49e7a75e199d6001a430bd84d), closes [#456](https://github.com/clap-rs/clap/issues/456))
* **Usage Strings:** fixes small bug where -- would appear needlessly in usage strings ([6933b849](https://github.com/clap-rs/clap/commit/6933b8491c2a7e28cdb61b47dcf10caf33c2f78a), closes [#461](https://github.com/clap-rs/clap/issues/461))
chore: increase version
2016-03-27 20:02:10 +00:00
chore: increase version
2016-03-16 14:22:21 +00:00
### 2.2.1 (2016-03-16)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Message:** wraps and aligns the help message of subcommands ([813d75d0](https://github.com/clap-rs/clap/commit/813d75d06fbf077c65762608c0fa5e941cfc393c), closes [#452](https://github.com/clap-rs/clap/issues/452))
chore: increase version
2016-03-16 14:22:21 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Message:** fixes a bug where small terminal sizes causing a loop ([1d73b035](https://github.com/clap-rs/clap/commit/1d73b0355236923aeaf6799abc759762ded7e1d0), closes [#453](https://github.com/clap-rs/clap/issues/453))
chore: increase version
2016-03-16 14:22:21 +00:00
chore: updates readme and changelog for new features
2016-03-15 02:44:34 +00:00
## v2.2.0 (2016-03-15)
chore: increase version
2016-03-14 01:54:28 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Message:** can auto wrap and aligning help text to term width ([e36af026](https://github.com/clap-rs/clap/commit/e36af0266635f23e85e951b9088d561e9a5d1bf6), closes [#428](https://github.com/clap-rs/clap/issues/428))
* **Help Subcommand:** adds support passing additional subcommands to help subcommand ([2c12757b](https://github.com/clap-rs/clap/commit/2c12757bbdf34ce481f3446c074e24c09c2e60fd), closes [#416](https://github.com/clap-rs/clap/issues/416))
* **Opts and Flags:** adds support for custom ordering in help messages ([9803b51e](https://github.com/clap-rs/clap/commit/9803b51e799904c0befaac457418ee766ccc1ab9))
* **Settings:** adds support for automatically deriving custom display order of args ([ad86e433](https://github.com/clap-rs/clap/commit/ad86e43334c4f70e86909689a088fb87e26ff95a), closes [#444](https://github.com/clap-rs/clap/issues/444))
* **Subcommands:** adds support for custom ordering in help messages ([7d2a2ed4](https://github.com/clap-rs/clap/commit/7d2a2ed413f5517d45988eef0765cdcd663b6372), closes [#442](https://github.com/clap-rs/clap/issues/442))
chore: increase version
2016-03-14 01:54:28 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **From Usage:** fixes a bug where adding empty lines weren't ignored ([c5c58c86](https://github.com/clap-rs/clap/commit/c5c58c86b9c503d8de19da356a5a5cffb59fbe84))
chore: increase version
2016-03-14 01:54:28 +00:00
chore: updates readme and changelog for new features
2016-03-15 02:44:34 +00:00
#### Documentation
chore: increase version
2016-03-14 01:54:28 +00:00
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Groups:** explains required ArgGroups better ([4ff0205b](https://github.com/clap-rs/clap/commit/4ff0205b85a45151b59bbaf090a89df13438380f), closes [#439](https://github.com/clap-rs/clap/issues/439))
chore: increase version
2016-03-14 01:54:28 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.1.2 (2016-02-24)
chore: increase version Closes #434
2016-02-24 03:39:13 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Nightly:** fixes failing nightly build ([d752c170](https://github.com/clap-rs/clap/commit/d752c17029598b19037710f204b7943f0830ae75), closes [#434](https://github.com/clap-rs/clap/issues/434))
chore: increase version Closes #434
2016-02-24 03:39:13 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.1.1 (2016-02-19)
chore: increase version
2016-02-19 15:47:39 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **AppSettings:** clarifies that AppSettings do not propagate ([3c8db0e9](https://github.com/clap-rs/clap/commit/3c8db0e9be1d24edaad364359513cbb02abb4186), closes [#429](https://github.com/clap-rs/clap/issues/429))
* **Arg Examples:** adds better examples ([1e79cccc](https://github.com/clap-rs/clap/commit/1e79cccc12937bc0e7cd2aad8e404410798e9fff))
chore: increase version
2016-02-19 15:47:39 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help:** adds setting for next line help by arg ([066df748](https://github.com/clap-rs/clap/commit/066df7486e684cf50a8479a356a12ba972c34ce1), closes [#427](https://github.com/clap-rs/clap/issues/427))
chore: increase version
2016-02-19 15:47:39 +00:00
chore: increase version
2016-02-10 17:55:54 +00:00
## v2.1.0 (2016-02-10)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Default Values:** adds support for default values in args ([73211952](https://github.com/clap-rs/clap/commit/73211952964a79d97b434dd567e6d7d34be7feb5), closes [#418](https://github.com/clap-rs/clap/issues/418))
chore: increase version
2016-02-10 17:55:54 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Default Values:** adds better examples and notes for default values ([9facd74f](https://github.com/clap-rs/clap/commit/9facd74f843ef3807c5d35259558a344e6c25905))
chore: increase version
2016-02-10 17:55:54 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.0.6 (2016-02-09)
chore: increase version
2016-02-09 14:30:41 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Positional Arguments:** now displays value name if appropriate ([f0a99916](https://github.com/clap-rs/clap/commit/f0a99916c59ce675515c6dcdfe9a40b130510908), closes [#420](https://github.com/clap-rs/clap/issues/420))
chore: increase version
2016-02-09 14:30:41 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.0.5 (2016-02-05)
chore: increase version
2016-02-05 00:45:30 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Multiple Values:** fixes bug where number_of_values wasn't respected ([72c387da](https://github.com/clap-rs/clap/commit/72c387da0bb8a6f526f863770f08bb8ca0d3de03))
chore: increase version
2016-02-05 00:45:30 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.0.4 (2016-02-04)
chore: increase version
2016-02-04 06:36:30 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* adds support for building ArgGroups from standalone YAML ([fcbc7e12](https://github.com/clap-rs/clap/commit/fcbc7e12f5d7b023b8f30cba8cad28a01cf6cd26))
* Stop lonely hyphens from causing panic ([85b11468](https://github.com/clap-rs/clap/commit/85b11468b0189d5cc15f1cfac5db40d17a0077dc), closes [#410](https://github.com/clap-rs/clap/issues/410))
* **AppSettings:** fixes bug where subcmds didn't receive parent ver ([a62e4527](https://github.com/clap-rs/clap/commit/a62e452754b3b0e3ac9a15aa8b5330636229ead1))
chore: increase version
2016-02-04 06:36:30 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.0.3 (2016-02-02)
chore: increase version
2016-02-02 08:16:43 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **values:** adds support for up to u64::max values per arg ([c7abf7d7](https://github.com/clap-rs/clap/commit/c7abf7d7611e317b0d31d97632e3d2e13570947c))
* **occurrences:** Allow for more than 256 occurrences of an argument. ([3731ddb3](https://github.com/clap-rs/clap/commit/3731ddb361163f3d6b86844362871e48c80fa530))
chore: increase version
2016-02-02 08:16:43 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **AppSettings:** adds HidePossibleValuesInHelp to skip writing those values ([cdee7a0e](https://github.com/clap-rs/clap/commit/cdee7a0eb2beeec723cb98acfacf03bf629c1da3))
chore: increase version
2016-02-02 08:16:43 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **value_t_or_exit:** fixes typo which causes value_t_or_exit to return a Result ([ee96baff](https://github.com/clap-rs/clap/commit/ee96baffd306cb8d20ddc5575cf739bb1a6354e8))
chore: increase version
2016-02-02 08:16:43 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.0.2 (2016-01-31)
chore: increase version
2016-01-31 13:11:43 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **arg_enum:** enum declared with arg_enum returns [&'static str; #] instead of Vec ([9c4b8a1a](https://github.com/clap-rs/clap/commit/9c4b8a1a6b12949222f17d1074578ad7676b9c0d))
chore: increase version
2016-01-31 13:11:43 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* clap_app! should be gated by unstable, not nightly feature ([0c8b84af](https://github.com/clap-rs/clap/commit/0c8b84af6161d5baf683688eafc00874846f83fa))
* **SubCommands:** fixed where subcmds weren't recognized after mult args ([c19c17a8](https://github.com/clap-rs/clap/commit/c19c17a8850602990e24347aeb4427cf43316223), closes [#405](https://github.com/clap-rs/clap/issues/405))
* **Usage Parser:** fixes a bug where literal single quotes weren't allowed in help strings ([0bcc7120](https://github.com/clap-rs/clap/commit/0bcc71206478074769e311479b34a9f74fe80f5c), closes [#406](https://github.com/clap-rs/clap/issues/406))
chore: increase version
2016-01-31 13:11:43 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v2.0.1 (2016-01-30)
chore: increase version
2016-01-30 02:31:30 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes cargo features to NOT require nightly with unstable features ([dcbcc60c](https://github.com/clap-rs/clap/commit/dcbcc60c9ba17894be636472ea4b07a82d86a9db), closes [#402](https://github.com/clap-rs/clap/issues/402))
chore: increase version
2016-01-30 02:31:30 +00:00
chore: increase version
2016-01-28 16:43:58 +00:00
## v2.0.0 (2016-01-28)
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **From Usage:** vastly improves the usage parser ([fa3a2f86](https://github.com/clap-rs/clap/commit/fa3a2f86bd674c5eb07128c95098fab7d1437247), closes [#350](https://github.com/clap-rs/clap/issues/350))
chore: increase version
2016-01-28 16:43:58 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* adds support for external subcommands ([177fe5cc](https://github.com/clap-rs/clap/commit/177fe5cce745c2164a8e38c23be4c4460d2d7211), closes [#372](https://github.com/clap-rs/clap/issues/372))
* adds support values with a leading hyphen ([e4d429b9](https://github.com/clap-rs/clap/commit/e4d429b9d52e95197bd0b572d59efacecf305a59), closes [#385](https://github.com/clap-rs/clap/issues/385))
* adds support for turning off the value delimiter ([508db850](https://github.com/clap-rs/clap/commit/508db850a87c2e251cf6b6ddead9ad56b29f9e57), closes [#352](https://github.com/clap-rs/clap/issues/352))
* adds support changing the value delimiter ([dafeae8a](https://github.com/clap-rs/clap/commit/dafeae8a526162640f6a68da434370c64d190889), closes [#353](https://github.com/clap-rs/clap/issues/353))
* adds support for comma separated values ([e69da6af](https://github.com/clap-rs/clap/commit/e69da6afcd2fe48a3c458ca031db40997f860eda), closes [#348](https://github.com/clap-rs/clap/issues/348))
* adds support with options with optional values ([4555736c](https://github.com/clap-rs/clap/commit/4555736cad01441dcde4ea84a285227e0844c16e), closes [#367](https://github.com/clap-rs/clap/issues/367))
* **UTF-8:** adds support for invalid utf8 in values ([c5c59dec](https://github.com/clap-rs/clap/commit/c5c59dec0bc33b86b2e99d30741336f17ec84282), closes [#269](https://github.com/clap-rs/clap/issues/269))
* **v2:** implementing the base of 2.x ([a3536054](https://github.com/clap-rs/clap/commit/a3536054512ba833533dc56615ce3663d884381c))
chore: increase version
2016-01-28 16:43:58 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes nightly build with new lints ([17599195](https://github.com/clap-rs/clap/commit/175991956c37dc83ba9c49396e927a1cb65c5b11))
* fixes Windows build for 2x release ([674c9b48](https://github.com/clap-rs/clap/commit/674c9b48c7c92079cb180cc650a9e39f34781c32), closes [#392](https://github.com/clap-rs/clap/issues/392))
* fixes yaml build for 2x base ([adceae64](https://github.com/clap-rs/clap/commit/adceae64c8556d00ab715677377b216f9f468ad7))
chore: increase version
2016-01-28 16:43:58 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* updates examples for 2x release ([1303b360](https://github.com/clap-rs/clap/commit/1303b3607468f362ab1b452d5614c1a064dc69b4), closes [#394](https://github.com/clap-rs/clap/issues/394))
* updates examples for 2x release ([0a011f31](https://github.com/clap-rs/clap/commit/0a011f3142aec338d388a6c8bfe22fa7036021bb), closes [#394](https://github.com/clap-rs/clap/issues/394))
* updates documentation for v2 release ([8d51724e](https://github.com/clap-rs/clap/commit/8d51724ef73dfde5bb94fb9466bc5463a1cc1502))
* updating docs for 2x release ([576d0e0e](https://github.com/clap-rs/clap/commit/576d0e0e2c7b8f386589179bbf7419b93abacf1c))
chore: increase version
2016-01-28 16:43:58 +00:00
* **README.md:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* updates readme for v2 release ([acaba01a](https://github.com/clap-rs/clap/commit/acaba01a353c12144b9cd9a3ce447400691849b0), closes [#393](https://github.com/clap-rs/clap/issues/393))
* fix typo and make documentation conspicuous ([07b9f614](https://github.com/clap-rs/clap/commit/07b9f61495d927f69f7abe6c0d85253f0f4e6107))
chore: increase version
2016-01-28 16:43:58 +00:00
#### BREAKING CHANGES
Fix various typos in docs & code Most errors detected and fixed with Topy (https://github.com/intgr/topy), all verified by hand.
2020-07-18 17:47:04 +00:00
* **Fewer lifetimes! Yay!**
chore: increase version
2016-01-28 16:43:58 +00:00
* `App<'a, 'b, 'c, 'd, 'e, 'f>` => `App<'a, 'b>`
* `Arg<'a, 'b, 'c, 'd, 'e, 'f>` => `Arg<'a, 'b>`
* `ArgMatches<'a, 'b>` => `ArgMatches<'a>`
* **Simply Renamed**
* `App::arg_group` => `App::group`
* `App::arg_groups` => `App::groups`
* `ArgGroup::add` => `ArgGroup::arg`
* `ArgGroup::add_all` => `ArgGroup::args`
* `ClapError` => `Error`
* struct field `ClapError::error_type` => `Error::kind`
* `ClapResult` => `Result`
* `ClapErrorType` => `ErrorKind`
* **Removed Deprecated Functions and Methods**
* `App::subcommands_negate_reqs`
* `App::subcommand_required`
* `App::arg_required_else_help`
* `App::global_version(bool)`
* `App::versionless_subcommands`
* `App::unified_help_messages`
* `App::wait_on_error`
* `App::subcommand_required_else_help`
* `SubCommand::new`
* `App::error_on_no_subcommand`
* `Arg::new`
* `Arg::mutually_excludes`
* `Arg::mutually_excludes_all`
* `Arg::mutually_overrides_with`
* `simple_enum!`
* **Renamed Error Variants**
* `InvalidUnicode` => `InvalidUtf8`
* `InvalidArgument` => `UnknownArgument`
* **Usage Parser**
* Value names can now be specified inline, i.e. `-o, --option <FILE> <FILE2> 'some option which takes two files'`
* **There is now a priority of order to determine the name** - This is perhaps the biggest breaking change. See the documentation for full details. Prior to this change, the value name took precedence. **Ensure your args are using the proper names (i.e. typically the long or short and NOT the value name) throughout the code**
* `ArgMatches::values_of` returns an `Values` now which implements `Iterator` (should not break any code)
* `crate_version!` returns `&'static str` instead of `String`
fix: fixes cargo features to NOT require nightly with unstable features Closes #402
2016-01-30 02:28:12 +00:00
* Using the `clap_app!` macro requires compiling with the `unstable` feature because the syntax could change slightly in the future
chore: increase version
2016-01-28 16:43:58 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.5.5 (2016-01-04)
chore: increases version
2016-01-04 04:59:52 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes an issue where invalid short args didn't cause an error ([c9bf7e44](https://github.com/clap-rs/clap/commit/c9bf7e4440bd2f9b524ea955311d433c40a7d1e0))
* prints the name in version and help instead of binary name ([8f3817f6](https://github.com/clap-rs/clap/commit/8f3817f665c0cab6726bc16c56a53b6a61e44448), closes [#368](https://github.com/clap-rs/clap/issues/368))
* fixes an intentional panic issue discovered via clippy ([ea83a3d4](https://github.com/clap-rs/clap/commit/ea83a3d421ea8856d4cac763942834d108b71406))
chore: increases version
2016-01-04 04:59:52 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.5.4 (2015-12-18)
chore: increase version
2015-12-18 06:36:15 +00:00
#### Examples
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **17_yaml:** conditinonally compile 17_yaml example ([575de089](https://github.com/clap-rs/clap/commit/575de089a3e240c398cb10e6cf5a5c6b68662c01))
chore: increase version
2015-12-18 06:36:15 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* clippy improvements ([99cdebc2](https://github.com/clap-rs/clap/commit/99cdebc23da3a45a165f14b27bebeb2ed828a2ce))
chore: increase version
2015-12-18 06:36:15 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **errors:** return correct error type in WrongNumValues error builder ([5ba8ba9d](https://github.com/clap-rs/clap/commit/5ba8ba9dcccdfa74dd1c44260e64b359bbb36be6))
* ArgRequiredElseHelp setting now takes precedence over missing required args ([faad83fb](https://github.com/clap-rs/clap/commit/faad83fbef6752f3093b6e98fca09a9449b830f4), closes [#362](https://github.com/clap-rs/clap/issues/362))
chore: increase version
2015-12-18 06:36:15 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.5.3 (2015-11-20)
chore: increase version
2015-11-20 13:24:31 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Errors:** fixes some instances when errors are missing a final newline ([c4d2b171](https://github.com/clap-rs/clap/commit/c4d2b1711994479ad64ee52b6b49d2ceccbf2118))
chore: increase version
2015-11-20 13:24:31 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.5.2 (2015-11-14)
chore: increase version
2015-11-14 09:53:59 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Errors:** fixes a compiling bug when built on Windows or without the color feature ([a35f7634](https://github.com/clap-rs/clap/commit/a35f76346fe6ecc88dda6a1eb13627186e7ce185))
chore: increase version
2015-11-14 09:53:59 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.5.1 (2015-11-13)
chore: increase version
2015-11-13 14:37:24 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Required Args:** fixes a bug where required args are not correctly accounted for ([f03b88a9](https://github.com/clap-rs/clap/commit/f03b88a9766b331a63879bcd747687f2e5a2661b), closes [#343](https://github.com/clap-rs/clap/issues/343))
chore: increase version
2015-11-13 14:37:24 +00:00
chore: increase version
2015-11-13 04:01:13 +00:00
## v1.5.0 (2015-11-13)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes a bug with required positional args in usage strings ([c6858f78](https://github.com/clap-rs/clap/commit/c6858f78755f8e860204323c828c8355a066dc83))
chore: increase version
2015-11-13 04:01:13 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **FAQ:** updates readme with slight changes to FAQ ([a4ef0fab](https://github.com/clap-rs/clap/commit/a4ef0fab73c8dc68f1b138965d1340459c113398))
chore: increase version
2015-11-13 04:01:13 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* massive errors overhaul ([cdc29175](https://github.com/clap-rs/clap/commit/cdc29175bc9c53e5b4aec86cbc04c1743154dae6))
* **ArgMatcher:** huge refactor and deduplication of code ([8988853f](https://github.com/clap-rs/clap/commit/8988853fb8825e8f841fde349834cc12cdbad081))
* **Errors:** errors have been vastly improved ([e59bc0c1](https://github.com/clap-rs/clap/commit/e59bc0c16046db156a88ba71a037db05028e995c))
* **Traits:** refactoring some configuration into traits ([5800cdec](https://github.com/clap-rs/clap/commit/5800cdec6dce3def4242b9f7bd136308afb19685))
chore: increase version
2015-11-13 04:01:13 +00:00
#### Performance
* **App:**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* more BTreeMap->Vec, Opts and SubCmds ([bc4495b3](https://github.com/clap-rs/clap/commit/bc4495b32ec752b6c4b29719e831c043ef2a26ce))
* changes flags BTreeMap->Vec ([d357640f](https://github.com/clap-rs/clap/commit/d357640fab55e5964fe83efc3c771e53aa3222fd))
* removed unneeded BTreeMap ([78971fd6](https://github.com/clap-rs/clap/commit/78971fd68d7dc5c8e6811b4520cdc54e4188f733))
* changes BTreeMap to VecMap in some instances ([64b921d0](https://github.com/clap-rs/clap/commit/64b921d087fdd03775c95ba0bcf65d3f5d36f812))
* removed excess clones ([ec0089d4](https://github.com/clap-rs/clap/commit/ec0089d42ed715d293fb668d3a90b0db0aa3ec39))
chore: increase version
2015-11-13 04:01:13 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.4.7 (2015-11-03)
chore: increase version
2015-11-03 04:23:27 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Clarify behavior of Arg::multiple with options. ([434f497a](https://github.com/clap-rs/clap/commit/434f497ab6d831f8145cf09278c97ca6ee6c6fe7))
* Fix typos and improve grammar. ([c1f66b5d](https://github.com/clap-rs/clap/commit/c1f66b5de7b5269fbf8760a005ef8c645edd3229))
chore: increase version
2015-11-03 04:23:27 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Error Status:** fixes bug where --help and --version return non-zero exit code ([89b51fdf](https://github.com/clap-rs/clap/commit/89b51fdf8b1ab67607567344e2317ff1a757cb12))
chore: increase version
2015-11-03 04:23:27 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.4.6 (2015-10-29)
chore: increase version
2015-10-29 05:36:12 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* allows parsing without a binary name for daemons and interactive CLIs ([aff89d57](https://github.com/clap-rs/clap/commit/aff89d579b5b85c3dc81b64f16d5865299ec39a2), closes [#318](https://github.com/clap-rs/clap/issues/318))
chore: increase version
2015-10-29 05:36:12 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Errors:** tones down quoting in some error messages ([34ce59ed](https://github.com/clap-rs/clap/commit/34ce59ede53bfa2eef722c74881cdba7419fd9c7), closes [#309](https://github.com/clap-rs/clap/issues/309))
* **Help and Version:** only builds help and version once ([e3be87cf](https://github.com/clap-rs/clap/commit/e3be87cfc095fc41c9811adcdc6d2b079f237d5e))
* **Option Args:** fixes bug with args and multiple values ([c9a9548a](https://github.com/clap-rs/clap/commit/c9a9548a8f96cef8a3dd9a980948325fbbc1b91b), closes [#323](https://github.com/clap-rs/clap/issues/323))
* **POSIX Overrides:** fixes bug where required args are overridden ([40ed2b50](https://github.com/clap-rs/clap/commit/40ed2b50c3a9fe88bfdbaa43cef9fd6493ecaa8e))
* **Safe Matches:** using 'safe' forms of the get_matches family no longer exit the process ([c47025dc](https://github.com/clap-rs/clap/commit/c47025dca2b3305dea0a0acfdd741b09af0c0d05), closes [#256](https://github.com/clap-rs/clap/issues/256))
* **Versionless SubCommands:** fixes a bug where the -V flag was needlessly built ([27df8b9d](https://github.com/clap-rs/clap/commit/27df8b9d98d13709dad3929a009f40ebff089a1a), closes [#329](https://github.com/clap-rs/clap/issues/329))
chore: increase version
2015-10-29 05:36:12 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* adds comparison in readme ([1a8bf31e](https://github.com/clap-rs/clap/commit/1a8bf31e7a6b87ce48a66af2cde1645b2dd5bc95), closes [#325](https://github.com/clap-rs/clap/issues/325))
chore: increase version
2015-10-29 05:36:12 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.4.5 (2015-10-06)
chore: increase version
2015-10-06 19:28:55 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes crash on invalid arg error ([c78ce128](https://github.com/clap-rs/clap/commit/c78ce128ebbe7b8f730815f8176c29d76f4ade8c))
chore: increase version
2015-10-06 19:28:55 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.4.4 (2015-10-06)
chore: increase version
2015-10-06 15:16:23 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* clean up some formatting ([b7df92d7](https://github.com/clap-rs/clap/commit/b7df92d7ea25835701dd22ddff984b9749f48a00))
* move the crate-level docs to top of the lib.rs file ([d7233bf1](https://github.com/clap-rs/clap/commit/d7233bf122dbf80ba8fc79e5641be2df8af10e7a))
* changes doc comments to rustdoc comments ([34b601be](https://github.com/clap-rs/clap/commit/34b601be5fdde76c1a0859385b359b96d66b8732))
* fixes panic in 14_groups example ([945b00a0](https://github.com/clap-rs/clap/commit/945b00a0c27714b63bdca48d003fe205fcfdc578), closes [#295](https://github.com/clap-rs/clap/issues/295))
* avoid suggesting star dependencies. ([d33228f4](https://github.com/clap-rs/clap/commit/d33228f40b5fefb84cf3dd51546bfb340dcd9f5a))
* **Rustdoc:** adds portions of the readme to main rustdoc page ([6f9ee181](https://github.com/clap-rs/clap/commit/6f9ee181e69d90bd4206290e59d6f3f1e8f0cbb2), closes [#293](https://github.com/clap-rs/clap/issues/293))
chore: increase version
2015-10-06 15:16:23 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* grammar error in some conflicting option errors ([e73b07e1](https://github.com/clap-rs/clap/commit/e73b07e19474323ad2260da66abbf6a6d4ecbd4f))
* **Unified Help:** sorts both flags and options as a unified category ([2a223dad](https://github.com/clap-rs/clap/commit/2a223dad82901fa2e74baad3bfc4c7b94509300f))
* **Usage:** fixes a bug where required args aren't filtered properly ([72b453dc](https://github.com/clap-rs/clap/commit/72b453dc170af3050bb123d35364f6da77fc06d7), closes [#277](https://github.com/clap-rs/clap/issues/277))
* **Usage Strings:** fixes a bug ordering of elements in usage strings ([aaf0d6fe](https://github.com/clap-rs/clap/commit/aaf0d6fe7aa2403e76096c16204d254a9ee61ee2), closes [#298](https://github.com/clap-rs/clap/issues/298))
chore: increase version
2015-10-06 15:16:23 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* supports -aValue style options ([0e3733e4](https://github.com/clap-rs/clap/commit/0e3733e4fec2015c2d566a51432dcd92cb69cad3))
* **Trailing VarArg:** adds opt-in setting for final arg being vararg ([27018b18](https://github.com/clap-rs/clap/commit/27018b1821a4bcd5235cfe92abe71b3c99efc24d), closes [#278](https://github.com/clap-rs/clap/issues/278))
chore: increase version
2015-10-06 15:16:23 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.4.3 (2015-09-30)
chore: increase version
2015-09-30 18:42:41 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* allows accessing arg values by group name ([c92a4b9e](https://github.com/clap-rs/clap/commit/c92a4b9eff2d679957f61c0c41ff404b40d38a91))
chore: increase version
2015-09-30 18:42:41 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* use links to examples instead of plain text ([bb4fe237](https://github.com/clap-rs/clap/commit/bb4fe237858535627271465147add537e4556b43))
chore: increase version
2015-09-30 18:42:41 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Message:** required args no longer double list in usage ([1412e639](https://github.com/clap-rs/clap/commit/1412e639e0a79df84936d1101a837f90077d1c83), closes [#277](https://github.com/clap-rs/clap/issues/277))
* **Possible Values:** possible value validation is restored ([f121ae74](https://github.com/clap-rs/clap/commit/f121ae749f8f4bfe754ef2e8a6dfc286504b5b75), closes [#287](https://github.com/clap-rs/clap/issues/287))
chore: increase version
2015-09-30 18:42:41 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.4.2 (2015-09-23)
chore: increase version
2015-09-23 02:05:47 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Conflicts:** fixes bug with conflicts not removing required args ([e17fcec5](https://github.com/clap-rs/clap/commit/e17fcec53b3216ad047a13dddc6f740473fad1a1), closes [#271](https://github.com/clap-rs/clap/issues/271))
chore: increase version
2015-09-23 02:05:47 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.4.1 (2015-09-22)
chore: increase version
2015-09-22 17:28:32 +00:00
#### Examples
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* add clap_app quick example ([4ba6249c](https://github.com/clap-rs/clap/commit/4ba6249c3cf4d2e083370d1fe4dcc7025282c28a))
chore: increase version
2015-09-22 17:28:32 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Unicode:** allows non-panicking on invalid unicode characters ([c5bf7ddc](https://github.com/clap-rs/clap/commit/c5bf7ddc8cfb876ec928a5aaf5591232bbb32e5d))
chore: increase version
2015-09-22 17:28:32 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* properly names Examples section for rustdoc ([87ba5445](https://github.com/clap-rs/clap/commit/87ba54451d7ec7b1c9b9ef134f90bbe39e6fac69))
* fixes various typos and spelling ([f85640f9](https://github.com/clap-rs/clap/commit/f85640f9f6d8fd3821a40e9b8b7a34fabb789d02))
* **Arg:** unhides fields of the Arg struct ([931aea88](https://github.com/clap-rs/clap/commit/931aea88427edf43a3da90d5a500c1ff2b2c3614))
chore: increase version
2015-09-22 17:28:32 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* flush the buffer in App::print_version() ([cbc42a37](https://github.com/clap-rs/clap/commit/cbc42a37d212d84d22b1777d08e584ff191934e7))
* Macro benchmarks ([13712da1](https://github.com/clap-rs/clap/commit/13712da1d36dc7614eec3a10ad488257ba615751))
chore: increase version
2015-09-22 17:28:32 +00:00
chore: increase version
2015-09-09 04:00:17 +00:00
## v1.4.0 (2015-09-09)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* allows printing help message by library consumers ([56b95f32](https://github.com/clap-rs/clap/commit/56b95f320875c62dda82cb91b29059671e120ed1))
* allows defining hidden args and subcmds ([2cab4d03](https://github.com/clap-rs/clap/commit/2cab4d0334ea3c2439a1d4bfca5bf9905c7ea9ac), closes [#231](https://github.com/clap-rs/clap/issues/231))
* Builder macro to assist with App/Arg/Group/SubCommand building ([443841b0](https://github.com/clap-rs/clap/commit/443841b012a8d795cd5c2bd69ae6e23ef9b16477))
* **Errors:** allows consumers to write to stderr and exit on error ([1e6403b6](https://github.com/clap-rs/clap/commit/1e6403b6a863574fa3cb6946b1fb58f034e8664c))
chore: increase version
2015-09-09 04:00:17 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.3.2 (2015-09-08)
chore: increase version
2015-09-08 01:37:17 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixed ErrorKind docs ([dd057843](https://github.com/clap-rs/clap/commit/dd05784327fa070eb6ce5ce89a8507e011d8db94))
* **ErrorKind:** changed examples content ([b9ca2616](https://github.com/clap-rs/clap/commit/b9ca261634b89613bbf3d98fd74d55cefbb31a8c))
chore: increase version
2015-09-08 01:37:17 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes a bug where the help subcommand wasn't overridable ([94003db4](https://github.com/clap-rs/clap/commit/94003db4b5eebe552ca337521c1c001295822745))
chore: increase version
2015-09-08 01:37:17 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* adds ability not consume self when parsing matches and/or exit on help ([94003db4](https://github.com/clap-rs/clap/commit/94003db4b5eebe552ca337521c1c001295822745))
* **App:** Added ability for users to handle errors themselves ([934e6fbb](https://github.com/clap-rs/clap/commit/934e6fbb643b2385efc23444fe6fce31494dc288))
chore: increase version
2015-09-08 01:37:17 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.3.1 (2015-09-04)
chore: increase version
2015-09-04 18:19:55 +00:00
#### Examples
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **17_yaml:** fixed example ([9b848622](https://github.com/clap-rs/clap/commit/9b848622296c8c5c7b9a39b93ddd41f51df790b5))
chore: increase version
2015-09-04 18:19:55 +00:00
#### Performance
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* changes ArgGroup HashSets to Vec ([3cb4a48e](https://github.com/clap-rs/clap/commit/3cb4a48ebd15c20692f4f3a2a924284dc7fd5e10))
* changes BTreeSet for Vec in some instances ([baab2e3f](https://github.com/clap-rs/clap/commit/baab2e3f4060e811abee14b1654cbcd5cf3b5fea))
chore: increase version
2015-09-04 18:19:55 +00:00
chore: increase version
2015-09-01 04:28:44 +00:00
## v1.3.0 (2015-09-01)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **YAML:** allows building a CLI from YAML files ([86cf4c45](https://github.com/clap-rs/clap/commit/86cf4c45626a36b8115446952f9069f73c1debc3))
* **ArgGroups:** adds support for building ArgGroups from yaml ([ecf88665](https://github.com/clap-rs/clap/commit/ecf88665cbff367018b29161a1b75d44a212707d))
* **Subcommands:** adds support for subcommands from yaml ([e415cf78](https://github.com/clap-rs/clap/commit/e415cf78ba916052d118a8648deba2b9c16b1530))
chore: increase version
2015-09-01 04:28:44 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **YAML:** adds examples for using YAML to build a CLI ([ab41d7f3](https://github.com/clap-rs/clap/commit/ab41d7f38219544750e6e1426076dc498073191b))
* **Args from YAML:** fixes doc examples ([19b348a1](https://github.com/clap-rs/clap/commit/19b348a10050404cd93888dbbbe4f396681b67d0))
* **Examples:** adds better usage examples instead of having unused variables ([8cbacd88](https://github.com/clap-rs/clap/commit/8cbacd8883004fe71a8ea036ec4391c7dd8efe94))
chore: increase version
2015-09-01 04:28:44 +00:00
#### Examples
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Add AppSettings example ([12705079](https://github.com/clap-rs/clap/commit/12705079ca96a709b4dd94f7ddd20a833b26838c))
chore: increase version
2015-09-01 04:28:44 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Unified Help Messages:** fixes a crash from this setting and no opts ([169ffec1](https://github.com/clap-rs/clap/commit/169ffec1003d58d105d7ef2585b3425e57980000), closes [#210](https://github.com/clap-rs/clap/issues/210))
chore: increase version
2015-09-01 04:28:44 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.2.5 (2015-08-27)
chore: increase version
2015-08-27 16:12:56 +00:00
chore: new clog section for examples
2015-08-27 16:48:03 +00:00
#### Examples
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* add custom validator example ([b9997d1f](https://github.com/clap-rs/clap/commit/b9997d1fca74d4d8f93971f2a01bdf9798f913d5))
* fix indentation ([d4f1b740](https://github.com/clap-rs/clap/commit/d4f1b740ede410fd2528b9ecd89592c2fd8b1e20))
chore: new clog section for examples
2015-08-27 16:48:03 +00:00
chore: increase version
2015-08-27 16:12:56 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Args:** allows opts and args to define a name for help and usage msgs ([ad962ec4](https://github.com/clap-rs/clap/commit/ad962ec478da999c7dba0afdb84c266f4d09b1bd))
chore: increase version
2015-08-27 16:12:56 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.2.4 (2015-08-26)
chore: increase version
2015-08-26 23:58:58 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Possible Values:** fixes a bug where suggestions aren't made when using --long=value format ([3d5e9a6c](https://github.com/clap-rs/clap/commit/3d5e9a6cedb26668839b481c9978e2fbbab8be6f), closes [#192](https://github.com/clap-rs/clap/issues/192))
chore: increase version
2015-08-26 23:58:58 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.2.3 (2015-08-24)
chore: increase version
2015-08-24 18:32:29 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **App, Args:** fixed subcommand reqs negation ([b41afa8c](https://github.com/clap-rs/clap/commit/b41afa8c3ded3d1be12f7a2f8ea06cc44afc9458), closes [#188](https://github.com/clap-rs/clap/issues/188))
chore: increase version
2015-08-24 18:32:29 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.2.2 (2015-08-23)
chore: increase version
2015-08-23 15:48:21 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixed confusing error message, also added test for it ([fc7a31a7](https://github.com/clap-rs/clap/commit/fc7a31a745efbf1768ee2c62cd3bb72bfe30c708))
* **App:** fixed requirmets overriding ([9c135eb7](https://github.com/clap-rs/clap/commit/9c135eb790fa16183e5bdb2009ddc3cf9e25f99f))
chore: increase version
2015-08-23 15:48:21 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.2.1 (2015-08-20)
chore: increase version
2015-08-20 02:07:02 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **README.md:** updates for new features ([16cf9245](https://github.com/clap-rs/clap/commit/16cf9245fb5fc4cf6face898e358368bf9961cbb))
chore: increase version
2015-08-20 02:07:02 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* implements posix compatible conflicts for long args ([8c2d48ac](https://github.com/clap-rs/clap/commit/8c2d48acf5473feebd721a9049a9c9b7051e70f9))
* added overrides to support conflicts in POSIX compatible manner ([0b916a00](https://github.com/clap-rs/clap/commit/0b916a00de26f6941538f6bc5f3365fa302083c1))
* **Args:** allows defining POSIX compatible argument conflicts ([d715646e](https://github.com/clap-rs/clap/commit/d715646e69759ccd95e01f49b04f489827ecf502))
chore: increase version
2015-08-20 02:07:02 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixed links in cargo and license buttons ([6d9837ad](https://github.com/clap-rs/clap/commit/6d9837ad9a9e006117cd7372fdc60f9a3889c7e2))
chore: increase version
2015-08-20 02:07:02 +00:00
#### Performance
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Args and Apps:** changes HashSet->Vec in some instances for increased performance ([d0c3b379](https://github.com/clap-rs/clap/commit/d0c3b379700757e0a9b0c40af709f8af1f5b4949))
chore: increase version
2015-08-20 02:07:02 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.2.0 (2015-08-15)
chore: increase version
2015-08-15 00:30:37 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixed misspell and enum name ([7df170d7](https://github.com/clap-rs/clap/commit/7df170d7f4ecff06608317655d1e0c4298f62076))
* fixed use for clap crate ([dc3ada73](https://github.com/clap-rs/clap/commit/dc3ada738667d4b689678f79d14251ee82004ece))
chore: increase version
2015-08-15 00:30:37 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* updates docs for new features ([03496547](https://github.com/clap-rs/clap/commit/034965471782d872ca495045b58d34b31807c5b1))
* fixed docs for previous changes ([ade36778](https://github.com/clap-rs/clap/commit/ade367780c366425de462506d256e0f554ed3b9c))
chore: increase version
2015-08-15 00:30:37 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **AppSettings:** adds ability to add multiple settings at once ([4a00e251](https://github.com/clap-rs/clap/commit/4a00e2510d0ca8d095d5257d51691ba3b61c1374))
chore: increase version
2015-08-15 00:30:37 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* Replace application level settings with enum variants ([618dc4e2](https://github.com/clap-rs/clap/commit/618dc4e2c205bf26bc43146164e65eb1f6b920ed))
* **Args:** allows for custom argument value validations to be defined ([84ae2ddb](https://github.com/clap-rs/clap/commit/84ae2ddbceda34b5cbda98a6959edaa52fde2e1a), closes [#170](https://github.com/clap-rs/clap/issues/170))
chore: increase version
2015-08-15 00:30:37 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.1.6 (2015-08-01)
chore: increase version
2015-08-01 04:55:52 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes two bugs in App when printing newlines in help and subcommands required error ([d63c0136](https://github.com/clap-rs/clap/commit/d63c0136310db9dd2b1c7b4745938311601d8938))
chore: increase version
2015-08-01 04:55:52 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.1.5 (2015-07-29)
chore: increase version
2015-07-29 22:32:37 +00:00
#### Performance
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* removes some unneeded allocations ([93e915df](https://github.com/clap-rs/clap/commit/93e915dfe300f7b7d6209ca93323c6a46f89a8c1))
chore: increase version
2015-07-29 22:32:37 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.1.4 (2015-07-20)
chore: increase version
2015-07-20 02:04:40 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Usage Strings** displays a [--] when it may be helpful ([86c3be85](https://github.com/clap-rs/clap/commit/86c3be85fb6f77f83b5a6d2df40ae60937486984))
chore: increase version
2015-07-20 02:04:40 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Macros** fixes a typo in a macro generated error message ([c9195c5f](https://github.com/clap-rs/clap/commit/c9195c5f92abb8cd6a37b4f4fbb2f1fee2a8e368))
* **Type Errors** fixes formatting of error output when failed type parsing ([fe5d95c6](https://github.com/clap-rs/clap/commit/fe5d95c64f3296e6eddcbec0cb8b86659800145f))
chore: increase version
2015-07-20 02:04:40 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.1.3 (2015-07-18)
chore: increase version
2015-07-18 15:03:53 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* updates README.md to include lack of color support on Windows ([52f81e17](https://github.com/clap-rs/clap/commit/52f81e17377b18d2bd0f34693b642b7f358998ee))
chore: increase version
2015-07-18 15:03:53 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes formatting bug which prevented compiling on windows ([9cb5dceb](https://github.com/clap-rs/clap/commit/9cb5dceb3e5fe5e0e7b24619ff77e5040672b723), closes [#163](https://github.com/clap-rs/clap/issues/163))
chore: increase version
2015-07-18 15:03:53 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.1.2 (2015-07-17)
chore: increase version
2015-07-17 02:17:18 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes a bug when parsing multiple {n} newlines inside help strings ([6d214b54](https://github.com/clap-rs/clap/commit/6d214b549a9b7e189a94e5fa2b7c92cc333ca637))
chore: increase version
2015-07-17 02:17:18 +00:00
chore: increase version
2015-07-17 01:42:15 +00:00
## v1.1.1 (2015-07-17)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* fixes a logic bug and allows setting Arg::number_of_values() < 2 ([42b6d1fc](https://github.com/clap-rs/clap/commit/42b6d1fc3c519c92dfb3af15276e7d3b635e6cfe), closes [#161](https://github.com/clap-rs/clap/issues/161))
chore: increase version
2015-07-17 01:42:15 +00:00
chore: increase version
2015-07-16 05:46:24 +00:00
## v1.1.0 (2015-07-16)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* allows creating unified help messages, a la docopt or getopts ([52bcd892](https://github.com/clap-rs/clap/commit/52bcd892ea51564ce463bc5865acd64f8fe91cb1), closes [#158](https://github.com/clap-rs/clap/issues/158))
* allows stating all subcommands should *not* have --version flags ([336c476f](https://github.com/clap-rs/clap/commit/336c476f631d512b54ac56fdca6f29ebdc2c00c5), closes [#156](https://github.com/clap-rs/clap/issues/156))
* allows setting version number to auto-propagate through subcommands ([bc66d3c6](https://github.com/clap-rs/clap/commit/bc66d3c6deedeca62463fff95369ab1cfcdd366b), closes [#157](https://github.com/clap-rs/clap/issues/157))
chore: increase version
2015-07-16 05:46:24 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Strings** properly aligns and handles newlines in long help strings ([f9800a29](https://github.com/clap-rs/clap/commit/f9800a29696dd2cc0b0284bf693b3011831e556f), closes [#145](https://github.com/clap-rs/clap/issues/145))
chore: increase version
2015-07-16 05:46:24 +00:00
#### Performance
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help Messages** big performance improvements when printing help messages ([52bcd892](https://github.com/clap-rs/clap/commit/52bcd892ea51564ce463bc5865acd64f8fe91cb1))
chore: increase version
2015-07-16 05:46:24 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* updates readme with new features ([8232f7bb](https://github.com/clap-rs/clap/commit/8232f7bb52e88862bc13c3d4f99ee4f56cfe4bc0))
* fix incorrect code example for `App::subcommand_required` ([8889689d](https://github.com/clap-rs/clap/commit/8889689dc6336ccc45b2c9f2cf8e2e483a639e93))
chore: increase version
2015-07-16 05:46:24 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.0.3 (2015-07-11)
chore: increase version
2015-07-11 15:30:33 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Errors** writes errors to stderr ([cc76ab8c](https://github.com/clap-rs/clap/commit/cc76ab8c2b77c67b42f4717ded530df7806142cf), closes [#154](https://github.com/clap-rs/clap/issues/154))
chore: increase version
2015-07-11 15:30:33 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **README.md** updates example help message to new format ([0aca29bd](https://github.com/clap-rs/clap/commit/0aca29bd5d6d1a4e9971bdc88d946ffa58606efa))
chore: increase version
2015-07-11 15:30:33 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.0.2 (2015-07-09)
chore: increase version
2015-07-09 14:28:03 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Usage** re-orders optional arguments and required to natural standard ([dc7e1fce](https://github.com/clap-rs/clap/commit/dc7e1fcea5c85d317018fb201d2a9262249131b4), closes [#147](https://github.com/clap-rs/clap/issues/147))
chore: increase version
2015-07-09 14:28:03 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v1.0.1 (2015-07-08)
chore: increase version
2015-07-08 19:03:23 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* allows empty values when using --long='' syntax ([083f82d3](https://github.com/clap-rs/clap/commit/083f82d333b69720a6ef30074875310921d964d1), closes [#151](https://github.com/clap-rs/clap/issues/151))
chore: increase version
2015-07-08 19:03:23 +00:00
chore: increase version
2015-07-08 00:20:45 +00:00
## v1.0.0 (2015-07-08)
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **README.md** adds new features to what's new list ([938f7f01](https://github.com/clap-rs/clap/commit/938f7f01340f521969376cf4e2e3d9436bca21f7))
* **README.md** use with_name for subcommands ([28b7e316](https://github.com/clap-rs/clap/commit/28b7e3161fb772e5309042648fe8c3a420645bac))
chore: increase version
2015-07-08 00:20:45 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* args can now be parsed from arbitrary locations, not just std::env::args() ([75312528](https://github.com/clap-rs/clap/commit/753125282b1b9bfff875f1557ce27610edcc59e1))
chore: increase version
2015-07-08 00:20:45 +00:00
chore: increase version
2015-06-30 02:29:01 +00:00
## v1.0.0-beta (2015-06-30)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* allows waiting for user input on error ([d0da3bdd](https://github.com/clap-rs/clap/commit/d0da3bdd9d1871541907ea9c645322a74d260e07), closes [#140](https://github.com/clap-rs/clap/issues/140))
* **Help** allows one to fully override the auto-generated help message ([26d5ae3e](https://github.com/clap-rs/clap/commit/26d5ae3e330d1e150811d5b60b2b01a8f8df854e), closes [#141](https://github.com/clap-rs/clap/issues/141))
chore: increase version
2015-06-30 02:29:01 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* adds "whats new" section to readme ([ff149a29](https://github.com/clap-rs/clap/commit/ff149a29dd9e179865e6d577cd7dc87c54f8f95c))
chore: increase version
2015-06-30 02:29:01 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* removes deprecated functions in prep for 1.0 ([274484df](https://github.com/clap-rs/clap/commit/274484dfd08fff4859cefd7e9bef3b73d3a9cb5f))
chore: increase version
2015-06-30 02:29:01 +00:00
chore: increase version
2015-06-17 00:57:36 +00:00
## v0.11.0 (2015-06-17) - BREAKING CHANGE
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* updates docs to new version flag defaults ([ebf442eb](https://github.com/clap-rs/clap/commit/ebf442ebebbcd2ec6bfe2c06566c9d362bccb112))
chore: increase version
2015-06-17 00:57:36 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Help and Version** default short for version is now `-V` but can be overridden (only breaks manual documentation) (**BREAKING CHANGE** [eb1d9320](https://github.com/clap-rs/clap/commit/eb1d9320c509c1e4e57d7c7959da82bcfe06ada0))
chore: increase version
2015-06-17 00:57:36 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v0.10.5 (2015-06-06)
chore: increase version
2015-06-06 21:13:36 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Global Args** global arguments propagate fully now ([1f377960](https://github.com/clap-rs/clap/commit/1f377960a48c82f54ca5f39eb56bcb393140b046), closes [#137](https://github.com/clap-rs/clap/issues/137))
chore: increase version
2015-06-06 21:13:36 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v0.10.4 (2015-06-06)
chore: increase version
2015-06-06 20:46:34 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Global Args** global arguments propagate fully now ([8f2c0160](https://github.com/clap-rs/clap/commit/8f2c0160c8d844daef375a33dbaec7d89de00a00), closes [#137](https://github.com/clap-rs/clap/issues/137))
chore: increase version
2015-06-06 20:46:34 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v0.10.3 (2015-05-31)
chore: increase version
2015-05-31 04:47:29 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Global Args** fixes a bug where globals only transfer to one subcommand ([a37842ee](https://github.com/clap-rs/clap/commit/a37842eec1ee3162b86fdbda23420b221cdb1e3b), closes [#135](https://github.com/clap-rs/clap/issues/135))
chore: increase version
2015-05-31 04:47:29 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v0.10.2 (2015-05-30)
chore: increase version
2015-05-30 17:15:33 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Binary Names** allows users to override the system determined bin name ([2191fe94](https://github.com/clap-rs/clap/commit/2191fe94bda35771383b52872fb7f5421b178be1), closes [#134](https://github.com/clap-rs/clap/issues/134))
chore: increase version
2015-05-30 17:15:33 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* adds contributing guidelines ([6f76bd0a](https://github.com/clap-rs/clap/commit/6f76bd0a07e8b7419b391243ab2d6687cd8a9c5f))
chore: increase version
2015-05-30 17:15:33 +00:00
docs(change): More consistent formatting
2021-12-08 17:47:39 +00:00
## v0.10.1 (2015-05-26)
chore: increase version
2015-05-26 01:53:49 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* can now specify that an app or subcommand should display help on no args or subcommands ([29ca7b2f](https://github.com/clap-rs/clap/commit/29ca7b2f74376ca0cdb9d8ee3bfa99f7640cc404), closes [#133](https://github.com/clap-rs/clap/issues/133))
chore: increase version
2015-05-26 01:53:49 +00:00
chore: increase version
2015-05-23 03:40:20 +00:00
## v0.10.0 (2015-05-23)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Global Args** allows args that propagate down to child commands ([2bcc6137](https://github.com/clap-rs/clap/commit/2bcc6137a83cb07757771a0afea953e68e692f0b), closes [#131](https://github.com/clap-rs/clap/issues/131))
chore: increase version
2015-05-23 03:40:20 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Colors** implements more structured colored output ([d6c3ed54](https://github.com/clap-rs/clap/commit/d6c3ed54d21cf7b40d9f130d4280ff5448522fc5), closes [#129](https://github.com/clap-rs/clap/issues/129))
chore: increase version
2015-05-23 03:40:20 +00:00
#### Deprecations
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **SubCommand/App** several methods and functions for stable release ([28b73855](https://github.com/clap-rs/clap/commit/28b73855523ad170544afdb20665db98702fbe70))
chore: increase version
2015-05-23 03:40:20 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* updates for deprecations and new features ([743eefe8](https://github.com/clap-rs/clap/commit/743eefe8dd40c1260065ce086d572e9e9358bc4c))
chore: increase version
2015-05-23 03:40:20 +00:00
chore(clap): increase version
2015-05-20 15:50:03 +00:00
## v0.9.2 (2015-05-20)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **help** allows parent requirements to be ignored with help and version ([52218cc1](https://github.com/clap-rs/clap/commit/52218cc1fdb06a42456c964d98cc2c7ac3432412), closes [#124](https://github.com/clap-rs/clap/issues/124))
chore(clap): increase version
2015-05-20 15:50:03 +00:00
chore(clap): increase version
2015-05-18 00:24:13 +00:00
## v0.9.1 (2015-05-18)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **help** fixes a bug where requirements are included as program name in help and version ([08ba3f25](https://github.com/clap-rs/clap/commit/08ba3f25cf38b149229ba8b9cb37a5804fe6b789))
chore(clap): increase version
2015-05-18 00:24:13 +00:00
chore(clap): increase version
2015-05-17 22:26:03 +00:00
## v0.9.0 (2015-05-17)
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **usage** usage strings now include parent command requirements ([dd8f21c7](https://github.com/clap-rs/clap/commit/dd8f21c7c15cde348fdcf44fa7c205f0e98d2e4a), closes [#125](https://github.com/clap-rs/clap/issues/125))
* **args** allows consumer of clap to decide if empty values are allowed or not ([ab4ec609](https://github.com/clap-rs/clap/commit/ab4ec609ccf692b9b72cccef5c9f74f5577e360d), closes [#122](https://github.com/clap-rs/clap/issues/122))
chore(clap): increase version
2015-05-17 22:26:03 +00:00
#### Features
* **subcommands**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* allows optionally specifying that no subcommand is an error ([7554f238](https://github.com/clap-rs/clap/commit/7554f238fd3afdd60b7e4dcf00ff4a9eccf842c1), closes [#126](https://github.com/clap-rs/clap/issues/126))
* subcommands can optionally negate parent requirements ([4a4229f5](https://github.com/clap-rs/clap/commit/4a4229f500e21c350e1ef78dd09ef27559653288), closes [#123](https://github.com/clap-rs/clap/issues/123))
chore(clap): increase version
2015-05-17 22:26:03 +00:00
chore(clap): increase version
2015-05-17 13:55:23 +00:00
## v0.8.6 (2015-05-17)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **args** `-` can now be parsed as a value for an argument ([bc12e78e](https://github.com/clap-rs/clap/commit/bc12e78eadd7eaf9d008a8469fdd2dfd7990cb5d), closes [#121](https://github.com/clap-rs/clap/issues/121))
chore(clap): increase version
2015-05-17 13:55:23 +00:00
chore(clap): increase version
2015-05-15 20:48:08 +00:00
## v0.8.5 (2015-05-15)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **macros** makes macro errors consistent with others ([0c264a8c](https://github.com/clap-rs/clap/commit/0c264a8ca57ec1cfdcb74dae79145d766cdc9b97), closes [#118](https://github.com/clap-rs/clap/issues/118))
chore(clap): increase version
2015-05-15 20:48:08 +00:00
#### Features
* **macros**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* arg_enum! and simple_enum! provide a Vec<&str> of variant names ([30fa87ba](https://github.com/clap-rs/clap/commit/30fa87ba4e0f3189351d8f4f78b72e616a30d0bd), closes [#119](https://github.com/clap-rs/clap/issues/119))
* arg_enum! and simple_enum! auto-implement Display ([d1219f0d](https://github.com/clap-rs/clap/commit/d1219f0d1371d872061bd0718057eca4ef47b739), closes [#120](https://github.com/clap-rs/clap/issues/120))
chore(clap): increase version
2015-05-15 20:48:08 +00:00
chore(clap): increase version
2015-05-12 22:16:57 +00:00
## v0.8.4 (2015-05-12)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **suggestions** --help and --version now get suggestions ([d2b3b1fa](https://github.com/clap-rs/clap/commit/d2b3b1faa0bdc1c5d2350cc4635aba81e02e9d96), closes [#116](https://github.com/clap-rs/clap/issues/116))
chore(clap): increase version
2015-05-12 22:16:57 +00:00
chore(clap): increase version
2015-05-10 18:57:42 +00:00
## v0.8.3 (2015-05-10)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **usage** groups unfold their members in usage strings ([55d15582](https://github.com/clap-rs/clap/commit/55d155827ea4a6b077a83669701e797ce1ad68f4), closes [#114](https://github.com/clap-rs/clap/issues/114))
chore(clap): increase version
2015-05-10 18:57:42 +00:00
#### Performance
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **usage** removes unneeded allocations ([fd53cd18](https://github.com/clap-rs/clap/commit/fd53cd188555f5c3dc8bc341c5d7eb04b761a70f))
chore(clap): increase version
2015-05-10 18:57:42 +00:00
chore(clap): increase version
2015-05-08 15:46:51 +00:00
## v0.8.2 (2015-05-08)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **usage strings** positional arguments are presented in index order ([eb0e374e](https://github.com/clap-rs/clap/commit/eb0e374ecf952f1eefbc73113f21e0705936e40b), closes [#112](https://github.com/clap-rs/clap/issues/112))
chore(clap): increase version
2015-05-08 15:46:51 +00:00
chore(clap): increase version
2015-05-06 16:47:32 +00:00
## v0.8.1 (2015-05-06)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **subcommands** stops parsing multiple values when subcommands are found ([fc79017e](https://github.com/clap-rs/clap/commit/fc79017eced04fd41cc1801331e5054df41fac17), closes [#109](https://github.com/clap-rs/clap/issues/109))
chore(clap): increase version
2015-05-06 16:47:32 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **color** reduces color in error messages ([aab44cca](https://github.com/clap-rs/clap/commit/aab44cca6352f47e280c296e50c535f5d752dd46), closes [#110](https://github.com/clap-rs/clap/issues/110))
* **suggestions** adds suggested arguments to usage strings ([99447414](https://github.com/clap-rs/clap/commit/994474146e9fb8b701af773a52da71553d74d4b7))
chore(clap): increase version
2015-05-06 16:47:32 +00:00
chore(clap): increase version
2015-05-06 02:11:37 +00:00
## v0.8.0 (2015-05-06)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **did-you-mean** for review ([0535cfb0](https://github.com/clap-rs/clap/commit/0535cfb0c711331568b4de8080eeef80bd254b68))
* **Positional** positionals were ignored if they matched a subcmd, even after '--' ([90e7b081](https://github.com/clap-rs/clap/commit/90e7b0818741668b47cbe3becd029bab588e3553))
* **help** fixes bug where space between arg and help is too long ([632fb115](https://github.com/clap-rs/clap/commit/632fb11514c504999ea86bdce47cdd34f8ebf646))
chore(clap): increase version
2015-05-06 02:11:37 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **from_usage** adds ability to add value names or num of vals in usage string ([3d581976](https://github.com/clap-rs/clap/commit/3d58197674ed7886ca315efb76e411608a327501), closes [#98](https://github.com/clap-rs/clap/issues/98))
chore(clap): increase version
2015-05-06 02:11:37 +00:00
* **did-you-mean**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* gate it behind 'suggestions' ([c0e38351](https://github.com/clap-rs/clap/commit/c0e383515d01bdd5ca459af9c2f7e2cf49e2488b))
* for possible values ([1cc2deb2](https://github.com/clap-rs/clap/commit/1cc2deb29158e0e4e8b434e4ce26b3d819301a7d))
* for long flags (i.e. --long) ([52a0b850](https://github.com/clap-rs/clap/commit/52a0b8505c99354bdf5fd1cd256cf41197ac2d81))
* for subcommands ([06e869b5](https://github.com/clap-rs/clap/commit/06e869b5180258047ed3c60ba099de818dd25fff))
* **Flags** adds suggestions functionality ([8745071c](https://github.com/clap-rs/clap/commit/8745071c3257dd327c497013516f12a823df9530))
* **errors** colorizes output red on error ([f8b26b13](https://github.com/clap-rs/clap/commit/f8b26b13da82ba3ba9a932d3d1ab4ea45d1ab036))
chore(clap): increase version
2015-05-06 02:11:37 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **arg_enum** allows ascii case insensitivity for enum variants ([b249f965](https://github.com/clap-rs/clap/commit/b249f9657c6921c004764bd80d13ebca81585eec), closes [#104](https://github.com/clap-rs/clap/issues/104))
* **clap-test** simplified `make test` invocation ([d17dcb29](https://github.com/clap-rs/clap/commit/d17dcb2920637a1f58c61c596b7bd362fd53047c))
chore(clap): increase version
2015-05-06 02:11:37 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **README** adds details about optional and new features ([960389de](https://github.com/clap-rs/clap/commit/960389de02c9872aaee9adabe86987f71f986e39))
* **clap** fix typos caught by codespell ([8891d929](https://github.com/clap-rs/clap/commit/8891d92917aa1a069cca67272be41b99e548356e))
* **from_usage** explains new usage strings with multiple values ([05476fc6](https://github.com/clap-rs/clap/commit/05476fc61cd1e5f4a4e750d258c878732a3a9c64))
chore(clap): increase version
2015-05-06 02:11:37 +00:00
chore(clap): increase version
2015-05-05 03:47:33 +00:00
## v0.7.6 (2015-05-05)
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Options** adds number of values to options in help/usage ([c1c993c4](https://github.com/clap-rs/clap/commit/c1c993c419d18e35c443785053d8de9a2ef88073))
chore(clap): increase version
2015-05-05 03:47:33 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **from_usage** adds ability to add value names or num of vals in usage string ([ad55748c](https://github.com/clap-rs/clap/commit/ad55748c265cf27935c7b210307d2040b6a09125), closes [#98](https://github.com/clap-rs/clap/issues/98))
chore(clap): increase version
2015-05-05 03:47:33 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **MultipleValues** properly distinguishes between multiple values and multiple occurrences ([dd2a7564](https://github.com/clap-rs/clap/commit/dd2a75640ca68a91b973faad15f04df891356cef), closes [#99](https://github.com/clap-rs/clap/issues/99))
* **help** fixes tab alignment with multiple values ([847001ff](https://github.com/clap-rs/clap/commit/847001ff6d8f4d9518e810fefb8edf746dd0f31e))
chore(clap): increase version
2015-05-05 03:47:33 +00:00
#### Documentation
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **from_usage** explains new usage strings with multiple values ([5a3a42df](https://github.com/clap-rs/clap/commit/5a3a42dfa3a783537f88dedc0fd5f0edcb8ea372))
chore(clap): increase version
2015-05-05 03:47:33 +00:00
chore(clap): increase version
2015-05-04 00:36:22 +00:00
## v0.7.5 (2015-05-04)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Options** fixes bug where options with no value don't error out ([a1fb94be](https://github.com/clap-rs/clap/commit/a1fb94be53141572ffd97aad037295d4ffec82d0))
chore(clap): increase version
2015-05-04 00:36:22 +00:00
chore(clap): increase version
2015-05-03 21:11:05 +00:00
## v0.7.4 (2015-05-03)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **Options** fixes a bug where option arguments in succession get their values skipped ([f66334d0](https://github.com/clap-rs/clap/commit/f66334d0ce984e2b56e5c19abb1dd536fae9342a))
chore(clap): increase version
2015-05-03 21:11:05 +00:00
chore(clap): increase version
2015-05-03 20:29:17 +00:00
## v0.7.3 (2015-05-03)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **RequiredValues** fixes a bug where missing values are parsed as missing arguments ([93c4a723](https://github.com/clap-rs/clap/commit/93c4a7231ba1a08152648598f7aa4503ea82e4de))
chore(clap): increase version
2015-05-03 20:29:17 +00:00
#### Improvements
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **ErrorMessages** improves error messages and corrections ([a29c3983](https://github.com/clap-rs/clap/commit/a29c3983c4229906655a29146ec15a0e46dd942d))
* **ArgGroups** improves requirement and confliction support for groups ([c236dc5f](https://github.com/clap-rs/clap/commit/c236dc5ff475110d2a1b80e62903f80296163ad3))
chore(clap): increase version
2015-05-03 20:29:17 +00:00
chore(clap): increase version
2015-05-03 04:41:53 +00:00
## v0.7.2 (2015-05-03)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **RequiredArgs** fixes bug where required-by-default arguments are not listed in usage ([12aea961](https://github.com/clap-rs/clap/commit/12aea9612d290845ba86515c240aeeb0a21198db), closes [#96](https://github.com/clap-rs/clap/issues/96))
chore(clap): increase version
2015-05-03 04:41:53 +00:00
chore(clap): increase version
2015-05-01 02:21:23 +00:00
## v0.7.1 (2015-05-01)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **MultipleValues** stops evaluating values if the max or exact number of values was reached ([86d92c9f](https://github.com/clap-rs/clap/commit/86d92c9fdbf9f422442e9562977bbaf268dbbae1))
chore(clap): increase version
2015-05-01 02:21:23 +00:00
chore: increase version
2015-06-17 00:57:36 +00:00
## v0.7.0 (2015-04-30) - BREAKING CHANGE
chore(clap): increase version
2015-04-30 23:59:45 +00:00
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **from_usage** removes bug where usage strings have no help text ([ad4e5451](https://github.com/clap-rs/clap/commit/ad4e54510739aeabf75f0da3278fb0952db531b3), closes [#83](https://github.com/clap-rs/clap/issues/83))
chore(clap): increase version
2015-04-30 23:59:45 +00:00
#### Features
* **MultipleValues**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* add support for minimum and maximum number of values ([53f6b8c9](https://github.com/clap-rs/clap/commit/53f6b8c9d8dc408b4fa9f833fc3a63683873c42f))
* adds support limited number and named values ([ae09f05e](https://github.com/clap-rs/clap/commit/ae09f05e92251c1b39a83d372736fcc7b504e432))
* implement shorthand for options with multiple values ([6669f0a9](https://github.com/clap-rs/clap/commit/6669f0a9687d4f668523145d7bd5c007d1eb59a8))
* **arg** allow other types besides Vec for multiple value settings (**BREAKING CHANGE** [0cc2f698](https://github.com/clap-rs/clap/commit/0cc2f69839b9b1db5d06330771b494783049a88e), closes [#87](https://github.com/clap-rs/clap/issues/87))
* **usage** implement smart usage strings on errors ([d77048ef](https://github.com/clap-rs/clap/commit/d77048efb1e595ffe831f1a2bea2f2700db53b9f), closes [#88](https://github.com/clap-rs/clap/issues/88))
chore(clap): increase version
2015-04-30 23:59:45 +00:00
chore(clap): increase version
2015-04-29 03:49:59 +00:00
## v0.6.9 (2015-04-29)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **from_usage** removes bug where usage strings have no help text ([ad4e5451](https://github.com/clap-rs/clap/commit/ad4e54510739aeabf75f0da3278fb0952db531b3), closes [#83](https://github.com/clap-rs/clap/issues/83))
chore(clap): increase version
2015-04-29 03:49:59 +00:00
chore(clap): increase version
2015-04-27 04:59:58 +00:00
## 0.6.8 (2015-04-27)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **help** change long help --long=long -> --long <long> ([1e25abfc](https://github.com/clap-rs/clap/commit/1e25abfc36679ab89eae71bf98ced4de81992d00))
* **RequiredArgs** required by default args should no longer be required when their exclusions are present ([4bb4c3cc](https://github.com/clap-rs/clap/commit/4bb4c3cc076b49e86720e882bf8c489877199f2d))
chore(clap): increase version
2015-04-27 04:59:58 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **ArgGroups** add ability to create arg groups ([09eb4d98](https://github.com/clap-rs/clap/commit/09eb4d9893af40c347e50e2b717e1adef552357d))
chore(clap): increase version
2015-04-27 04:59:58 +00:00
chore(clap): increase version
2015-04-22 20:30:45 +00:00
## v0.6.7 (2015-04-22)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **from_usage** fix bug causing args to not be required ([b76129e9](https://github.com/clap-rs/clap/commit/b76129e9b71a63365d5c77a7f57b58dbd1e94d49))
chore(clap): increase version
2015-04-22 20:30:45 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **apps** add ability to display additional help info after auto-gen'ed help msg ([65cc259e](https://github.com/clap-rs/clap/commit/65cc259e4559cbe3653c865ec0c4b1e42a389b07))
chore(clap): increase version
2015-04-22 20:30:45 +00:00
chore(clap): increase version
2015-04-19 18:42:41 +00:00
## v0.6.6 (2015-04-19)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **from_usage** tabs and spaces should be treated equally ([4fd44181](https://github.com/clap-rs/clap/commit/4fd44181d55d8eb88caab1e625231cfa3129e347))
chore(clap): increase version
2015-04-19 18:42:41 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **macros.rs** add macro to get version from Cargo.toml ([c630969a](https://github.com/clap-rs/clap/commit/c630969aa3bbd386379219cae27ba1305b117f3e))
chore(clap): increase version
2015-04-19 18:42:41 +00:00
chore(clap): increase version
2015-04-19 02:32:29 +00:00
## v0.6.5 (2015-04-19)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **macros.rs** fix use statements for trait impls ([86e4075e](https://github.com/clap-rs/clap/commit/86e4075eb111937c8a7bdb344e866e350429f042))
chore(clap): increase version
2015-04-19 02:32:29 +00:00
chore(clap): increase version
2015-04-17 15:23:19 +00:00
## v0.6.4 (2015-04-17)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **macros** add ability to create enums pub or priv with derives ([2c499f80](https://github.com/clap-rs/clap/commit/2c499f8015a199827cdf1fa3ec4f6f171722f8c7))
chore(clap): increase version
2015-04-17 15:23:19 +00:00
chore(clap): increase version
2015-04-16 18:25:20 +00:00
## v0.6.3 (2015-04-16)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **macros** add macro to create custom enums to use as types ([fb672aff](https://github.com/clap-rs/clap/commit/fb672aff561c29db2e343d6c607138f141aca8b6))
chore(clap): increase version
2015-04-16 18:25:20 +00:00
chore(clap): increase version
2015-04-14 19:47:03 +00:00
## v0.6.2 (2015-04-14)
#### Features
* **macros**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* add ability to get multiple typed values or exit ([0b87251f](https://github.com/clap-rs/clap/commit/0b87251fc088234bee51c323c2b652d7254f7a59))
* add ability to get a typed multiple values ([e243fe38](https://github.com/clap-rs/clap/commit/e243fe38ddbbf845a46c0b9baebaac3778c80927))
* add convenience macro to get a typed value or exit ([4b7cd3ea](https://github.com/clap-rs/clap/commit/4b7cd3ea4947780d9daa39f3e1ddab53ad4c7fef))
* add convenience macro to get a typed value ([8752700f](https://github.com/clap-rs/clap/commit/8752700fbb30e89ee68adbce24489ae9a24d33a9))
chore(clap): increase version
2015-04-14 19:47:03 +00:00
chore(clap): increase version
2015-04-13 22:13:19 +00:00
## v0.6.1 (2015-04-13)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **from_usage** trim all whitespace before parsing ([91d29045](https://github.com/clap-rs/clap/commit/91d2904599bd602deef2e515dfc65dc2863bdea0))
chore(clap): increase version
2015-04-13 22:13:19 +00:00
chore(clap): increase version
2015-04-13 19:39:24 +00:00
## v0.6.0 (2015-04-13)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **tests** fix failing doc tests ([3710cd69](https://github.com/clap-rs/clap/commit/3710cd69162f87221a62464f63437c1ce843ad3c))
chore(clap): increase version
2015-04-13 19:39:24 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **app** add support for building args from usage strings ([d5d48bcf](https://github.com/clap-rs/clap/commit/d5d48bcf463a4e494ef758836bd69a4c220bbbb5))
* **args** add ability to create basic arguments from a usage string ([ab409a8f](https://github.com/clap-rs/clap/commit/ab409a8f1db9e37cc70200f6f4a84a162692e618))
chore(clap): increase version
2015-04-13 19:39:24 +00:00
chore(clap): increase version
2015-04-10 16:00:58 +00:00
## v0.5.14 (2015-04-10)
#### Bug Fixes
* **usage**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* remove unneeded space ([51372789](https://github.com/clap-rs/clap/commit/5137278942121bc2593ce6e5dc224ec2682549e6))
* remove warning about unused variables ([ba817b9d](https://github.com/clap-rs/clap/commit/ba817b9d815e37320650973f1bea0e7af3030fd7))
chore(clap): increase version
2015-04-10 16:00:58 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **usage** add ability to get usage string for subcommands too ([3636afc4](https://github.com/clap-rs/clap/commit/3636afc401c2caa966efb5b1869ef4f1ed3384aa))
chore(clap): increase version
2015-04-10 16:00:58 +00:00
chore(clap): increase version
2015-04-09 22:49:59 +00:00
## v0.5.13 (2015-04-09)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **SubCommands** add method to get name and subcommand matches together ([64e53928](https://github.com/clap-rs/clap/commit/64e539280e23e567cf5de393b346eb0ca20e7eb5))
* **ArgMatches** add method to get default usage string ([02462150](https://github.com/clap-rs/clap/commit/02462150ca750bdc7012627d7e8d96379d494d7f))
chore(clap): increase version
2015-04-09 22:49:59 +00:00
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.5.12 (2015-04-08)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **help** sort arguments by name so as to not display a random order ([f4b2bf57](https://github.com/clap-rs/clap/commit/f4b2bf5767386013069fb74862e6e938dacf44d2))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.5.11 (2015-04-08)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **flags** fix bug not allowing users to specify -v or -h ([90e72cff](https://github.com/clap-rs/clap/commit/90e72cffdee321b79eea7a2207119533540062b4))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.5.10 (2015-04-08)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **help** fix spacing when option argument has not long version ([ca17fa49](https://github.com/clap-rs/clap/commit/ca17fa494b68e92da83ee364bf64b0687006824b))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.5.9 (2015-04-08)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **positional args** all previous positional args become required when a latter one is required ([c14c3f31](https://github.com/clap-rs/clap/commit/c14c3f31fd557c165570b60911d8ee483d89d6eb), closes [#50](https://github.com/clap-rs/clap/issues/50))
* **clap** remove unstable features for Rust 1.0 ([9abdb438](https://github.com/clap-rs/clap/commit/9abdb438e36e364d41550e7f5d44ebcaa8ee6b10))
* **args** improve error messages for arguments with mutual exclusions ([18dbcf37](https://github.com/clap-rs/clap/commit/18dbcf37024daf2b76ca099a6f118b53827aa339), closes [#51](https://github.com/clap-rs/clap/issues/51))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.5.8 (2015-04-08)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **option args** fix bug in getting the wrong number of occurrences for options ([82ad6ad7](https://github.com/clap-rs/clap/commit/82ad6ad77539cf9f9a03b78db466f575ebd972cc))
* **help** fix formatting for option arguments with no long ([e8691004](https://github.com/clap-rs/clap/commit/e869100423d93fa3acff03c4620cbcc0d0e790a1))
* **flags** add assertion to catch flags with specific value sets ([a0a2a40f](https://github.com/clap-rs/clap/commit/a0a2a40fed57f7c5ad9d68970d090e9856306c7d), closes [#52](https://github.com/clap-rs/clap/issues/52))
* **args** improve error messages for arguments with mutual exclusions ([bff945fc](https://github.com/clap-rs/clap/commit/bff945fc5d03bba4266533340adcffb002508d1b), closes [#51](https://github.com/clap-rs/clap/issues/51))
* **tests** add missing .takes_value(true) to option2 ([bdb0e88f](https://github.com/clap-rs/clap/commit/bdb0e88f696c8595c3def3bfb0e52d538c7be085))
* **positional args** all previous positional args become required when a latter one is required ([343d47dc](https://github.com/clap-rs/clap/commit/343d47dcbf83786a45c0d0f01b27fd9dd76725de), closes [#50](https://github.com/clap-rs/clap/issues/50))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.5.7 (2015-04-08)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **args** fix bug in arguments who are required and mutually exclusive ([6ceb88a5](https://github.com/clap-rs/clap/commit/6ceb88a594caae825605abc1cdad95204996bf29))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.5.6 (2015-04-08)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **help** fix formatting of help and usage ([28691b52](https://github.com/clap-rs/clap/commit/28691b52f67e65c599e10e4ea2a0f6f9765a06b8))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.5.5 (2015-04-08)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **help** fix formatting of help for flags and options ([6ec10115](https://github.com/clap-rs/clap/commit/6ec1011563a746f0578a93b76d45e63878e0f9a8))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.5.4 (2015-04-08)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **help** add '...' to indicate multiple values supported ([297ddba7](https://github.com/clap-rs/clap/commit/297ddba77000e2228762ab0eca50b480f7467386))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.5.3 (2015-04-08)
#### Features
* **positionals**
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* add assertions for positional args with multiple vals ([b7fa72d4](https://github.com/clap-rs/clap/commit/b7fa72d40f18806ec2042dd67a518401c2cf5681))
* add support for multiple values ([80784009](https://github.com/clap-rs/clap/commit/807840094109fbf90b348039ae22669ef27889ba))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.5.2 (2015-04-08)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **apps** allow use of hyphens in application and subcommand names ([da549dcb](https://github.com/clap-rs/clap/commit/da549dcb6c7e0d773044ab17829744483a8b0f7f))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.5.1 (2015-04-08)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **args** determine if the only arguments allowed are also required ([0a09eb36](https://github.com/clap-rs/clap/commit/0a09eb365ced9a03faf8ed24f083ef730acc90e8))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.5.0 (2015-04-08)
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **args** add support for a specific set of allowed values on options or positional arguments ([270eb889](https://github.com/clap-rs/clap/commit/270eb88925b6dc2881bff1f31ee344f085d31809))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.4.18 (2015-04-08)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **usage** display required args in usage, even if only required by others ([1b7316d4](https://github.com/clap-rs/clap/commit/1b7316d4a8df70b0aa584ccbfd33f68966ad2a54))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **subcommands** properly list subcommands in help and usage ([4ee02344](https://github.com/clap-rs/clap/commit/4ee023442abc3dba54b68138006a52b714adf331))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.4.17 (2015-04-08)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **tests** remove cargo test from claptests makefile ([1cf73817](https://github.com/clap-rs/clap/commit/1cf73817d6fb1dccb5b6a23b46c2efa8b567ad62))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
## v0.4.16 (2015-04-08)
#### Bug Fixes
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **option** fix bug with option occurrence values ([9af52e93](https://github.com/clap-rs/clap/commit/9af52e93cef9e17ac9974963f132013d0b97b946))
* **tests** fix testing script bug and formatting ([d8f03a55](https://github.com/clap-rs/clap/commit/d8f03a55c4f74d126710ee06aad5a667246a8001))
docs(changelog.md): switch to conventional changelog using clog
2015-04-08 02:26:55 +00:00
#### Features
docs: Update old repo location
2021-12-07 14:14:41 +00:00
* **arg** allow lifetimes other than 'static in arguments ([9e8c1fb9](https://github.com/clap-rs/clap/commit/9e8c1fb9406f8448873ca58bab07fe905f1551e5))
docs: Clean up 3.0 changelog
2021-12-01 22:48:20 +00:00
<!-- next-url -->
docs: Forward integrate v3's changelog
2022-08-30 13:54:00 +00:00
[Unreleased]: https://github.com/clap-rs/clap/compare/v3.2.18...HEAD
[3.2.18]: https://github.com/clap-rs/clap/compare/v3.2.17...v3.2.18
[3.2.17]: https://github.com/clap-rs/clap/compare/v3.2.16...v3.2.17
[3.2.16]: https://github.com/clap-rs/clap/compare/v3.2.15...v3.2.16
[3.2.15]: https://github.com/clap-rs/clap/compare/v3.2.14...v3.2.15
chore: Release
2022-07-21 01:13:29 +00:00
[3.2.14]: https://github.com/clap-rs/clap/compare/v3.2.13...v3.2.14
chore: Release
2022-07-19 19:41:47 +00:00
[3.2.13]: https://github.com/clap-rs/clap/compare/v3.2.12...v3.2.13
chore: Release
2022-07-14 14:38:54 +00:00
[3.2.12]: https://github.com/clap-rs/clap/compare/v3.2.11...v3.2.12
chore: Release
2022-07-13 14:08:35 +00:00
[3.2.11]: https://github.com/clap-rs/clap/compare/v3.2.10...v3.2.11
chore: Release
2022-07-12 02:48:07 +00:00
[3.2.10]: https://github.com/clap-rs/clap/compare/v3.2.8...v3.2.10
chore: Release
2022-06-30 13:25:54 +00:00
[3.2.8]: https://github.com/clap-rs/clap/compare/v3.2.7...v3.2.8
chore: Release
2022-06-28 13:04:18 +00:00
[3.2.7]: https://github.com/clap-rs/clap/compare/v3.2.6...v3.2.7
chore: Release
2022-06-21 14:32:04 +00:00
[3.2.6]: https://github.com/clap-rs/clap/compare/v3.2.5...v3.2.6
chore: Release
2022-06-15 16:50:16 +00:00
[3.2.5]: https://github.com/clap-rs/clap/compare/v3.2.4...v3.2.5
chore: Release
2022-06-14 20:01:42 +00:00
[3.2.4]: https://github.com/clap-rs/clap/compare/v3.2.3...v3.2.4
chore: Release
2022-06-14 16:19:59 +00:00
[3.2.3]: https://github.com/clap-rs/clap/compare/v3.2.2...v3.2.3
chore: Release
2022-06-14 12:02:40 +00:00
[3.2.2]: https://github.com/clap-rs/clap/compare/v3.2.1...v3.2.2
chore: Release
2022-06-13 14:37:47 +00:00
[3.2.1]: https://github.com/clap-rs/clap/compare/v3.2.0...v3.2.1
chore: Release
2022-06-13 14:31:29 +00:00
[3.2.0]: https://github.com/clap-rs/clap/compare/v3.1.18...v3.2.0
chore: Release
2022-05-10 20:29:16 +00:00
[3.1.18]: https://github.com/clap-rs/clap/compare/v3.1.17...v3.1.18
chore: Release
2022-05-06 16:57:48 +00:00
[3.1.17]: https://github.com/clap-rs/clap/compare/v3.1.16...v3.1.17
chore: Release
2022-05-06 02:04:09 +00:00
[3.1.16]: https://github.com/clap-rs/clap/compare/v3.1.15...v3.1.16
chore: Release
2022-05-02 18:02:10 +00:00
[3.1.15]: https://github.com/clap-rs/clap/compare/v3.1.14...v3.1.15
chore: Release
2022-05-01 01:21:33 +00:00
[3.1.14]: https://github.com/clap-rs/clap/compare/v3.1.13...v3.1.14
chore: Release
2022-04-30 11:36:33 +00:00
[3.1.13]: https://github.com/clap-rs/clap/compare/v3.1.12...v3.1.13
chore: Release
2022-04-22 11:52:05 +00:00
[3.1.12]: https://github.com/clap-rs/clap/compare/v3.1.11...v3.1.12
chore: Release
2022-04-22 01:08:49 +00:00
[3.1.11]: https://github.com/clap-rs/clap/compare/v3.1.10...v3.1.11
chore: Release
2022-04-19 15:31:52 +00:00
[3.1.10]: https://github.com/clap-rs/clap/compare/v3.1.9...v3.1.10
chore: Release
2022-04-15 19:39:14 +00:00
[3.1.9]: https://github.com/clap-rs/clap/compare/v3.1.8...v3.1.9
chore: Release
2022-04-01 14:15:32 +00:00
[3.1.8]: https://github.com/clap-rs/clap/compare/v3.1.7...v3.1.8
chore: Release
2022-03-31 17:22:40 +00:00
[3.1.7]: https://github.com/clap-rs/clap/compare/v3.1.6...v3.1.7
chore: Release
2022-03-07 16:40:48 +00:00
[3.1.6]: https://github.com/clap-rs/clap/compare/v3.1.5...v3.1.6
chore: Release
2022-03-02 15:49:11 +00:00
[3.1.5]: https://github.com/clap-rs/clap/compare/v3.1.4...v3.1.5
chore: Release
2022-03-02 15:20:00 +00:00
[3.1.4]: https://github.com/clap-rs/clap/compare/v3.1.3...v3.1.4
chore: Release
2022-02-28 16:03:45 +00:00
[3.1.3]: https://github.com/clap-rs/clap/compare/v3.1.2...v3.1.3
chore: Release
2022-02-23 15:39:40 +00:00
[3.1.2]: https://github.com/clap-rs/clap/compare/v3.1.1...v3.1.2
chore: Release
2022-02-21 13:50:28 +00:00
[3.1.1]: https://github.com/clap-rs/clap/compare/v3.1.0...v3.1.1
chore: Release
2022-02-16 17:59:45 +00:00
[3.1.0]: https://github.com/clap-rs/clap/compare/v3.0.14...v3.1.0
chore: Release
2022-02-01 22:11:53 +00:00
[3.0.14]: https://github.com/clap-rs/clap/compare/v3.0.13...v3.0.14
chore: Release
2022-01-26 21:54:12 +00:00
[3.0.13]: https://github.com/clap-rs/clap/compare/v3.0.12...v3.0.13
chore: Release
2022-01-24 21:34:27 +00:00
[3.0.12]: https://github.com/clap-rs/clap/compare/v3.0.11...v3.0.12
chore: Release
2022-01-24 16:54:50 +00:00
[3.0.11]: https://github.com/clap-rs/clap/compare/v3.0.10...v3.0.11
chore: Release
2022-01-18 20:59:58 +00:00
[3.0.10]: https://github.com/clap-rs/clap/compare/v3.0.9...v3.0.10
chore: Release
2022-01-18 02:34:09 +00:00
[3.0.9]: https://github.com/clap-rs/clap/compare/v3.0.8...v3.0.9
chore: Release
2022-01-17 15:37:45 +00:00
[3.0.8]: https://github.com/clap-rs/clap/compare/v3.0.7...v3.0.8
chore: Release
2022-01-12 17:12:42 +00:00
[3.0.7]: https://github.com/clap-rs/clap/compare/v3.0.6...v3.0.7
chore: Release
2022-01-10 22:16:18 +00:00
[3.0.6]: https://github.com/clap-rs/clap/compare/v3.0.5...v3.0.6
chore: Release
2022-01-05 22:28:24 +00:00
[3.0.5]: https://github.com/clap-rs/clap/compare/v3.0.4...v3.0.5
chore: Release
2022-01-04 19:07:10 +00:00
[3.0.4]: https://github.com/clap-rs/clap/compare/v3.0.3...v3.0.4
chore: Release
2022-01-04 17:42:50 +00:00
[3.0.3]: https://github.com/clap-rs/clap/compare/v3.0.2...v3.0.3
chore: Release
2022-01-04 15:49:41 +00:00
[3.0.2]: https://github.com/clap-rs/clap/compare/v3.0.1...v3.0.2
chore: Release
2022-01-03 18:12:28 +00:00
[3.0.1]: https://github.com/clap-rs/clap/compare/v3.0.0...v3.0.1
chore: Release
2021-12-31 20:34:55 +00:00
[3.0.0]: https://github.com/clap-rs/clap/compare/v2.34.0...v3.0.0
docs(change): Fix tag links
2021-12-08 17:49:17 +00:00
[2.34.0]: https://github.com/clap-rs/clap/compare/v2.33.4...v2.34.0
[2.33.4]: https://github.com/clap-rs/clap/compare/v2.33.3...v2.33.4
[2.33.3]: https://github.com/clap-rs/clap/compare/v2.33.2...v2.33.3
[2.33.2]: https://github.com/clap-rs/clap/compare/v2.33.1...v2.33.2
docs(change): Add v2 changelog This hasn't been cherry-picked in a while
2021-12-08 17:42:39 +00:00
[2.33.1]: https://github.com/clap-rs/clap/compare/v2.33.0...v2.33.1
[2.33.0]: https://github.com/clap-rs/clap/compare/v2.32.0...v2.33.0
Reference in a new issue Copy permalink