Bump picocli from 4.5.1 to 4.6.0

[dependabot-preview]

Bumps picocli from 4.5.1 to 4.6.0.

Release notes

Sourced from picocli's releases.

Picocli 4.5.2

Picocli 4.5.2

The picocli community is pleased to announce picocli 4.5.2.

This release contains bug fixes and enhancements:

• Auto-enable ANSI colors on MSYS2 terminals.
• Abbreviated options are now matched correctly even when value attached with '=' separator.
• The built-in HelpCommand now respects subcommands case-sensitivity and abbreviations.
• Required parameters no longer consume negated options.
• Positional parameters in Argument Groups no longer result in ArithmeticException: / by zero exceptions.
• The user manual now has tabs showing examples in languages other than Java. This is a work in progress: many examples still only have a Java version. Contributions welcome!
• Many, many documentation enhancements, most of which contributed by the community.

Many thanks to the picocli community who contributed 28 pull requests in this release! Please see the Fixed Issues section below for the individual contributors. Great work!

This is the seventy-fourth public release. Picocli follows semantic versioning.

Table of Contents

• New and noteworthy
• Fixed issues
• Deprecations
• Potential breaking changes

New and Noteworthy

The user manual now has tabs showing examples in languages other than Java. This is a work in progress: many examples still only have a Java version. Contributions welcome!

Fixed issues

• #1186 Enhancement: Auto-enable ANSI colors on MSYS2 (Git for Windows, MSYS2-based Windows Terminal shells, etc.). Thanks to Sysmat for raising this.
• #1162 Bugfix: Abbreviated options are not matched if value attached with '=' separator (like -x=3). Thanks to Chris Laprun for raising this.
• #1156#1172 Bugfix: the built-in HelpCommand now respects subcommands case-sensitivity and abbreviations. Thanks to NewbieOrange for the pull request.
• #1197 Bugfix: required parameters should not consume negated options. Thanks to Kevin Turner for raising this.
• #1213 Bugfix: @Parameters in @ArgGroup should not result in ArithmeticException: / by zero. Thanks to Loren Keagle for raising this.
• #1158 DOC: Fix broken links to GraalVM repo. Thanks to Andreas Deininger for the pull request.
• #1155 DOC: Fix sample code in chapter "Validation". Thanks to Andreas Deininger for the pull request.
• #1157 DOC: Fix typo "a argument group" in user manual. Thanks to sabrina for raising this.
• #1160 DOC: Added section Was a Value Defaulted? to the user manual.
• #1161 DOC: Fix typo "4,2" (should be 4.2) in user manual. Thanks to sabrina for raising this.
• #1165 DOC: Fix jline3 example: add AnsiConsole::systemUninstall in finally clause. Thanks to David Walluck for raising this.
• #1168#1169 DOC: Ensure org.jline.terminal.Terminal is closed when done. Thanks to David Walluck for the pull request.
• #1167 DOC: Fix broken links in Quick Guide. Thanks to Andreas Deininger for the pull request.
• #1171 DOC: Various documentation improvements. Thanks to Andreas Deininger for the pull request.
• #1173 DOC: Improve example applications for the user manual and Quick Guide. Thanks to Andreas Deininger for the pull request.
• #1175 DOC: section on compatible versions to picocli-shell-jline3/README.md. Thanks to Nick Cross for raising this.

Changelog

Sourced from picocli's changelog.

Picocli 4.6.0

The picocli community is pleased to announce picocli 4.6.0.

This release contains new features, bug fixes and other enhancements.

Community Contributions

This release contains many, many community contributions, for which I am extremely grateful. Let's give them some credit!

• Andreas Deininger has been contributing to the documentation and other areas for a long time, but recently went into overdrive :-) and contributed many, many new pull requests to improve the documentation. The user manual and Quick Guide now have a "foldable" table of contents, and examples in tabs, with many additional examples in Kotlin, Scala and Groovy. A lot of work went into this! Many thanks, Andreas!
• Marko Mackic contributed a pull request to add IModelTransformer API for user-defined model transformations after initialization and before parsing.
• Sualeh Fatehi contributed a pull request to the picocli-shell-jline3 module that adds a built-in clear command and improves the help command.
• H.Sakata contributed a pull request that adds support for echo and prompt for interactive options and positional parameters.
• Daniel Gray contributed a bug fix to prevent incorrectly defaulting inherited positional params after a subcommand.
• nveeser-google contributed a fix for compiler warnings about Annotation::getClass and assignment in if condition.
• Petr Hála contributed a pull request to add a section on Mocking to user manual.
• Max Rydahl Andersen contributed a pull request to include jbang in the Build Tools section of the user manual.
• David Phillips contributed a section to the user manual on Really Executable JARs.
• Laurent Almeras contributed a pull request to fix the user manual: @ParentObject should be @ParentCommand.
• Mattias Andersson raised the idea of supporting subcommand methods in Groovy scripts.
• Adrian A. raised the idea of using closures in the picocli annotations in Groovy programs instead of specifying a class.
• Nick Cross raised the idea of inheriting @Command attributes with scope=INHERIT.
• Marko Mackic raised the idea of adding a CommandSpec::removeSubcommand method.
• Max Rydahl Andersen raised the idea of supporting Optional<T> type for options and positional parameters.
• Max Rydahl Andersen and David Walluck raised the idea of supporting key-only Map options (to support -Dkey as well as -Dkey=value).
• David Walluck raised the idea of a "preprocessor" parser plugin.
• Jannick Hemelhof raised the idea of supporting @Spec-annotated members in ArgGroup classes.
• Vitaly Shukela raised a bug report: the error message for unmatched positional argument reports an incorrect index when value equals a previously matched argument.
• drkilikil raised a bug report: MissingParameterException should not be thrown when subcommand has required options and help option is specified on parent command.
• Sebastian Thomschke raised a bug report: ReflectionConfigGenerator should not generate method section in subclass config for private superclass methods in reflect-config.json.
• Lukas Heumos added the picocli-based cli-java template to CookieTemple.
• Sualeh Fatehi raised the idea of adding add CommandLine::getFactory accessor method.
• David Walluck contributed a test improvement that allows the tests to run reliably in more environments.

What is in this release

Improved Groovy support: this release introduces a new @PicocliScript2 annotation that adds support for exit codes and @Command-annotated methods to define subcommands. Also, from this release, Groovy programs can use closures in the picocli annotations instead of specifying a class.

From this release, Map options accept key-only parameters, so end users can specify -Dkey as well as -Dkey=value. There is a new mapFallbackValue attribute that enables this, which can be used to control the value that is put into the map when only a key was specified on the command line.

Also, this release adds support for java.util.Optional<T>: single-value types can be wrapped in an Optional container object when running on Java 8 or higher. If the option or positional parameter was not specified on the command line, picocli assigns the value Optional.empty() instead of null.

This release also adds support for commands with scope = ScopeType.INHERIT. Commands with this scope have their attributes copied to all subcommands (and sub-subcommands).

New parser plugin: IParameterPreprocessor and new configuration plugin: IModelTransformer.

From this release, @Spec-annotated elements can be used in ArgGroup classes, which can be convenient for validation.

Commits

• 0b22c13 Release picocli version 4.6.0
• d68b723 DOC fix typos (thanks Sabrina)
• 94da706 DOC link to https://clig.dev from Best Practices section
• dac21ef #1290 DOC: JLine syntax 'Ctrl-D' update RELEASE-NOTES
• a383677 JLine: change keystroke syntax 'Ctl-D' to more common used syntax 'Ctrl-D'
• 9159a70 #1289 DOC: update RELEASE-NOTES.md for Spring boot dependency update to 2.4.1.
• 10dca13 Bump Spring boot dependency to latest version
• c89a883 #1217 DOC for IParameterPreprocessor parser plugin
• 3b56550 #1217 simplify example use case
• 1c62b8c #1217 change generic type of info parameter to Map<String, Object> (was Map...
• Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
• @dependabot use these labels will set the current labels as the default for future PRs for this repo and language
• @dependabot use these reviewers will set the current reviewers as the default for future PRs for this repo and language
• @dependabot use these assignees will set the current assignees as the default for future PRs for this repo and language
• @dependabot use this milestone will set the current milestone as the default for future PRs for this repo and language
• @dependabot badge me will comment on this PR with code to add a "Dependabot enabled" badge to your readme

Additionally, you can set the following in your Dependabot dashboard:

• Update frequency (including time of day and day of week)
• Pull request limits (per update run and/or open at any time)
• Automerge options (never/patch/minor, and dev/runtime dependencies)
• Out-of-range updates (receive only lockfile updates, if desired)
• Security updates (receive only security updates, if desired)

[dependabot-preview]

Superseded by #23.