v4.5.37

Compare Source

Features

• Added ArgMatches::try_clear_id()

v4.5.36

Compare Source

Fixes

• (help) Revert 4.5.35's "Don't leave space for shorts if there are none" for now

v4.5.35

Compare Source

Fixes

• (help) Align positionals and flags when put in the same help_heading
• (help) Don't leave space for shorts if there are none

v4.5.34

Compare Source

Fixes

• (help) Don't add extra blank lines with flatten_help(true) and subcommands without arguments

v4.5.33

Compare Source

Fixes

• (error) When showing the usage of a suggestion for an unknown argument, don't show the group

v4.5.32

Compare Source

Features

• Add Error::remove

Documentation

• (cookbook) Switch from humantime to jiff
• (tutorial) Better cover required vs optional

Internal

• Update pulldown-cmark

v4.5.31

Compare Source

Features

• Add ValueParserFactory for Saturating<T>

v4.5.30

Compare Source

Fixes

• (assert) Allow num_args(0..=1) to be used with SetTrue
• (assert) Clean up rendering of takes_values assertions

v4.5.29

Compare Source

Fixes

• Change ArgMatches::args_present so not-present flags are considered not-present (matching the documentation)

v4.5.28

Compare Source

Features

• (derive) Unstable support for full markdown syntax for doc comments, enabled with unstable-markdown

v4.5.27

Compare Source

Documentation

• Iterate on tutorials and reference based on feedback

v4.5.26

Compare Source

Fixes

• (error) Reduce binary size with the suggestions feature

v4.5.25

Compare Source

Fixes

• (help) Reduce binary size

v4.5.24

Compare Source

Fixes

• (parser) Correctly handle defaults with ignore_errors(true) and when a suggestion is provided for an unknown argument

v4.5.23

Compare Source

Fixes

• (parser) When check allow_negative_numbers, allow E again

v4.5.22

Compare Source

Fixes

• (assert) Catch bugs with arguments requiring themself

v4.5.21

Compare Source

Fixes

• (parser) Ensure defaults are filled in on error with ignore_errors(true)

v4.5.20

Compare Source

Features

• (unstable) Add CommandExt

v4.5.19

Compare Source

Internal

• Update dependencies

v4.5.18

Compare Source

Features

• (builder) Expose Arg::get_display_order and Command::get_display_order

v4.5.17

Compare Source

Fixes

• (help) Style required argument groups
• (derive) Improve error messages when unsupported fields are used

v4.5.16

Compare Source

Fixes

• (derive) Improve error messages when derive feature is missing

v4.5.15

Compare Source

Compatiblity

• (unstable-ext) Arg::remove changed return types

Fixes

• (unstable-ext) Make Arg::remove return the removed item

v4.5.14

Compare Source

Features

• (unstable-ext) Added Arg::add for attaching arbitrary state, like completion hints, to Arg without Arg knowing about it

v4.5.13

Compare Source

Fixes

• (derive) Improve error message when #[flatten]ing an optional #[group(skip)]
• (help) Properly wrap long subcommand descriptions in help

v4.5.12

Compare Source

v4.5.11

Compare Source

v4.5.10

Compare Source

v4.5.9

Compare Source

Fixes

• (error) When defining a custom help flag, be sure to suggest it like we do the built-in one

v4.5.8

Compare Source

Fixes

• Reduce extra flushes

v4.5.7

Compare Source

Fixes

• Clean up error message when too few arguments for num_args

v4.5.6

Compare Source

v4.5.5

Compare Source

Fixes

• Allow exclusive to override required_unless_present, required_unless_present_any, required_unless_present_all

v4.5.4

Compare Source

Fixes

• (derive) Allow non-literal #[arg(id)] attributes again

v4.5.3

Compare Source

Features

• Added ArgMatches::try_clear_id()

v4.5.2

Compare Source

Fixes

• Change ArgMatches::args_present so not-present flags are considered not-present (matching the documentation)

v4.5.1

Compare Source

Internal

• Update dependencies

v4.5.0

Compare Source

Compatibility

• Update MSRV to 1.74

v4.4.18

Compare Source

Fixes

• (error) When lacking usage feature, ensure the list of required arguments is unique

v4.4.17

Compare Source

Fixes

• Fix panic! when mixing args_conflicts_with_subcommands with ArgGroup (which is implicit with derive) introduced in 4.4.15

v4.4.16

Compare Source

Fixes

• Ensure invalid escape sequences in user-defined strings are correctly stripped when terminal doesn't support color

v4.4.15

Compare Source

Fixes

• Improve error for args_conflicts_with_subcommands
• Ensure we error for args_conflicts_with_subcommands when using subcommand short and long flags

v4.4.14

Compare Source

Documentation

• Fix find cookbook entry to allow repeats of flags/options

Features

• Allow num_args(0) on options which allows making them emulate being a flag for position-tracking flags

v4.4.13

Compare Source

Documentation

• Fix link to structopt migration guide

v4.4.12

Compare Source

Performance

• Only ask TypedValueParser for possible values if needed

v4.4.11

Compare Source

Features

• Add Command::mut_group

v4.4.10

Compare Source

Documentation

• Link out to changelog
• Cross link derive's attribute reference to derive tutorial

v4.4.9

Compare Source

Fixes

• (help) Show correct Command::about under flattened headings
• (help) Respect hide when flattening subcommands

v4.4.8

Compare Source

Features

• Add Command::flatten_help to allow git stash -h like help for subcommands

v4.4.7

Compare Source

Performance

• Reduced code size

v4.4.6

Compare Source

Internal

• Upgrade anstream

v4.4.5

Compare Source

Fixes

• (parser) When inferring subcommand name or long_flag, allow ambiguous-looking matches that unambiguously map back to the same command
• (parser) When inferring subcommand long_flag, don't panic
• (assert) Clarify what action is causing a positional that doesn't set values which is especially useful for derive users

v4.4.4

Compare Source

Internal

• Update terminal_size to 0.3

v4.4.3

Compare Source

Documentation

• (derive) Clarify use of attributes within the tutorial
• Split sections in the builder and derive tutorials into separate modules

v4.4.2

Compare Source

Performance

• Improve build times by removing once_cell dependency

v4.4.1

Compare Source

Fixes

• (error) When lacking usage feature, ensure the list of required arguments is unique

v4.4.0

Compare Source

compatibility

• update msrv to 1.70.0

v4.3.24

Compare Source

Fixes

• Ensure column padding is preserved in --help with custom templates

v4.3.23

Compare Source

Fixes

• Fixed UnknownArgumentValueParser to not error on flag's absence

v4.3.22

Compare Source

Features

• Add UnknownArgumentValueParser for injecting errors for improving the experience with errors

v4.3.21

Compare Source

Features

• Expose TryMapValueParser so the type can be named

v4.3.20

Compare Source

Features

• Command::mut_args for modifying all arguments en masse

v4.3.19

Compare Source

Fixes

• (parse) Respect value_terminator even in the presence of later multiple-value positional arguments

v4.3.18

Compare Source

Fixes

• (parse) Suggest -- in fewer places where it won't work

v4.3.17

Compare Source

Fixes

• (help) Address a regression in wrapping PossibleValue descriptions in --help

v4.3.16

Compare Source

Fixes

• Don't assert when stateful value parsers fail on defaults (e.g. checking if a path exists)

v4.3.15

Compare Source

Features

• (unstable-styles) Re-export anstyle

Documentation

• (unstable-styles) Provide more examples

v4.3.14

Compare Source

Features

• ArgAction::HelpShort and ArgAction::HelpLong for explicitly specifying which style of help to display

Fixes

• Skip [OPTIONS] in usage if a help or version ArgAction is used

v4.3.13

Compare Source

v4.3.12

Compare Source

Fixes

• (derive) Don't error on enum variant field attributes

v4.3.11

Compare Source

Features

• (derive) Support fields wrapped in num::Wrapping, Box, or Arc
• (derive) Support Box<str>, Box<OsStr>, and Box<Path>

v4.3.10

Compare Source

Performance

• Drop a dependency, reducing binary size by 1.3 KiB

v4.3.9

Compare Source

Fixes

• Command::ignore_errors no longer masks help/version

v4.3.8

Compare Source

Fixes

• Error on ambiguity with infer_long_arg, rather than arbitrarily picking one, matching the documentation and subcommand's behavior

v4.3.7

Compare Source

Documentation

• Further clarify magic behavior in derive tutorial
• Further clarify derive API's relationship to builder within the tutorial

v4.3.6

Compare Source

Documentation

• Suggest clio

v4.3.5

Compare Source

• ColorChoice::possible_values is added to simplify things for builder users

Fixes

• ColorChoice::to_possible_value no longer includes descriptions, encouraging shorter help where possible

v4.3.4

Compare Source

Features

• Add Error::exit_code

v4.3.3

Compare Source

Features

• Command::defer for delayed initialization of subcommands to reduce startup times of large applications like deno

v4.3.2

Compare Source

Fixes

• Ensure column padding is preserved in --help with custom templates

v4.3.1

Compare Source

Fixes

• (parse) Respect value_terminator even in the presence of later multiple-value positional arguments

v4.3.0

Compare Source

Fixes

• (assert) Allow multiple, value-terminated, positional arguments
• (assert) Clear up language on last assertion
• (parser) Correctly assign values to arguments when using multiple, value-termianted, positional arguments
• (parser) Ensure value_terminator has higher precedence than allow_hyphen_values
• (help) Only use next-line-help on subcommand list when explicitly specified, not just with --help
• (help) Correctly align possible values list
• (help) Don't waste code, vertical space in moving possible value descriptions to next line

v4.2.7

Compare Source

Fixes

• Correctly track remaining length for iterators provided by ArgMatches

v4.2.6

Compare Source

Features

• impl Eq<std::any::TypeId> for clap_builder::util::AnyValueId

v4.2.5

Compare Source

Fixes

• Improve panic when a group requires a non-existent ID

v4.2.4

Compare Source

Documentation

• Corrected docs for Command::style

v4.2.3

Compare Source

Features

• Command::styles for theming help/errors (behind unstable-styles)

v4.2.2

Compare Source

Internal

• Update dependencies

v4.2.1

Compare Source

Fixes

• Don't highlight uninteresting parts of the error message

v4.2.0

Compare Source

Compatibility

• Removed the languishing unstable-replace feature (open to discussion at #​2836)
• Removed the stablized unstable-grouped feature

Features

• Allow any StyledStr to accept text styled with ANSI escape codes
• Respect CLICOLOR, CLICOLOR_FORCE

Fixes

• Lighten the tone for "unexpected argument" errors (open to discussion at #​4638)

v4.1.14

Compare Source

Features

• (derive) #[group] raw attribute support

Performance

• (derive) clap_builder was pulled out of clap so it could build in parallel to clap_derive
• os_str_bytes dependency was removed for faster builds and smaller binaries

v4.1.13

Compare Source

Performance

• Reduce repeated alloc calls when building a Command
• Reduce duplicate dependencies for faster builds

v4.1.12

Compare Source

Internal

• (derive) Update to syn v2

Performance

• (derive) Faster build times by dropping proc-macro-error dependency

v4.1.11

Compare Source

Internal

• Update bitflags

v4.1.10

Compare Source

Fixes

• (help) On Windows, avoid underlined text artifacts

v4.1.9

Compare Source

Fixes

• (assert) Improve the assert when using the wrong action with get_count / get_flag

v4.1.8

Compare Source

Fixes

• (derive) Don't deny lints on the users behalf

v4.1.7

Compare Source

Fixes

• (derive) Hide some nightly clippy warnings

v4.1.6

Compare Source

Fixes

• (help) Don't show long help for --help just because hidden possible values include a description

v4.1.5

Compare Source

Fixes

• (help) Don't show long help for --help just because a hidden arg has a possible value with a description

v4.1.4

Compare Source

Fixes

• (help) Respect disable_colored_help when using arg_required_else_help

Performance

• Speed up compiling arg! macro

v4.1.3

Compare Source

Fixes

• (error) Improve suggested flag/value/subcommand when two share a long preifx
• (error) When suggesting one of several subcommands, use the plural subcommands, rather than subcommand

v4.1.2

Compare Source

Fixes

• In documentation, refer to get_flag, rather than get_one::<bool>

v4.1.1

Compare Source

Features

• (derive) #[group] raw attribute support

Performance

• (derive) clap_builder was pulled out of clap so it could build in parallel to clap_derive
• os_str_bytes dependency was removed for faster builds and smaller binaries

v4.1.0

Compare Source

Compatibility

MSRV changed to 1.64.0

For apps with custom --help and --version flags:

• Descriptions for --help and --version changed

When apps have errors imitating clap's error style:

• Error message style was changed, including
  • Moving away from "did you mean" to tips
  • Leading letter is lower case
  • "For more" added some punctuation

Features

• ArgMatches::get_occurrences support for argument values to be grouped by their occurrence

Fixes

• (derive) Allow upgrade_from when arguments / subcommands are explicitly marked as required
• (help) Try be more clearer and succinct with --help and --version (also helps with overflow)
• (error) Try to be more clearer and succinct with error messages
• (error) Officially adopt an error style guide