Bump picocli from 4.3.0 to 4.6.0

[dependabot-preview]

Bumps picocli from 4.3.0 to 4.6.0.

Release notes

Sourced from picocli's releases.

Picocli 4.6.0

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 the contributors 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.
• Sabrina (link witheld) pointed out various typos in the documentation.

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.

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)
• Out-of-range updates (receive only lockfile updates, if desired)
• Security updates (receive only security updates, if desired)

[dependabot-preview]

Superseded by #23.