3.5.2

Changed

• Updated Kotlin to 1.8.10

Fixed

• Fix CliktCommand.prompt on NodeJS targets that would hang due to KT-55817 (#387)

3.5.1

Fixed

• Support unicode in environment variable values on Native Windows. (#362)
• Support environment variables for options in a mutually exclusive options group. (#384)

3.5.0

Added

• Added hidden parameter to CliktCommand, which will prevent the command from being displayed as a subcommand in help output (#353)
• Publish artifacts for the macosArm64 target. Note that this target is not tested on CI. (#352)

Changed

• Default values for arguments will now be included in help output when showDefaultValues=true is set on your help formatter (#357)

Fixed

• Fix flags and other options with defaults not being usable in mutuallyExclusiveOptions (#349)
• Fix CompletionCommand generating completion for itself (#355)

3.4.2

Deprecated

• TermUi.echo, TermUi.prompt, and TermUi.confirm. Use the equivalent methods on CliktCommand instead. (#344)

3.4.1

Added

• Publish JS artifacts with new IR compiler, in addition to the legacy format

Changed

• Updated Kotlin to 1.6.20

3.4.0

Changed

• Updated Kotlin to 1.6.10
• unique() now works with any option with a list type, not just multiple() options (#332)

Fixed

• Fixed co-occurring option groups returning null when all options in the group are defined in environment variables (#330)

3.2.0

Added

• InputStream.isCliktParameterDefaultStdin and OutputStream.isCliktParameterDefaultStdout to check if the streams returned from inputStream/outputStream options are proxying stdin/stdout (#272)

Changed

• Make parameters of mutuallyExclusiveOptions covariant to allow validation without explicit type annotations. (#265)
• Updated kotlin to 1.5.0

Fixed

• Reading from an option or argument property on a command that hasn't been invoked will now always throw an IllegalStateException

3.1.0

Added

• Added required() and defaultLazy() for nullable flag options like switch().
• Added support for generating autocomplete scripts for Fish shells (thanks to @faogustavo for the initial PR)
• Added CompletionCommand and CliktCommand.completionOption() that will print an autocomplete script when invoked, as an alternative to using environment variables.

Changed

• Updated Kotlin to 1.4.21
• @argfiles now allow line breaks in quoted values, which are included in the value verbatim. You can now end lines with \ to concatenate them with the following line.

3.0.1

Deprecated

• Deprecated calling echo with err or lineSeparator but no message.

3.0.0

Clikt 3.0 is a major release with a number of improvements and a few breaking API changes.

Highlights of this release

• Support for Browser JS targets
• Support for localization of all help output
• New extensions like help() and check() to make it even easier to setup your commands.

See the full list of changes here, and a migration guide here.