clap

v2.19.0 (2016-11-21)

Features

• allows specifying AllowLeadingHyphen style values, but only for specific args vice command wide (c0d70feb, closes #742)

Bug Fixes

• Required Unless: fixes a bug where having required_unless set doesn't work when conflicts are also set (d20331b6, closes #753)
• ZSH Completions: fixes an issue where zsh completions caused panics if there were no subcommands (49e7cdab, closes #754)

Improvements

• Validators: improves the error messages for validators (65eb3385, closes #744)

Documentation

• updates the docs landing page (01e1e33f)
• adds the macro version back to the readme (45eb9bf1)
• fix broken docs links (808e7cee)
• Compatibility Policy: adds an official compatibility policy to (760d66dc, closes #740)
• Contributing: updates the readme to improve the readability and contributing sections (eb51316c)

v2.18.0 (2016-11-05)

Features

• Completions: adds completion support for PowerShell. (cff82c88, closes #729)

v2.17.1 (2016-11-02)

Bug Fixes

• Low Index Multiples: fixes a bug where using low index multiples was propgated to subcommands (33924e88, closes #725)

v2.17.0 (2016-11-01)

Features

• Positional Args: allows specifying the second to last positional argument as multiple(true) (1ced2a74, closes #725)
• Adds App::get_name and App::get_bin_name

v2.16.4 (2016-10-31)

Improvements

• Error Output: conflicting errors are now symetrical, meaning more consistent and less confusing (3d37001d, closes #718)

Documentation

• Fix typo in example 13a_enum_values_automatic (c22fbc07)
• README.md: fixes failing yaml example (#715) (21fba9e6)

Bug Fixes

• ZSH Completions: fixes bug that caused panic on subcommands with aliases (5c70e1a0, closes #714)
• debug: fixes the debug feature (#716) (6c11ccf4)

v2.16.3 (2016-10-28)

Bug Fixes

• Derive display order after propagation (9cb6facf, closes #706)
• yaml-example: inconsistent args (847f7199)

v2.16.2 (2016-10-25)

Bug Fixes

• Fish Completions: fixes a bug where single quotes are not escaped (780b4a18, closes #704)

v2.16.1 (2016-10-24)

Bug Fixes

• Help Message: fixes a regression bug where args with multiple(true) threw off alignment (ebddac79, closes #702)

v2.16.0 (2016-10-23)

Features

• Completions: adds ZSH completion support (3e36b0ba, closes #699)

v2.15.0 (2016-10-21)

Features

• AppSettings: adds new setting AppSettings::AllowNegativeNumbers (ab064546, closes #696)

Documentation

• app/settings.rs: moves variants to roughly alphabetical order (9ed4d4d7)

v2.14.1 (2016-10-20)

Documentation

• Improve documentation around features (4ee85b95)
• reword docs for ErrorKind and app::Settings (3ccde7a4)
• fix tests that fail when the "suggestions" feature is disabled (996fc381)
• fix the OsString-using doc-tests (af9e1a39)
• tag non-rust code blocks as such instead of ignoring them (0ba9f4b1)
• ErrorKind: improve some errors about subcommands (9f6217a4)
• yaml: make sure the doc-tests don't fail before "missing file" (8c0f5551)

Improvements

• Stabilize clap_app! (cd516006)
• with_defaults: Deprecate App::with_defaults() (26085409, closes #638)

Bug Fixes

• fixes a bug that made determining when to auto-wrap long help messages inconsistent (468baadb, closes #688)
• Completions: fish completions for nested subcommands (a61eaf8a)
• features: Make lints not enable other nightly-requiring features (835f75e3)

v2.14.0 (2016-10-05)

Features

• arg_aliases: Ability to alias arguments (33b5f6ef, closes #669)
• flag_aliases: Ability to alias flags (40d6dac9)
• UsageParser: Handle non-ascii names / options. (1d6a7c6e, closes #664)

Documentation

• typo (bac417fa)

v2.12.1 (2016-09-13)

Bug Fixes

• Help Wrapping: fixes a regression-bug where the old {n} newline char stopped working (92ac353b, closes #661)

v2.12.0 (2016-09-13)

Features

• Help: adds ability to hide the possible values on a per argument basis (9151ef73, closes #640)
• help: allow for limiting detected terminal width (a43e28af, closes #653)

Documentation

• Help Wrapping: removes the verbage about using '{n}' to insert newlines in help text (c5a2b352)
• Value Delimiters: updates the docs for the Arg::multiple method WRT value delimiters and default settings (f9d17a06)
• appsettings: Document AppSetting::DisableVersion (94501965, closes #589)

Bug Fixes

• AllowLeadingHyphen: fixes a bug where valid args aren't recognized with this setting (a9699e4d, closes #588)

Improvements

• Help Wrapping:
  • clap now ignores hard newlines in help messages and properly re-aligns text, but still wraps if the term width is too small (c7678523, closes #617)
  • makes some minor changes to when next line help is automatically used (01cae799)
• Value Delimiters: changes the default value delimiter rules (f9e69254, closes #655)
• YAML: supports setting Arg::require_delimiter from YAML (b9b55a39)

Performance

• help: fix redundant contains() checks (a8afed74)

v2.11.2 (2016-09-06)

Improvements

• Help Wrapping: makes some minor changes to when next line help is automatically used (5658b117)

v2.11.0 (2016-08-28)

Bug Fixes

• Groups: fixes some usage strings that contain both args in groups and ones that conflict with each other (3d782def, closes #616)

Documentation

• moves docs to docs.rs (03209d5e, closes #634)

Improvements

• Completions: uses standard conventions for bash completion files, namely '{bin}.bash-completion' (27f5bbfb, closes #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, closes #597)
• YAML Errors: vastly improves error messages when using YAML (f43b7c65, closes #574)

Features

• adds App::with_defaults to automatically use crate_authors! and crate_version! macros (5520bb01, closes #600)
• Adds ability to determine term width and wrap help text intelligently on Windows!

v2.10.4 (2016-08-25)

Bug Fixes

• Help Wrapping: fixes a bug where help is wrapped incorrectly and causing a panic with some non-English characters (d0b442c7, closes #626)

a name="v2.10.1">

v2.10.1 (2016-08-21)

Bug Fixes

• Help Subcommand: fixes misleading usage string when using multi-level subcommmands (e203515e, closes #618)

Features

• YAML: allows using lists or single values with arg declarations (9ade2cd4, closes #614, #613)

v2.10.0 (2016-07-29)

Features

• Completions: one can generate a basic fish completions script at compile time (1979d2f2)

Bug Fixes

• parser: preserve external subcommand name (875df243)

Breaking Changes

• parser: preserve external subcommand name (875df243)

Documentation

• YAML: fixes example 17's incorrect reference to arg_groups instead of groups (b6c99e13, closes #601)

2.9.3 (2016-07-24)

Bug Fixes

• fixes bug where only first arg in list of required_unless_one is recognized (1fc3b55b, closes #575)
• Settings: fixes typo subcommandsrequired->subcommandrequired (fc72cdf5, closes #593)

Features

• Completions: adds the ability to generate completions to io::Write object (9f62cf73)
• Settings: Add unset_setting and unset_settings fns to App (#598) (0ceba231, closes #590)

v2.9.0 (2016-07-01)

Documentation

• Completions:
  • fixes some errors in the completion docs (9b359bf0)
  • adds documentation for completion scripts (c6c519e4)

Features

• Completions:
  • one can now generate a bash completions script at compile time! (e75b6c7b, closes #376)
  • completions now include aliases to subcommands, including all subcommand options (0ab9f840, closes #556)
  • completions now continue completing even after first completion (18fc2e5b)
  • allows matching on possible values in options (89cc2026, closes #557)

Bug Fixes

• AllowLeadingHyphen: fixes an issue where isn't ignored like it should be with this setting (96c24c9a, closes #558)

v2.7.1 (2016-06-29)

Bug Fixes

• Options:
  • options with multiple values and using delimiters no longer parse additional values after a trailing space (cdc500bd)
  • using options with multiple values and with an = no longer parse args after the trailing space as values (290f61d0)

v2.7.0 (2016-06-28)

Documentation

• fix typos (43b3d40b)
• ArgGroup: vastly improves ArgGroup docs by adding better examples (9e5f4f5d, closes #534)

Features

• ArgGroup: one can now specify groups which require AT LEAST one of the args (33689acc, closes #533)

Bug Fixes

• App: using App::print_help now prints the same as would have been printed by --help or the like (e84cc018, closes #536)
• Help:
  • prevents invoking help help and displaying incorrect help message (e3d2893f, closes #538)
  • subcommand help messages requested via help now correctly match --help (08ad1cff, closes #539)

Improvements

• ArgGroup: Add multiple ArgGroups per Arg (902e182f, closes #426)
• Usage Strings: [FLAGS] and [ARGS] are no longer blindly added to usage strings (9b2e45b1, closes #537)
• arg_enum!: allows using meta items like repr(C) with arg_enum!s (edf9b233, closes #543)

v2.6.0 (2016-06-14)

Improvements

• removes extra newline from help output (86e61d19)
• allows printing version to any io::Write object (921f5f79)
• removes extra newline when printing version (7e2e2cbb)
• Aliases: improves readability of asliases in help messages (ca511de7, closes #526, #529)
• Usage Strings: improves the default usage string when only a single positional arg is present (ec86f2da, closes #518)

Features

• Help: allows wrapping at specified term width (Even on Windows!) (1761dc0d, closes #451)
• Settings:
  • adds new setting to stop delimiting values with -- or TrailingVarArg (fc3e0f5a, closes #511)
  • one can now set an AppSetting which is propogated down through child subcommands (e2341835, closes #519)
• Subcommands: adds support for visible aliases (7b10e7f8, closes #522)

Bug Fixes

• fixes bug where args are printed out of order with templates (05abb534)
• fixes bug where one can't override version or help flags (90d7d6a2, closes #514)
• fixes issue where before_help wasn't printed (b3faff60)
• Help: App::before_help and App::after_help now correctly wrap (1f4da767, closes #516)
• Settings: fixes bug where new color settings couldn't be converted from strs (706a7c11)
• Subcommands: subcommands with aliases now display help of the aliased subcommand (5354d14b, closes #521)
• Windows: fixes a failing windows build (01e7dfd6)
• YAML: adds missing YAML methods for App and Arg (e468faf3, closes #528)