clap

v2.5.1 (2016-05-11)

Bug Fixes

• Subcommand Aliases: fixes lifetime issue when setting multiple aliases at once (ac42f6cf0)

Improvements

• SubCommand Aliases: adds feature to yaml configs too (69592195)

Features

• SubCommands: adds support for subcommand aliases (66b4dea6, closes #469)

v2.4.3 (2016-05-10)

Bug Fixes

• Usage Strings:
  • now properly dedups args that are also in groups (3ca0947c, closes #498)
  • removes duplicate groups from usage strings (f574fb8a)

Improvements

• Groups: formats positional args in groups in a better way (fef11154)
• Help:
  • moves positionals to standard <> formatting (03dfe5ce)
  • default help subcommand string has been shortened (5b7fe8e4, closes #494)

v2.4.0 (2016-05-02)

Features

• Help: adds support for displaying info before help message (29fbfa3b)
• Required: adds allowing args that are required unless certain args are present (af1f7916)

Documentation

• hides formatting from docs (cb708093)
• required_unless: adds docs and examples for required_unless (ca727b52)

Bug Fixes

• Required Args: fixes issue where missing required args are sometimes duplicatd in error messages (3beebd81, closes #492)

v2.3.0 (2016-04-18)

Improvements

• macros.rs: Added write_nspaces macro (a new version of write_spaces) (9d757e86)
• parser.rs:
  • Provide a way to create a usage string without the USAGE: title (a91d378b)
  • Make Parser's create_usage public allowing to have function outside the parser to generate the help (d51945f8)
  • Expose Parser's flags, opts and positionals argument as iterators (9b23e7ee)
• src/args: Exposes argument display order by introducing a new Trait (1321630e)
• srs/args: Added longest_filter to AnyArg trait (65b3f667)

Features

• Authors Macro: adds a crate_authors macro (38fb59ab, closes #447)
• HELP:
  • implements optional colored help messages (abc8f669, closes #483)
  • Add a Templated Help system. (81e121ed)

Bug Fixes

• HELP: Adjust Help to semantic changes introduced in 6933b84 (8d23806b)

v2.2.5 (2016-04-03)

Bug Fixes

• Help Message: fixes bug where arg name is printed twice (71acf1d5, closes #472)

v2.2.4 (2016-03-30)

Bug Fixes

• fixes compiling with debug cargo feature (d4b55450)
• Empty Values: fixes bug where empty values weren't stored (885d166f, closes #470)

v2.2.3 (2016-03-28)

Bug Fixes

• Help Subcommand: fixes issue where help and version flags weren't properly displayed (205b07bf, closes #466)

a name="2.2.1">

2.2.1 (2016-03-16)

Features

• Help Message: wraps and aligns the help message of subcommands (813d75d0, closes #452)

Bug Fixes

• Help Message: fixes a bug where small terminal sizes causing a loop (1d73b035, closes #453)

v2.2.0 (2016-03-15)

Features

• Help Message: can auto wrap and aligning help text to term width (e36af026, closes #428)
• Help Subcommand: adds support passing additional subcommands to help subcommand (2c12757b, closes #416)
• Opts and Flags: adds support for custom ordering in help messages (9803b51e)
• Settings: adds support for automatically deriving custom display order of args (ad86e433, closes #444)
• Subcommands: adds support for custom ordering in help messages (7d2a2ed4, closes #442)

Bug Fixes

• From Usage: fixes a bug where adding empty lines werent ignored (c5c58c86)

Documentation

• Groups: explains required ArgGroups better (4ff0205b, closes #439)

v2.1.1 (2016-02-19)

Documentation

• AppSettings: clarifies that AppSettings do not propagate (3c8db0e9, closes #429)
• Arg Examples: adds better examples (1e79cccc)

Improvements

• Help: adds setting for next line help by arg (066df748, closes #427)

v2.1.0 (2016-02-10)

Features

• Defult Values: adds support for default values in args (73211952, closes #418)

Documentation

• Default Values: adds better examples and notes for default values (9facd74f)

v2.0.6 (2016-02-09)

Improvements

• Positional Arguments: now displays value name if appropriate (f0a99916, closes #420)

v2.0.3 (2016-02-02)

Improvements

• values: adds support for up to u64::max values per arg (c7abf7d7)
• occurrences: Allow for more than 256 occurrences of an argument. (3731ddb3)

Features

• AppSettings: adds HidePossibleValuesInHelp to skip writing those values (cdee7a0e)

Bug Fixes

• value_t_or_exit: fixes typo which causes value_t_or_exit to return a Result (ee96baff)

v2.0.2 (2016-01-31)

Improvements

• arg_enum: enum declared with arg_enum returns [&'static str; #] instead of Vec (9c4b8a1a)

Bug Fixes

• clap_app! should be gated by unstable, not nightly feature (0c8b84af)
• SubCommands: fixed where subcmds weren't recognized after mult args (c19c17a8, closes #405)
• Usage Parser: fixes a bug where literal single quotes weren't allowed in help strings (0bcc7120, closes #406)

v2.0.1 (2016-01-30)

Bug Fixes

• fixes cargo features to NOT require nightly with unstable features (dcbcc60c, closes #402)

v2.0.0 (2016-01-28)

Improvements

• From Usage: vastly improves the usage parser (fa3a2f86, closes #350)

Features

• adds support for external subcommands (177fe5cc, closes #372)
• adds support values with a leading hyphen (e4d429b9, closes #385)
• adds support for turning off the value delimiter (508db850, closes #352)
• adds support changing the value delimiter (dafeae8a, closes #353)
• adds support for comma separated values (e69da6af, closes #348)
• adds support with options with optional values (4555736c, closes #367)
• UTF-8: adds support for invalid utf8 in values (c5c59dec, closes #269)
• v2: implementing the base of 2.x (a3536054)

Bug Fixes

• fixes nightly build with new lints (17599195)
• fixes Windows build for 2x release (674c9b48, closes #392)
• fixes yaml build for 2x base (adceae64)

Documentation

• updates examples for 2x release (1303b360, closes #394)
• updates examples for 2x release (0a011f31, closes #394)
• updates documentation for v2 release (8d51724e)
• updating docs for 2x release (576d0e0e)
• README.md:
  • updates readme for v2 release (acaba01a, closes #393)
  • fix typo and make documentation conspicuous (07b9f614)

BREAKING CHANGES

• Fewer liftimes! Yay!
  • 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

v1.5.5 (2016-01-04)

Bug Fixes

• fixes an issue where invalid short args didn't cause an error (c9bf7e44)
• prints the name in version and help instead of binary name (8f3817f6, closes #368)
• fixes an intentional panic issue discovered via clippy (ea83a3d4)

v1.5.4 (2015-12-18)

Examples

• 17_yaml: conditinonally compile 17_yaml example (575de089)

Improvements

• clippy improvements (99cdebc2)

Bug Fixes

• errors: return correct error type in WrongNumValues error builder (5ba8ba9d)
• ArgRequiredElseHelp setting now takes precedence over missing required args (faad83fb, closes #362)

v1.5.3 (2015-11-20)

Bug Fixes

• Errors: fixes some instances when errors are missing a final newline (c4d2b171)

v1.5.2 (2015-11-14)

Bug Fixes

• Errors: fixes a compiling bug when built on Windows or without the color feature (a35f7634)

v1.5.1 (2015-11-13)

Bug Fixes

• Required Args: fixes a bug where required args are not correctly accounted for (f03b88a9, closes #343)