« Changelog History


clikt v3.0.0 Release Notes

Release Date: 2020-09-02 // over 3 years ago

  • 2020-09-02

    ➕ Added

    • 💻 Clikt's JS target now supports both NodeJS and Browsers. (#198)
    • 0️⃣ Default values for switch options are now shown in the help. Help text can be customized using the defaultForHelp argument, similar to normal options. (#205)
    • ➕ Added FlagOption.convert (#208)
    • ➕ Added ability to use unicode NEL character (\u0085) to manually break lines in help output (#214)
    • ➕ Added help("") extension to options and arguments as an alternative to passing the help as an argument (#207)
    • ➕ Added valueSourceKey parameter to option
    • ➕ Added check() extensions to options and arguments as an alternative to validate()
    • ➕ Added prompt and confirm functions to CliktCommand that call the TermUi equivalents with the current console.
    • ➕ Added echo() overload with no parameters to CliktCommand that prints a newline by itself.
    • ➕ Added localization support. You can set an implementation of the Localization interface on your context with your translations. (#227)

    🛠 Fixed

    • Hidden options will no longer be suggested as possible typo corrections. (#202)
    • Options and Arguments with multiple(required=true) will now show as required in help output. (#212)
    • Multiple short lines in a help text paragraph no longer appear dedented (#215)

    🔄 Changed

    • ⚡️ Updated Kotlin to 1.4.0
    • Argument.help and Option.help properties have been renamed to argumentHelp and optionHelp, respectively. The help parameter names to option() and argument() are unchanged.
    • commandHelp and commandHelpEpilog properties on CliktCommand are now open, so you can choose to override them instead of passing help and epilog to the constructor.
    • 0️⃣ Replaced MapValueSource.defaultKey with ValueSource.getKey(), which is more customizable.
    • Option.metavar, Option.parameterHelp, OptionGroup.parameterHelp and Argument.parameterHelp properties are now functions.
    • 🔄 Changed constructor parameters of CliktHelpFormatter. Added localization and removed usageTitle, optionsTitle, argumentsTitle, commandsTitle, optionsMetavar, and commandMetavar. Those strings are now defined on equivalently named functions on Localization.

    ✂ Removed

    • ✂ Removed envvarSplit parameter from option() and convert(). Option values from environment variables are no longer split automatically. (#177)
    • ✂ Removed public constructors from the following classes: ProcessedArgument, OptionWithValues, FlagOption, CoOccurringOptionGroup, ChoiceGroup, MutuallyExclusiveOptions.
    • 👻 MissingParameter exception replaced with MissingOption and MissingArgument
    • ✂ Removed Context.helpOptionMessage. Override Localization.helpOptionMessage and set it on your context instead.

    🗄 Deprecated

    • @ExperimentalCompletionCandidates and @ExperimentalValueSourceApi annotations. These APIs no longer require an opt-in.