« Changelog History


clap-rs v2.27.0 Release Notes

Release Date: 2017-10-25 // over 6 years ago

  • ** 🚀 This release raises the minimum required version of Rust to 1.18 **

    ** 🚀 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 subcommand name can coincide with one of the multiple values.

    👀 See the commit 0c223f54 for full details.

    🐛 Bug Fixes

    • Values from global args are now propagated UP and DOWN!
    • 🛠 fixes a bug where using AppSettings::AllowHyphenValues would allow invalid arguments even when there is no way for them to be valid (77ed4684, closes #1066)
    • 📜 when an argument requires a value and that value happens to match a subcommand name, its parsed as a value (0c223f54, closes #1031, breaks #, #)
    • fixes a bug that prevented number_of_values and default_values to be used together (5eb342a9, closes #1050, #1056)
    • 0️⃣ fixes a bug that didn't allow args with default values to have conflicts (58b5b4be, closes #1071)
    • fixes a panic when using global args and calling App::get_matches_from_safe_borrow multiple times (d86ec797, closes #1076)
    • 🛠 fixes issues and potential regressions with global args values not being propagated properly or at all (a43f9dd4, closes #1010, #1061, #978)
    • 0️⃣ fixes a bug where default values are not applied if the option supports zero values (9c248cbf, closes #1047)

    📚 Documentation

    • adds additional blurbs about using multiples with subcommands (03455b77)
    • ⚡️ updates the docs to reflect changes to global args and that global args values can now be propagated back up the stack (ead076f0)
    • add html_root_url attribute (e67a061b)
    • 🔀 sync README version numbers with crate version (5536361b)

    👌 Improvements

    • args that have require_delimiter(true) is now reflected in help and usage strings (dce61699, closes #1052)
    • if all subcommands are hidden, the subcommands section of the help message is no longer displayed (4ae7b046, closes #1046)

    💥 Breaking Changes

    • 📜 when an argument requires a value and that value happens to match a subcommand name, its parsed as a value (0c223f54, closes #1031, breaks #, #)

    🗄 Deprecations

    • AppSettings::PropagateGlobalValuesDown: this setting is no longer required to propagate values down or up (2bb5ddce)