From 368d97e4f60ab2d546199a92611a22abf337b091 Mon Sep 17 00:00:00 2001 From: Remko Popma Date: Wed, 8 May 2024 07:16:34 +0900 Subject: [PATCH] Release picocli version 4.7.6 --- README.md | 24 +- RELEASE-NOTES.md | 4 +- dependencies.gradle | 6 +- docs/A-Whirlwind-Tour-of-Picocli.html | 81 +++++- docs/announcing-picocli-1.0.html | 156 ++++++------ docs/apidocs-all/allclasses-frame.html | 2 +- docs/apidocs-all/allclasses-index.html | 4 +- docs/apidocs-all/allclasses-noframe.html | 2 +- docs/apidocs-all/allpackages-index.html | 4 +- docs/apidocs-all/constant-values.html | 6 +- docs/apidocs-all/deprecated-list.html | 4 +- docs/apidocs-all/help-doc.html | 4 +- docs/apidocs-all/index-files/index-1.html | 4 +- docs/apidocs-all/index-files/index-10.html | 4 +- docs/apidocs-all/index-files/index-11.html | 4 +- docs/apidocs-all/index-files/index-12.html | 4 +- docs/apidocs-all/index-files/index-13.html | 4 +- docs/apidocs-all/index-files/index-14.html | 4 +- docs/apidocs-all/index-files/index-15.html | 4 +- docs/apidocs-all/index-files/index-16.html | 4 +- docs/apidocs-all/index-files/index-17.html | 4 +- docs/apidocs-all/index-files/index-18.html | 4 +- docs/apidocs-all/index-files/index-19.html | 8 +- docs/apidocs-all/index-files/index-2.html | 4 +- docs/apidocs-all/index-files/index-20.html | 4 +- docs/apidocs-all/index-files/index-21.html | 4 +- docs/apidocs-all/index-files/index-22.html | 12 +- docs/apidocs-all/index-files/index-23.html | 4 +- docs/apidocs-all/index-files/index-3.html | 4 +- docs/apidocs-all/index-files/index-4.html | 4 +- docs/apidocs-all/index-files/index-5.html | 4 +- docs/apidocs-all/index-files/index-6.html | 4 +- docs/apidocs-all/index-files/index-7.html | 4 +- docs/apidocs-all/index-files/index-8.html | 4 +- docs/apidocs-all/index-files/index-9.html | 8 +- docs/apidocs-all/index.html | 2 +- .../info.picocli.codegen/module-frame.html | 2 +- .../info.picocli.codegen/module-summary.html | 4 +- .../module-type-frame.html | 2 +- .../AbstractCommandSpecProcessor.html | 4 +- .../processing/AnnotatedElementHolder.html | 4 +- .../annotation/processing/ITypeMetaData.html | 4 +- .../AbstractCommandSpecProcessor.html | 4 +- .../class-use/AnnotatedElementHolder.html | 4 +- .../processing/class-use/ITypeMetaData.html | 4 +- .../annotation/processing/package-frame.html | 2 +- .../processing/package-summary.html | 4 +- .../annotation/processing/package-tree.html | 4 +- .../annotation/processing/package-use.html | 4 +- .../graalvm/DynamicProxyConfigGenerator.html | 4 +- .../aot/graalvm/JniConfigGenerator.html | 4 +- .../graalvm/ReflectionConfigGenerator.html | 4 +- .../aot/graalvm/ResourceConfigGenerator.html | 4 +- .../DynamicProxyConfigGenerator.html | 4 +- .../graalvm/class-use/JniConfigGenerator.html | 4 +- .../class-use/ReflectionConfigGenerator.html | 4 +- .../class-use/ResourceConfigGenerator.html | 4 +- .../codegen/aot/graalvm/package-frame.html | 2 +- .../codegen/aot/graalvm/package-summary.html | 4 +- .../codegen/aot/graalvm/package-tree.html | 4 +- .../codegen/aot/graalvm/package-use.html | 4 +- .../NativeImageConfigGeneratorProcessor.html | 4 +- .../NativeImageConfigGeneratorProcessor.html | 4 +- .../aot/graalvm/processor/package-frame.html | 2 +- .../graalvm/processor/package-summary.html | 4 +- .../aot/graalvm/processor/package-tree.html | 4 +- .../aot/graalvm/processor/package-use.html | 4 +- .../docgen/manpage/ManPageGenerator.html | 4 +- .../manpage/class-use/ManPageGenerator.html | 4 +- .../codegen/docgen/manpage/package-frame.html | 2 +- .../docgen/manpage/package-summary.html | 4 +- .../codegen/docgen/manpage/package-tree.html | 4 +- .../codegen/docgen/manpage/package-use.html | 4 +- .../picocli/codegen/util/Assert.html | 4 +- .../picocli/codegen/util/JulLogFormatter.html | 4 +- .../picocli/codegen/util/Util.html | 4 +- .../codegen/util/class-use/Assert.html | 4 +- .../util/class-use/JulLogFormatter.html | 4 +- .../picocli/codegen/util/class-use/Util.html | 4 +- .../picocli/codegen/util/package-frame.html | 2 +- .../picocli/codegen/util/package-summary.html | 4 +- .../picocli/codegen/util/package-tree.html | 4 +- .../picocli/codegen/util/package-use.html | 4 +- .../info.picocli.groovy/module-frame.html | 2 +- .../info.picocli.groovy/module-summary.html | 4 +- .../module-type-frame.html | 2 +- .../picocli/groovy/PicocliBaseScript.html | 4 +- .../picocli/groovy/PicocliBaseScript2.html | 4 +- .../picocli/groovy/PicocliScript.html | 4 +- .../picocli/groovy/PicocliScript2.html | 4 +- .../PicocliScriptASTTransformation.html | 4 +- .../groovy/class-use/PicocliBaseScript.html | 4 +- .../groovy/class-use/PicocliBaseScript2.html | 4 +- .../groovy/class-use/PicocliScript.html | 4 +- .../groovy/class-use/PicocliScript2.html | 4 +- .../PicocliScriptASTTransformation.html | 4 +- .../picocli/groovy/package-frame.html | 2 +- .../picocli/groovy/package-summary.html | 4 +- .../picocli/groovy/package-tree.html | 4 +- .../picocli/groovy/package-use.html | 4 +- .../module-frame.html | 2 +- .../module-summary.html | 4 +- .../module-type-frame.html | 2 +- .../shell/jline2/PicocliJLineCompleter.html | 4 +- .../class-use/PicocliJLineCompleter.html | 4 +- .../picocli/shell/jline2/package-frame.html | 2 +- .../picocli/shell/jline2/package-summary.html | 4 +- .../picocli/shell/jline2/package-tree.html | 4 +- .../picocli/shell/jline2/package-use.html | 4 +- .../module-frame.html | 2 +- .../module-summary.html | 4 +- .../module-type-frame.html | 2 +- .../jline3/PicocliCommands.ClearScreen.html | 4 +- ...icocliCommands.PicocliCommandsFactory.html | 4 +- .../picocli/shell/jline3/PicocliCommands.html | 12 +- .../shell/jline3/PicocliJLineCompleter.html | 4 +- .../PicocliCommands.ClearScreen.html | 4 +- ...icocliCommands.PicocliCommandsFactory.html | 4 +- .../jline3/class-use/PicocliCommands.html | 4 +- .../class-use/PicocliJLineCompleter.html | 4 +- .../picocli/shell/jline3/package-frame.html | 2 +- .../picocli/shell/jline3/package-summary.html | 4 +- .../picocli/shell/jline3/package-tree.html | 4 +- .../picocli/shell/jline3/package-use.html | 4 +- .../module-frame.html | 2 +- .../module-summary.html | 4 +- .../module-type-frame.html | 2 +- .../picocli/spring/PicocliSpringFactory.html | 4 +- .../PicocliAutoConfiguration.html | 4 +- .../class-use/PicocliAutoConfiguration.html | 4 +- .../boot/autoconfigure/package-frame.html | 2 +- .../boot/autoconfigure/package-summary.html | 4 +- .../boot/autoconfigure/package-tree.html | 4 +- .../boot/autoconfigure/package-use.html | 4 +- .../class-use/PicocliSpringFactory.html | 4 +- .../picocli/spring/package-frame.html | 2 +- .../picocli/spring/package-summary.html | 4 +- .../picocli/spring/package-tree.html | 4 +- .../picocli/spring/package-use.html | 4 +- .../info.picocli/module-frame.html | 2 +- .../info.picocli/module-summary.html | 4 +- .../info.picocli/module-type-frame.html | 2 +- .../AutoComplete.GenerateCompletion.html | 4 +- .../info.picocli/picocli/AutoComplete.html | 4 +- .../picocli/CommandLine.AbstractHandler.html | 4 +- ...ommandLine.AbstractParseResultHandler.html | 4 +- .../picocli/CommandLine.ArgGroup.html | 6 +- .../picocli/CommandLine.Command.html | 6 +- .../CommandLine.DefaultExceptionHandler.html | 4 +- .../CommandLine.DuplicateNameException.html | 4 +- ...e.DuplicateOptionAnnotationsException.html | 4 +- .../CommandLine.ExecutionException.html | 4 +- .../picocli/CommandLine.ExitCode.html | 4 +- .../picocli/CommandLine.Help.Ansi.IStyle.html | 4 +- .../picocli/CommandLine.Help.Ansi.Style.html | 4 +- .../picocli/CommandLine.Help.Ansi.Text.html | 4 +- .../picocli/CommandLine.Help.Ansi.html | 4 +- .../CommandLine.Help.ColorScheme.Builder.html | 4 +- .../picocli/CommandLine.Help.ColorScheme.html | 4 +- .../CommandLine.Help.Column.Overflow.html | 4 +- .../picocli/CommandLine.Help.Column.html | 4 +- .../CommandLine.Help.IOptionRenderer.html | 4 +- .../CommandLine.Help.IParamLabelRenderer.html | 4 +- .../CommandLine.Help.IParameterRenderer.html | 4 +- .../picocli/CommandLine.Help.Layout.html | 4 +- .../CommandLine.Help.TextTable.Cell.html | 4 +- .../picocli/CommandLine.Help.TextTable.html | 4 +- .../picocli/CommandLine.Help.Visibility.html | 4 +- .../picocli/CommandLine.Help.html | 4 +- .../picocli/CommandLine.HelpCommand.html | 4 +- .../CommandLine.IDefaultValueProvider.html | 4 +- .../CommandLine.IExceptionHandler.html | 4 +- .../CommandLine.IExceptionHandler2.html | 4 +- ...ommandLine.IExecutionExceptionHandler.html | 14 +- .../CommandLine.IExecutionStrategy.html | 4 +- .../CommandLine.IExitCodeExceptionMapper.html | 4 +- .../CommandLine.IExitCodeGenerator.html | 4 +- .../picocli/CommandLine.IFactory.html | 4 +- ...CommandLine.IHelpCommandInitializable.html | 4 +- ...ommandLine.IHelpCommandInitializable2.html | 4 +- .../picocli/CommandLine.IHelpFactory.html | 4 +- .../CommandLine.IHelpSectionRenderer.html | 4 +- .../CommandLine.IModelTransformer.html | 4 +- ...mmandLine.INegatableOptionTransformer.html | 4 +- .../CommandLine.IParameterConsumer.html | 4 +- ...ommandLine.IParameterExceptionHandler.html | 4 +- .../CommandLine.IParameterPreprocessor.html | 4 +- .../CommandLine.IParseResultHandler.html | 4 +- .../CommandLine.IParseResultHandler2.html | 4 +- .../picocli/CommandLine.ITypeConverter.html | 4 +- .../picocli/CommandLine.IVersionProvider.html | 4 +- .../CommandLine.InitializationException.html | 4 +- ...ommandLine.MaxValuesExceededException.html | 4 +- ...CommandLine.MissingParameterException.html | 4 +- ...andLine.MissingTypeConverterException.html | 4 +- .../picocli/CommandLine.Mixin.html | 4 +- ...ommandLine.Model.ArgGroupSpec.Builder.html | 12 +- .../CommandLine.Model.ArgGroupSpec.html | 8 +- .../picocli/CommandLine.Model.ArgSpec.html | 10 +- .../CommandLine.Model.CommandSpec.html | 8 +- .../CommandLine.Model.IAnnotatedElement.html | 4 +- .../CommandLine.Model.IExtensible.html | 4 +- .../picocli/CommandLine.Model.IGetter.html | 4 +- .../picocli/CommandLine.Model.IOrdered.html | 4 +- .../picocli/CommandLine.Model.IScope.html | 4 +- .../picocli/CommandLine.Model.IScoped.html | 4 +- .../picocli/CommandLine.Model.ISetter.html | 4 +- .../picocli/CommandLine.Model.ITypeInfo.html | 4 +- .../picocli/CommandLine.Model.Messages.html | 6 +- .../CommandLine.Model.MethodParam.html | 4 +- .../CommandLine.Model.OptionSpec.Builder.html | 4 +- .../picocli/CommandLine.Model.OptionSpec.html | 4 +- .../picocli/CommandLine.Model.ParserSpec.html | 12 +- ...ine.Model.PositionalParamSpec.Builder.html | 4 +- ...CommandLine.Model.PositionalParamSpec.html | 4 +- ...ommandLine.Model.UnmatchedArgsBinding.html | 4 +- .../CommandLine.Model.UsageMessageSpec.html | 8 +- .../picocli/CommandLine.Model.html | 4 +- ...ndLine.MutuallyExclusiveArgsException.html | 4 +- .../picocli/CommandLine.Option.html | 4 +- ...ommandLine.OverwrittenOptionException.html | 4 +- .../CommandLine.ParameterException.html | 4 +- ...ommandLine.ParameterIndexGapException.html | 4 +- .../picocli/CommandLine.Parameters.html | 4 +- .../picocli/CommandLine.ParentCommand.html | 4 +- .../CommandLine.ParseResult.Builder.html | 4 +- .../CommandLine.ParseResult.GroupMatch.html | 4 +- ...dLine.ParseResult.GroupMatchContainer.html | 4 +- .../picocli/CommandLine.ParseResult.html | 4 +- .../picocli/CommandLine.PicocliException.html | 4 +- ...CommandLine.PropertiesDefaultProvider.html | 4 +- .../picocli/CommandLine.Range.html | 4 +- .../CommandLine.RegexTransformer.Builder.html | 4 +- .../picocli/CommandLine.RegexTransformer.html | 4 +- .../picocli/CommandLine.RunAll.html | 4 +- .../picocli/CommandLine.RunFirst.html | 4 +- .../picocli/CommandLine.RunLast.html | 4 +- .../picocli/CommandLine.ScopeType.html | 8 +- .../picocli/CommandLine.Spec.Target.html | 4 +- .../picocli/CommandLine.Spec.html | 4 +- .../picocli/CommandLine.TraceLevel.html | 6 +- .../picocli/CommandLine.Tracer.html | 6 +- .../CommandLine.TypeConversionException.html | 4 +- .../picocli/CommandLine.Unmatched.html | 4 +- ...ommandLine.UnmatchedArgumentException.html | 4 +- .../CommandLine.UseDefaultConverter.html | 6 +- .../info.picocli/picocli/CommandLine.html | 18 +- .../AutoComplete.GenerateCompletion.html | 4 +- .../picocli/class-use/AutoComplete.html | 4 +- .../CommandLine.AbstractHandler.html | 4 +- ...ommandLine.AbstractParseResultHandler.html | 4 +- .../class-use/CommandLine.ArgGroup.html | 4 +- .../class-use/CommandLine.Command.html | 4 +- .../CommandLine.DefaultExceptionHandler.html | 4 +- .../CommandLine.DuplicateNameException.html | 4 +- ...e.DuplicateOptionAnnotationsException.html | 4 +- .../CommandLine.ExecutionException.html | 4 +- .../class-use/CommandLine.ExitCode.html | 4 +- .../CommandLine.Help.Ansi.IStyle.html | 4 +- .../CommandLine.Help.Ansi.Style.html | 4 +- .../class-use/CommandLine.Help.Ansi.Text.html | 4 +- .../class-use/CommandLine.Help.Ansi.html | 4 +- .../CommandLine.Help.ColorScheme.Builder.html | 4 +- .../CommandLine.Help.ColorScheme.html | 4 +- .../CommandLine.Help.Column.Overflow.html | 4 +- .../class-use/CommandLine.Help.Column.html | 4 +- .../CommandLine.Help.IOptionRenderer.html | 4 +- .../CommandLine.Help.IParamLabelRenderer.html | 4 +- .../CommandLine.Help.IParameterRenderer.html | 4 +- .../class-use/CommandLine.Help.Layout.html | 4 +- .../CommandLine.Help.TextTable.Cell.html | 4 +- .../class-use/CommandLine.Help.TextTable.html | 4 +- .../CommandLine.Help.Visibility.html | 4 +- .../picocli/class-use/CommandLine.Help.html | 4 +- .../class-use/CommandLine.HelpCommand.html | 4 +- .../CommandLine.IDefaultValueProvider.html | 4 +- .../CommandLine.IExceptionHandler.html | 4 +- .../CommandLine.IExceptionHandler2.html | 4 +- ...ommandLine.IExecutionExceptionHandler.html | 4 +- .../CommandLine.IExecutionStrategy.html | 4 +- .../CommandLine.IExitCodeExceptionMapper.html | 4 +- .../CommandLine.IExitCodeGenerator.html | 4 +- .../class-use/CommandLine.IFactory.html | 4 +- ...CommandLine.IHelpCommandInitializable.html | 4 +- ...ommandLine.IHelpCommandInitializable2.html | 4 +- .../class-use/CommandLine.IHelpFactory.html | 4 +- .../CommandLine.IHelpSectionRenderer.html | 4 +- .../CommandLine.IModelTransformer.html | 4 +- ...mmandLine.INegatableOptionTransformer.html | 4 +- .../CommandLine.IParameterConsumer.html | 4 +- ...ommandLine.IParameterExceptionHandler.html | 4 +- .../CommandLine.IParameterPreprocessor.html | 4 +- .../CommandLine.IParseResultHandler.html | 4 +- .../CommandLine.IParseResultHandler2.html | 4 +- .../class-use/CommandLine.ITypeConverter.html | 4 +- .../CommandLine.IVersionProvider.html | 4 +- .../CommandLine.InitializationException.html | 4 +- ...ommandLine.MaxValuesExceededException.html | 4 +- ...CommandLine.MissingParameterException.html | 4 +- ...andLine.MissingTypeConverterException.html | 4 +- .../picocli/class-use/CommandLine.Mixin.html | 4 +- ...ommandLine.Model.ArgGroupSpec.Builder.html | 6 +- .../CommandLine.Model.ArgGroupSpec.html | 4 +- .../class-use/CommandLine.Model.ArgSpec.html | 4 +- .../CommandLine.Model.CommandSpec.html | 4 +- .../CommandLine.Model.IAnnotatedElement.html | 4 +- .../CommandLine.Model.IExtensible.html | 4 +- .../class-use/CommandLine.Model.IGetter.html | 4 +- .../class-use/CommandLine.Model.IOrdered.html | 4 +- .../class-use/CommandLine.Model.IScope.html | 4 +- .../class-use/CommandLine.Model.IScoped.html | 4 +- .../class-use/CommandLine.Model.ISetter.html | 4 +- .../CommandLine.Model.ITypeInfo.html | 4 +- .../class-use/CommandLine.Model.Messages.html | 4 +- .../CommandLine.Model.MethodParam.html | 4 +- .../CommandLine.Model.OptionSpec.Builder.html | 4 +- .../CommandLine.Model.OptionSpec.html | 4 +- .../CommandLine.Model.ParserSpec.html | 4 +- ...ine.Model.PositionalParamSpec.Builder.html | 4 +- ...CommandLine.Model.PositionalParamSpec.html | 4 +- ...ommandLine.Model.UnmatchedArgsBinding.html | 4 +- .../CommandLine.Model.UsageMessageSpec.html | 4 +- .../picocli/class-use/CommandLine.Model.html | 4 +- ...ndLine.MutuallyExclusiveArgsException.html | 4 +- .../picocli/class-use/CommandLine.Option.html | 4 +- ...ommandLine.OverwrittenOptionException.html | 4 +- .../CommandLine.ParameterException.html | 4 +- ...ommandLine.ParameterIndexGapException.html | 4 +- .../class-use/CommandLine.Parameters.html | 4 +- .../class-use/CommandLine.ParentCommand.html | 4 +- .../CommandLine.ParseResult.Builder.html | 4 +- .../CommandLine.ParseResult.GroupMatch.html | 4 +- ...dLine.ParseResult.GroupMatchContainer.html | 4 +- .../class-use/CommandLine.ParseResult.html | 6 +- .../CommandLine.PicocliException.html | 4 +- ...CommandLine.PropertiesDefaultProvider.html | 4 +- .../picocli/class-use/CommandLine.Range.html | 4 +- .../CommandLine.RegexTransformer.Builder.html | 4 +- .../CommandLine.RegexTransformer.html | 4 +- .../picocli/class-use/CommandLine.RunAll.html | 4 +- .../class-use/CommandLine.RunFirst.html | 4 +- .../class-use/CommandLine.RunLast.html | 4 +- .../class-use/CommandLine.ScopeType.html | 8 +- .../class-use/CommandLine.Spec.Target.html | 4 +- .../picocli/class-use/CommandLine.Spec.html | 4 +- .../class-use/CommandLine.TraceLevel.html | 4 +- .../picocli/class-use/CommandLine.Tracer.html | 4 +- .../CommandLine.TypeConversionException.html | 4 +- .../class-use/CommandLine.Unmatched.html | 4 +- ...ommandLine.UnmatchedArgumentException.html | 4 +- .../CommandLine.UseDefaultConverter.html | 4 +- .../picocli/class-use/CommandLine.html | 6 +- .../info.picocli/picocli/package-frame.html | 2 +- .../info.picocli/picocli/package-summary.html | 4 +- .../info.picocli/picocli/package-tree.html | 4 +- .../info.picocli/picocli/package-use.html | 4 +- docs/apidocs-all/member-search-index.js | 2 +- docs/apidocs-all/member-search-index.zip | Bin 13917 -> 13912 bytes docs/apidocs-all/module-overview-frame.html | 2 +- docs/apidocs-all/module-search-index.zip | Bin 236 -> 236 bytes docs/apidocs-all/overview-frame.html | 2 +- docs/apidocs-all/overview-summary.html | 6 +- docs/apidocs-all/overview-tree.html | 4 +- docs/apidocs-all/package-search-index.zip | Bin 359 -> 359 bytes docs/apidocs-all/serialized-form.html | 4 +- docs/apidocs-all/type-search-index.zip | Bin 1316 -> 1316 bytes docs/apidocs/allclasses-frame.html | 2 +- docs/apidocs/allclasses-noframe.html | 2 +- docs/apidocs/constant-values.html | 6 +- docs/apidocs/deprecated-list.html | 4 +- docs/apidocs/help-doc.html | 4 +- docs/apidocs/index-all.html | 16 +- docs/apidocs/index.html | 2 +- docs/apidocs/overview-summary.html | 6 +- docs/apidocs/overview-tree.html | 4 +- .../AutoComplete.GenerateCompletion.html | 4 +- docs/apidocs/picocli/AutoComplete.html | 4 +- .../picocli/CommandLine.AbstractHandler.html | 4 +- ...ommandLine.AbstractParseResultHandler.html | 4 +- .../apidocs/picocli/CommandLine.ArgGroup.html | 6 +- docs/apidocs/picocli/CommandLine.Command.html | 6 +- .../CommandLine.DefaultExceptionHandler.html | 4 +- .../CommandLine.DuplicateNameException.html | 4 +- ...e.DuplicateOptionAnnotationsException.html | 4 +- .../CommandLine.ExecutionException.html | 4 +- .../apidocs/picocli/CommandLine.ExitCode.html | 4 +- .../picocli/CommandLine.Help.Ansi.IStyle.html | 4 +- .../picocli/CommandLine.Help.Ansi.Style.html | 4 +- .../picocli/CommandLine.Help.Ansi.Text.html | 4 +- .../picocli/CommandLine.Help.Ansi.html | 4 +- .../CommandLine.Help.ColorScheme.Builder.html | 4 +- .../picocli/CommandLine.Help.ColorScheme.html | 4 +- .../CommandLine.Help.Column.Overflow.html | 4 +- .../picocli/CommandLine.Help.Column.html | 4 +- .../CommandLine.Help.IOptionRenderer.html | 4 +- .../CommandLine.Help.IParamLabelRenderer.html | 4 +- .../CommandLine.Help.IParameterRenderer.html | 4 +- .../picocli/CommandLine.Help.Layout.html | 4 +- .../CommandLine.Help.TextTable.Cell.html | 4 +- .../picocli/CommandLine.Help.TextTable.html | 4 +- .../picocli/CommandLine.Help.Visibility.html | 4 +- docs/apidocs/picocli/CommandLine.Help.html | 4 +- .../picocli/CommandLine.HelpCommand.html | 4 +- .../CommandLine.IDefaultValueProvider.html | 4 +- .../CommandLine.IExceptionHandler.html | 4 +- .../CommandLine.IExceptionHandler2.html | 4 +- ...ommandLine.IExecutionExceptionHandler.html | 14 +- .../CommandLine.IExecutionStrategy.html | 4 +- .../CommandLine.IExitCodeExceptionMapper.html | 4 +- .../CommandLine.IExitCodeGenerator.html | 4 +- .../apidocs/picocli/CommandLine.IFactory.html | 4 +- ...CommandLine.IHelpCommandInitializable.html | 4 +- ...ommandLine.IHelpCommandInitializable2.html | 4 +- .../picocli/CommandLine.IHelpFactory.html | 4 +- .../CommandLine.IHelpSectionRenderer.html | 4 +- .../CommandLine.IModelTransformer.html | 4 +- ...mmandLine.INegatableOptionTransformer.html | 4 +- .../CommandLine.IParameterConsumer.html | 4 +- ...ommandLine.IParameterExceptionHandler.html | 4 +- .../CommandLine.IParameterPreprocessor.html | 4 +- .../CommandLine.IParseResultHandler.html | 4 +- .../CommandLine.IParseResultHandler2.html | 4 +- .../picocli/CommandLine.ITypeConverter.html | 4 +- .../picocli/CommandLine.IVersionProvider.html | 4 +- .../CommandLine.InitializationException.html | 4 +- ...ommandLine.MaxValuesExceededException.html | 4 +- ...CommandLine.MissingParameterException.html | 4 +- ...andLine.MissingTypeConverterException.html | 4 +- docs/apidocs/picocli/CommandLine.Mixin.html | 4 +- ...ommandLine.Model.ArgGroupSpec.Builder.html | 12 +- .../CommandLine.Model.ArgGroupSpec.html | 8 +- .../picocli/CommandLine.Model.ArgSpec.html | 10 +- .../CommandLine.Model.CommandSpec.html | 8 +- .../CommandLine.Model.IAnnotatedElement.html | 4 +- .../CommandLine.Model.IExtensible.html | 4 +- .../picocli/CommandLine.Model.IGetter.html | 4 +- .../picocli/CommandLine.Model.IOrdered.html | 4 +- .../picocli/CommandLine.Model.IScope.html | 4 +- .../picocli/CommandLine.Model.IScoped.html | 4 +- .../picocli/CommandLine.Model.ISetter.html | 4 +- .../picocli/CommandLine.Model.ITypeInfo.html | 4 +- .../picocli/CommandLine.Model.Messages.html | 6 +- .../CommandLine.Model.MethodParam.html | 4 +- .../CommandLine.Model.OptionSpec.Builder.html | 4 +- .../picocli/CommandLine.Model.OptionSpec.html | 4 +- .../picocli/CommandLine.Model.ParserSpec.html | 12 +- ...ine.Model.PositionalParamSpec.Builder.html | 4 +- ...CommandLine.Model.PositionalParamSpec.html | 4 +- ...ommandLine.Model.UnmatchedArgsBinding.html | 4 +- .../CommandLine.Model.UsageMessageSpec.html | 8 +- docs/apidocs/picocli/CommandLine.Model.html | 4 +- ...ndLine.MutuallyExclusiveArgsException.html | 4 +- docs/apidocs/picocli/CommandLine.Option.html | 4 +- ...ommandLine.OverwrittenOptionException.html | 4 +- .../CommandLine.ParameterException.html | 4 +- ...ommandLine.ParameterIndexGapException.html | 4 +- .../picocli/CommandLine.Parameters.html | 4 +- .../picocli/CommandLine.ParentCommand.html | 4 +- .../CommandLine.ParseResult.Builder.html | 4 +- .../CommandLine.ParseResult.GroupMatch.html | 4 +- ...dLine.ParseResult.GroupMatchContainer.html | 4 +- .../picocli/CommandLine.ParseResult.html | 4 +- .../picocli/CommandLine.PicocliException.html | 4 +- ...CommandLine.PropertiesDefaultProvider.html | 4 +- docs/apidocs/picocli/CommandLine.Range.html | 4 +- .../CommandLine.RegexTransformer.Builder.html | 4 +- .../picocli/CommandLine.RegexTransformer.html | 4 +- docs/apidocs/picocli/CommandLine.RunAll.html | 4 +- .../apidocs/picocli/CommandLine.RunFirst.html | 4 +- docs/apidocs/picocli/CommandLine.RunLast.html | 4 +- .../picocli/CommandLine.ScopeType.html | 8 +- .../picocli/CommandLine.Spec.Target.html | 4 +- docs/apidocs/picocli/CommandLine.Spec.html | 4 +- .../picocli/CommandLine.TraceLevel.html | 6 +- docs/apidocs/picocli/CommandLine.Tracer.html | 6 +- .../CommandLine.TypeConversionException.html | 4 +- .../picocli/CommandLine.Unmatched.html | 4 +- ...ommandLine.UnmatchedArgumentException.html | 4 +- .../CommandLine.UseDefaultConverter.html | 6 +- docs/apidocs/picocli/CommandLine.html | 18 +- docs/apidocs/picocli/package-frame.html | 2 +- docs/apidocs/picocli/package-summary.html | 4 +- docs/apidocs/picocli/package-tree.html | 18 +- docs/apidocs/serialized-form.html | 4 +- docs/autocomplete.adoc | 4 +- docs/autocomplete.html | 160 ++++++------ ...apps-in-java-with-graalvm-and-picocli.html | 156 ++++++------ docs/feedback.html | 154 ++++++------ docs/groovy-2.5-clibuilder-renewal-part1.html | 156 ++++++------ docs/groovy-2.5-clibuilder-renewal-part2.html | 156 ++++++------ docs/groovy-2.5-clibuilder-renewal.html | 156 ++++++------ docs/index.adoc | 64 ++--- docs/index.html | 230 +++++++++--------- docs/man/gen-manpage.html | 166 ++++++------- docs/man/gen-proxy-config.html | 166 ++++++------- docs/man/gen-reflect-config.html | 166 ++++++------- docs/man/gen-resource-config.html | 166 ++++++------- docs/man/generate-completion.html | 164 ++++++------- docs/man/index.html | 156 ++++++------ docs/man/picocli.AutoComplete.html | 166 ++++++------- docs/migrating-from-commons-cli.html | 156 ++++++------ docs/picocli-2.0-do-more-with-less.html | 156 ++++++------ ...icocli-2.0-groovy-scripts-on-steroids.html | 156 ++++++------ docs/picocli-on-graalvm.html | 156 ++++++------ docs/picocli-programmatic-api.adoc | 4 +- docs/picocli-programmatic-api.html | 160 ++++++------ docs/quick-guide.adoc | 10 +- docs/quick-guide.html | 166 ++++++------- docs/zh/picocli-2.0-do-more-with-less.html | 156 ++++++------ ...icocli-2.0-groovy-scripts-on-steroids.html | 156 ++++++------ picocli-codegen/README.adoc | 46 ++-- .../graalvm/DynamicProxyConfigGenerator.java | 2 +- .../aot/graalvm/JniConfigGenerator.java | 2 +- .../graalvm/ReflectionConfigGenerator.java | 2 +- .../aot/graalvm/ResourceConfigGenerator.java | 2 +- .../docgen/manpage/ManPageGenerator.java | 2 +- .../build.gradle | 4 +- .../example-gradle-project/build.gradle | 6 +- .../example-maven-project-shading/pom.xml | 4 +- .../example-maven-project-simple/pom.xml | 4 +- .../example-gradle-project/build.gradle | 4 +- .../example-maven-project/pom.xml | 6 +- picocli-groovy/README.md | 2 +- picocli-shell-jline2/README.md | 2 +- picocli-shell-jline3/README.md | 2 +- picocli-spring-boot-starter/README.md | 6 +- src/main/java/picocli/AutoComplete.java | 2 +- src/main/java/picocli/CommandLine.java | 36 +-- src/test/java/picocli/CommandLineTest.java | 2 +- 529 files changed, 3104 insertions(+), 3015 deletions(-) diff --git a/README.md b/README.md index 2f35d1594..e9f0b2576 100644 --- a/README.md +++ b/README.md @@ -79,7 +79,7 @@ The user manual has examples of integrating with [Guice](https://picocli.info/#_ ### Releases * [All Releases](https://github.com/remkop/picocli/releases) -* Latest: 4.7.5 [Release Notes](https://github.com/remkop/picocli/releases/tag/v4.7.5) +* Latest: 4.7.6 [Release Notes](https://github.com/remkop/picocli/releases/tag/v4.7.6) * Older: Picocli 4.0 [Release Notes](https://github.com/remkop/picocli/releases/tag/v4.0.0) * Older: Picocli 3.0 [Release Notes](https://github.com/remkop/picocli/releases/tag/v3.0.0) * Older: Picocli 2.0 [Release Notes](https://github.com/remkop/picocli/releases/tag/v2.0.0) @@ -88,7 +88,7 @@ The user manual has examples of integrating with [Guice](https://picocli.info/#_ * [4.x User manual: https://picocli.info](https://picocli.info) * [4.x Quick Guide](https://picocli.info/quick-guide.html) * [4.x API Javadoc](https://picocli.info/apidocs/) -* [PREVIEW: Modular Javadoc for all artifacts (4.7.5-SNAPSHOT)](https://picocli.info/apidocs-all/) +* [PREVIEW: Modular Javadoc for all artifacts (4.7.6-SNAPSHOT)](https://picocli.info/apidocs-all/) * [Command line autocompletion](https://picocli.info/autocomplete.html) * [Programmatic API](https://picocli.info/picocli-programmatic-api.html) * [FAQ](https://github.com/remkop/picocli/wiki/FAQ) @@ -272,9 +272,9 @@ If you like picocli, help others discover picocli: #### Spread the joy! :tada: * Tweet about picocli! What do you like about it? How has it helped you? How is it different from the alternatives? * Mention that your project uses picocli in the documentation of your project. -* Show that your GitHub project uses picocli, with this badge in your README.md: [![picocli](https://img.shields.io/badge/picocli-4.7.5-green.svg)](https://github.com/remkop/picocli) +* Show that your GitHub project uses picocli, with this badge in your README.md: [![picocli](https://img.shields.io/badge/picocli-4.7.6-green.svg)](https://github.com/remkop/picocli) ``` -[![picocli](https://img.shields.io/badge/picocli-4.7.5-green.svg)](https://github.com/remkop/picocli) +[![picocli](https://img.shields.io/badge/picocli-4.7.6-green.svg)](https://github.com/remkop/picocli) ``` #### Preach it! :muscle: @@ -365,41 +365,41 @@ See the [source code](https://github.com/remkop/picocli/blob/main/src/main/java/ ### Gradle ``` -implementation 'info.picocli:picocli:4.7.5' +implementation 'info.picocli:picocli:4.7.6' ``` ### Maven ``` info.picocli picocli - 4.7.5 + 4.7.6 ``` ### Scala SBT ``` -libraryDependencies += "info.picocli" % "picocli" % "4.7.5" +libraryDependencies += "info.picocli" % "picocli" % "4.7.6" ``` ### Ivy ``` - + ``` ### Grape ```groovy @Grapes( - @Grab(group='info.picocli', module='picocli', version='4.7.5') + @Grab(group='info.picocli', module='picocli', version='4.7.6') ) ``` ### Leiningen ``` -[info.picocli/picocli "4.7.5"] +[info.picocli/picocli "4.7.6"] ``` ### Buildr ``` -'info.picocli:picocli:jar:4.7.5' +'info.picocli:picocli:jar:4.7.6' ``` ### JBang ``` -//DEPS info.picocli:picocli:4.7.5 +//DEPS info.picocli:picocli:4.7.6 ``` diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md index 29c3bc02e..54ef1d1a2 100644 --- a/RELEASE-NOTES.md +++ b/RELEASE-NOTES.md @@ -1,6 +1,6 @@ # picocli Release Notes -# Picocli 4.7.6 (UNRELEASED) +# Picocli 4.7.6 The picocli community is pleased to announce picocli 4.7.6. This release includes bugfixes and enhancements. @@ -46,11 +46,13 @@ Artifacts in this release are signed by Remko Popma (6601 E5C0 8DCC BB96). * [#2108] DEP: Bump actions/checkout from 3.6.0 to 4.0.0 * [#2120] DEP: Bump actions/checkout from 4.0.0 to 4.1.0 * [#2225] DEP: Bump actions/checkout from 4.1.0 to 4.1.2 +* [#2272] DEP: Bump actions/checkout from 4.1.2 to 4.1.4 * [#2098] DEP: Bump actions/setup-java from 3.11.0 to 3.12.0 * [#2158] DEP: Bump actions/setup-java from 3.12.0 to 4.0.0 * [#2236] DEP: Bump actions/setup-java from 4.0.0 to 4.2.1. * [#2111] DEP: Bump actions/upload-artifact from 3.1.2 to 3.1.3 * [#2204] DEP: Bump actions/upload-artifact from 3.1.3 to 4.3.1 +* [#2273] DEP: Bump actions/upload-artifact from 4.3.1 to 4.3.3 * [#2227] DEP: Bump com.google.errorprone:error_prone_core from 2.23.0 to 2.26.1 * [#2271] DEP: Bump com.google.errorprone:error_prone_core from 2.26.1 to 2.27.1 * [#2237] DEP: Bump emibcn/badge-action from 2.0.2 to 2.0.3. diff --git a/dependencies.gradle b/dependencies.gradle index 86e4d59fe..864f87bd2 100644 --- a/dependencies.gradle +++ b/dependencies.gradle @@ -7,9 +7,9 @@ ext { // projectPreviousPublishedVersion is non-SNAPSHOT, only published releases projectPreviousPublishedVersion = "4\\.7\\.5" // for task bumpReadmeVersion // projectPreviousVersionRegex may be a SNAPSHOT - projectPreviousVersionRegex = "4\\.7\\.5" // for task bumpVersion - projectVersion = "4.7.6-SNAPSHOT" // for all build tasks - releaseDate = "2023-08-27" // for task bumpVersion + projectPreviousVersionRegex = "4\\.7\\.6-SNAPSHOT" // for task bumpVersion + projectVersion = "4.7.6" // for all build tasks + releaseDate = "2024-05-07" // for task bumpVersion releaseDatePreviousRegex = "2023\\-08\\-27" // for task bumpVersion // DEPENDENCIES diff --git a/docs/A-Whirlwind-Tour-of-Picocli.html b/docs/A-Whirlwind-Tour-of-Picocli.html index 4f8ea7977..7074966e4 100644 --- a/docs/A-Whirlwind-Tour-of-Picocli.html +++ b/docs/A-Whirlwind-Tour-of-Picocli.html @@ -1565,88 +1565,163 @@ }); + + +
@@ -3084,9 +3159,9 @@

Conclusion

- \ No newline at end of file + diff --git a/docs/announcing-picocli-1.0.html b/docs/announcing-picocli-1.0.html index 7f96c8a4b..c33694ed9 100644 --- a/docs/announcing-picocli-1.0.html +++ b/docs/announcing-picocli-1.0.html @@ -1,5 +1,5 @@ - + @@ -526,81 +526,81 @@ .CodeRay .change .change{color:#66f} .CodeRay .head .head{color:#f4f} - - - + + + @@ -608,7 +608,7 @@

Announcing picocli 1.0 - a mighty tiny command line interface

Remko Popma
-version 4.7.5, +version 4.7.6, 2017-09-10
@@ -732,7 +732,7 @@

Feedback Welcome

diff --git a/docs/apidocs-all/allclasses-frame.html b/docs/apidocs-all/allclasses-frame.html index b34a85aad..85a1809dd 100644 --- a/docs/apidocs-all/allclasses-frame.html +++ b/docs/apidocs-all/allclasses-frame.html @@ -3,7 +3,7 @@ -All Classes (picocli 4.7.5 API) +All Classes (picocli 4.7.6 API) diff --git a/docs/apidocs-all/allclasses-index.html b/docs/apidocs-all/allclasses-index.html index 099f408da..64852366b 100644 --- a/docs/apidocs-all/allclasses-index.html +++ b/docs/apidocs-all/allclasses-index.html @@ -3,7 +3,7 @@ -All Classes (picocli 4.7.5 API) +All Classes (picocli 4.7.6 API) @@ -21,7 +21,7 @@ diff --git a/docs/apidocs/allclasses-noframe.html b/docs/apidocs/allclasses-noframe.html index bc3cdd9f2..90c91eef0 100644 --- a/docs/apidocs/allclasses-noframe.html +++ b/docs/apidocs/allclasses-noframe.html @@ -3,7 +3,7 @@ -All Classes (picocli 4.7.5 API) +All Classes (picocli 4.7.6 API) diff --git a/docs/apidocs/constant-values.html b/docs/apidocs/constant-values.html index 5592c03de..e10902ef9 100644 --- a/docs/apidocs/constant-values.html +++ b/docs/apidocs/constant-values.html @@ -3,7 +3,7 @@ -Constant Field Values (picocli 4.7.5 API) +Constant Field Values (picocli 4.7.6 API) @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ diff --git a/docs/apidocs/picocli/package-summary.html b/docs/apidocs/picocli/package-summary.html index 94369f2e6..c6352948b 100644 --- a/docs/apidocs/picocli/package-summary.html +++ b/docs/apidocs/picocli/package-summary.html @@ -3,7 +3,7 @@ -picocli (picocli 4.7.5 API) +picocli (picocli 4.7.6 API) @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ - - - + + + diff --git a/docs/groovy-2.5-clibuilder-renewal-part1.html b/docs/groovy-2.5-clibuilder-renewal-part1.html index c4d151911..093a06ef6 100644 --- a/docs/groovy-2.5-clibuilder-renewal-part1.html +++ b/docs/groovy-2.5-clibuilder-renewal-part1.html @@ -1,5 +1,5 @@ - + @@ -525,88 +525,88 @@ .CodeRay .change .change{color:#66f} .CodeRay .head .head{color:#f4f} - - - + + + @@ -1051,7 +1051,7 @@

Wait, There’s More…​

diff --git a/docs/groovy-2.5-clibuilder-renewal-part2.html b/docs/groovy-2.5-clibuilder-renewal-part2.html index 51ef0012d..3cf0b7111 100644 --- a/docs/groovy-2.5-clibuilder-renewal-part2.html +++ b/docs/groovy-2.5-clibuilder-renewal-part2.html @@ -1,5 +1,5 @@ - + @@ -525,88 +525,88 @@ .CodeRay .change .change{color:#66f} .CodeRay .head .head{color:#f4f} - - - + + + @@ -1057,7 +1057,7 @@

Conclusion

diff --git a/docs/groovy-2.5-clibuilder-renewal.html b/docs/groovy-2.5-clibuilder-renewal.html index 1db853ad7..ee85d39b3 100644 --- a/docs/groovy-2.5-clibuilder-renewal.html +++ b/docs/groovy-2.5-clibuilder-renewal.html @@ -1,5 +1,5 @@ - + @@ -525,88 +525,88 @@ .CodeRay .change .change{color:#66f} .CodeRay .head .head{color:#f4f} - - - + + + @@ -1428,7 +1428,7 @@

Conclusion

diff --git a/docs/index.adoc b/docs/index.adoc index 92b61d48c..b6b8c44b4 100644 --- a/docs/index.adoc +++ b/docs/index.adoc @@ -1,8 +1,8 @@ = picocli - a mighty tiny command line interface //:author: Remko Popma //:email: rpopma@apache.org -:revnumber: 4.7.6-SNAPSHOT -:revdate: 2023-08-27 +:revnumber: 4.7.6 +:revdate: 2024-05-07 :toc: left :numbered: :toclevels: 2 @@ -120,7 +120,7 @@ class CheckSum implements Callable { [[CheckSum-App-Groovy]] [source,groovy,role="secondary"] ---- -@Grab('info.picocli:picocli-groovy:4.7.6-SNAPSHOT') +@Grab('info.picocli:picocli-groovy:4.7.6') import picocli.CommandLine import static picocli.CommandLine.* @@ -152,7 +152,7 @@ class Checksum implements Callable { [[CheckSum-App-Groovy-Script]] [source,groovy,role="secondary"] ---- -@Grab('info.picocli:picocli-groovy:4.7.6-SNAPSHOT') +@Grab('info.picocli:picocli-groovy:4.7.6') import static picocli.CommandLine.* import groovy.transform.Field import java.security.MessageDigest @@ -279,7 +279,7 @@ Below are examples of configuring Gradle or Maven to use picocli as an external [source,groovy,role="primary"] ---- dependencies { - implementation 'info.picocli:picocli:4.7.6-SNAPSHOT' + implementation 'info.picocli:picocli:4.7.6' } ---- .Maven @@ -288,7 +288,7 @@ dependencies { info.picocli picocli - 4.7.6-SNAPSHOT + 4.7.6 ---- @@ -325,8 +325,8 @@ https://immutables.github.io/apt.html[This page] shows the steps to configure Ec [source,groovy,role="primary"] ---- dependencies { - implementation 'info.picocli:picocli:4.7.6-SNAPSHOT' - annotationProcessor 'info.picocli:picocli-codegen:4.7.6-SNAPSHOT' + implementation 'info.picocli:picocli:4.7.6' + annotationProcessor 'info.picocli:picocli-codegen:4.7.6' } @@ -348,7 +348,7 @@ compileJava { info.picocli picocli-codegen - 4.7.6-SNAPSHOT + 4.7.6 @@ -368,7 +368,7 @@ then replace `annotationProcessor` with `kapt`: apply plugin: 'kotlin-kapt' // required dependencies { // ... - kapt 'info.picocli:picocli-codegen:4.7.6-SNAPSHOT' + kapt 'info.picocli:picocli-codegen:4.7.6' } ``` @@ -399,7 +399,7 @@ Now, assuming we created a jar named `checksum.jar` containing our compiled `Che [source,bash] ---- -java -cp "picocli-4.7.6-SNAPSHOT.jar:checksum.jar" CheckSum --algorithm SHA-1 hello.txt +java -cp "picocli-4.7.6.jar:checksum.jar" CheckSum --algorithm SHA-1 hello.txt ---- You may want to package your application in such a way that end users can invoke it with a short command like this: @@ -10384,7 +10384,7 @@ Eventually, we are ready to run our application: [source,bash] ---- -java -cp "picocli-4.7.6-SNAPSHOT.jar;myapp.jar" org.myorg.GreetingApp Sarah Lea +java -cp "picocli-4.7.6.jar;myapp.jar" org.myorg.GreetingApp Sarah Lea ---- With no command line parameter `--locale` given, the message texts are printed in the default language (here: English): @@ -10398,7 +10398,7 @@ In order to control the locale chosen for our output, we have to make use of the [source,bash] ---- -java -cp "picocli-4.7.6-SNAPSHOT.jar;myapp.jar" org.myorg.GreetingApp --locale=es Sarah Lea +java -cp "picocli-4.7.6.jar;myapp.jar" org.myorg.GreetingApp --locale=es Sarah Lea ---- Now our message texts are printed in Spanish: @@ -11717,21 +11717,21 @@ Since picocli dependencies are not available in the Spring Initializr, we have t info.picocli picocli-spring-boot-starter - 4.7.6-SNAPSHOT + 4.7.6 ---- .Gradle (Groovy) [source,groovy,role="secondary"] ---- dependencies { - implementation 'info.picocli:picocli-spring-boot-starter:4.7.6-SNAPSHOT' + implementation 'info.picocli:picocli-spring-boot-starter:4.7.6' } ---- .Gradle (Kotlin) [source,kotlin,role="secondary"] ---- dependencies { - implementation("info.picocli:picocli-spring-boot-starter:4.7.6-SNAPSHOT") + implementation("info.picocli:picocli-spring-boot-starter:4.7.6") } ---- @@ -13081,7 +13081,7 @@ As mentioned in <>, earlier in this manual, one way to [source,bash] ---- -java -cp "picocli-4.7.6-SNAPSHOT.jar;myapp.jar" org.myorg.MyMainClass --option=value arg0 arg1 +java -cp "picocli-4.7.6.jar;myapp.jar" org.myorg.MyMainClass --option=value arg0 arg1 ---- That is quite verbose. You may want to package your application in such a way that end users can invoke it by its command name like this: @@ -13100,7 +13100,7 @@ On unix-based operating systems, you can ask your users to define an alias. For [source,bash] ---- -alias mycommand='java -cp "/path/to/picocli-4.7.6-SNAPSHOT.jar:/path/to/myapp.jar" org.myorg.MainClass' +alias mycommand='java -cp "/path/to/picocli-4.7.6.jar:/path/to/myapp.jar" org.myorg.MainClass' ---- Append the above line to your `~/.bashrc` file to make this alias available in every new shell session. @@ -13149,7 +13149,7 @@ After installing GraalVM and installing the `native-image` generator utility (wi you can then create a native image by invoking the `native-image` command: ---- -path/to/native-image -cp picocli-4.7.6-SNAPSHOT.jar --static -jar myapp.jar +path/to/native-image -cp picocli-4.7.6.jar --static -jar myapp.jar ---- CAUTION: To create a native image, the compiler toolchain for your platform needs to be installed. See https://www.infoq.com/articles/java-native-cli-graalvm-picocli/[Build Great Native CLI Apps in Java with Graalvm and Picocli] for details. @@ -13294,7 +13294,7 @@ The script body is executed if the user input was valid and did not request usag [source,groovy] ---- -@Grab('info.picocli:picocli-groovy:4.7.6-SNAPSHOT') +@Grab('info.picocli:picocli-groovy:4.7.6') @GrabConfig(systemClassLoader=true) @Command(name = "myScript", mixinStandardHelpOptions = true, // add --help and --version options @@ -13335,7 +13335,7 @@ The table below compares these two base classes. WARNING: When upgrading scripts from picocli versions older than 4.0, just changing the version number is not enough! -Scripts should use `@Grab('info.picocli:picocli-groovy:4.7.6-SNAPSHOT')`. The old artifact id `@Grab('info.picocli:picocli:4.7.6-SNAPSHOT')` will not work, +Scripts should use `@Grab('info.picocli:picocli-groovy:4.7.6')`. The old artifact id `@Grab('info.picocli:picocli:4.7.6')` will not work, because the `@picocli.groovy.PicocliScript` annotation class and supporting classes have been moved into a separate module, `picocli-groovy`. ==== Closures in Annotations @@ -13393,7 +13393,7 @@ NOTE: When using a Groovy version older than 2.4.7, use this workaround for the [source,groovy] ---- -@Grab('info.picocli:picocli-groovy:4.7.6-SNAPSHOT') +@Grab('info.picocli:picocli-groovy:4.7.6') @GrabExclude('org.codehaus.groovy:groovy-all') // work around GROOVY-7613 ... ---- @@ -13536,13 +13536,13 @@ You can add picocli as an external dependency to your project, or you can includ .Gradle [source,groovy,role="primary"] ---- -implementation 'info.picocli:picocli:4.7.6-SNAPSHOT' +implementation 'info.picocli:picocli:4.7.6' ---- .Gradle (Kotlin) [source,kotlin,role="secondary"] ---- -implementation("info.picocli:picocli:4.7.6-SNAPSHOT") +implementation("info.picocli:picocli:4.7.6") ---- .Maven @@ -13551,50 +13551,50 @@ implementation("info.picocli:picocli:4.7.6-SNAPSHOT") info.picocli picocli - 4.7.6-SNAPSHOT + 4.7.6 ---- .Scala SBT [source,role="secondary"] ---- -libraryDependencies += "info.picocli" % "picocli" % "4.7.6-SNAPSHOT" +libraryDependencies += "info.picocli" % "picocli" % "4.7.6" ---- .Ivy [source,role="secondary"] ---- - + ---- .Grape [source,role="secondary"] ---- @Grapes( - @Grab(group='info.picocli', module='picocli', version='4.7.6-SNAPSHOT') + @Grab(group='info.picocli', module='picocli', version='4.7.6') ) ---- .Leiningen [source,role="secondary"] ---- -[info.picocli/picocli "4.7.6-SNAPSHOT"] +[info.picocli/picocli "4.7.6"] ---- .Buildr [source,role="secondary"] ---- -'info.picocli:picocli:jar:4.7.6-SNAPSHOT' +'info.picocli:picocli:jar:4.7.6' ---- .JBang [source,role="secondary"] ---- -//DEPS info.picocli:picocli:4.7.6-SNAPSHOT +//DEPS info.picocli:picocli:4.7.6 ---- === Source By using picocli in source form, you can avoid having an external dependency on picocli. -Picocli has only one source file: link:https://github.com/remkop/picocli/blob/v4.7.6-SNAPSHOT/src/main/java/picocli/CommandLine.java[CommandLine.java]. +Picocli has only one source file: link:https://github.com/remkop/picocli/blob/v4.7.6/src/main/java/picocli/CommandLine.java[CommandLine.java]. This facilitates including picocli in your project: simply copy and paste the code of this file into a file called `CommandLine.java`, add it to your project, and enjoy! diff --git a/docs/index.html b/docs/index.html index 52f8566cd..04d2cbf0b 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,5 +1,5 @@ - + @@ -1709,89 +1709,89 @@ }); }); - - - + + + @@ -2488,8 +2488,8 @@
Usi
Gradle
dependencies {
-    implementation 'info.picocli:picocli:4.7.5'
-    annotationProcessor 'info.picocli:picocli-codegen:4.7.5'
+    implementation 'info.picocli:picocli:4.7.6'
+    annotationProcessor 'info.picocli:picocli-codegen:4.7.6'
 }
 
 
@@ -2511,7 +2511,7 @@ 
Usi
       <path>
         <groupId>info.picocli</groupId>
         <artifactId>picocli-codegen</artifactId>
-        <version>4.7.5</version>
+        <version>4.7.6</version>
       </path>
     </annotationProcessorPaths>
     <compilerArgs>
@@ -2536,7 +2536,7 @@ 
apply plugin: 'kotlin-kapt' // required
 dependencies {
     // ...
-    kapt 'info.picocli:picocli-codegen:4.7.5'
+    kapt 'info.picocli:picocli-codegen:4.7.6'
 }
@@ -2579,7 +2579,7 @@

-
java -cp "picocli-4.7.5.jar:checksum.jar" CheckSum --algorithm SHA-1 hello.txt
+
java -cp "picocli-4.7.6.jar:checksum.jar" CheckSum --algorithm SHA-1 hello.txt
@@ -3131,7 +3131,7 @@

3.5 Short option names are not given a negative alias by default. (This is customizable.)

-

If the negated form of the option is found, for example --no-verbose, the value is set to the provided default. Otherwise, with a regular call, for example --verbose, it is set to the opposite of the default.

+

If the negated form of the option is found, for example --no-verbose, the value is set to false. Otherwise, with a regular call, for example --verbose, the value is set to true.

@@ -3370,6 +3370,9 @@

3.8. Double dash (--)

+

Picocli offers built-in support for the End-of-Options delimiter (--), as defined in Guideline 10 of the POSIX Utility Syntax Guidelines.

+
+

When one of the command line arguments is just two dashes without any characters attached (--), picocli interprets all following arguments as positional parameters, even arguments that match an option name.

@@ -4714,7 +4717,7 @@

-

By default, this implementation tries to find a properties file named .${COMMAND-NAME}.properties in the user home directory, where ${COMMAND-NAME} is the name of the command. If a command has aliases in addition to its name, these aliases are also used to try to find the properties file. For example:

+

By default, this implementation tries to find a properties file named .${COMMAND-NAME}.properties in the user home directory or in the classpath, where ${COMMAND-NAME} is the name of the command. If a command has aliases in addition to its name, these aliases are also used to try to find the properties file. For example:

Java
@@ -4736,7 +4739,8 @@

The above will try to load default values from new File(System.getProperty("user.home"), ".git.properties"). -The location of the properties file can also be controlled with system property "picocli.defaults.${COMMAND-NAME}.path" ("picocli.defaults.git.path" in this example), in which case the value of the property must be the path to the file containing the default values.

+The location of the properties file can also be controlled with system property "picocli.defaults.${COMMAND-NAME}.path" ("picocli.defaults.git.path" in this example), in which case the value of the property must be the path to the file containing the default values. +Finally, picocli will try to load the .git.properties file from the classpath.

The location of the properties file may also be specified programmatically. For example:

@@ -14965,7 +14969,7 @@

-
java -cp "picocli-4.7.5.jar;myapp.jar" org.myorg.GreetingApp Sarah Lea
+
java -cp "picocli-4.7.6.jar;myapp.jar" org.myorg.GreetingApp Sarah Lea

@@ -14982,7 +14986,7 @@

-
java -cp "picocli-4.7.5.jar;myapp.jar" org.myorg.GreetingApp --locale=es Sarah Lea
+
java -cp "picocli-4.7.6.jar;myapp.jar" org.myorg.GreetingApp --locale=es Sarah Lea

@@ -16614,7 +16618,7 @@

<dependency> <groupId>info.picocli</groupId> <artifactId>picocli-spring-boot-starter</artifactId> - <version>4.7.5</version> + <version>4.7.6</version> </dependency>

@@ -16622,7 +16626,7 @@

Gradle (Groovy) 
dependencies {
-    implementation 'info.picocli:picocli-spring-boot-starter:4.7.5'
+    implementation 'info.picocli:picocli-spring-boot-starter:4.7.6'
 }
@@ -16630,7 +16634,7 @@

Gradle (Kotlin) 
dependencies {
-    implementation("info.picocli:picocli-spring-boot-starter:4.7.5")
+    implementation("info.picocli:picocli-spring-boot-starter:4.7.6")
 }
@@ -18320,7 +18324,7 @@

-
java -cp "picocli-4.7.5.jar;myapp.jar" org.myorg.MyMainClass --option=value arg0 arg1
+
java -cp "picocli-4.7.6.jar;myapp.jar" org.myorg.MyMainClass --option=value arg0 arg1
@@ -18344,7 +18348,7 @@

29.1. Alias

-
alias mycommand='java -cp "/path/to/picocli-4.7.5.jar:/path/to/myapp.jar" org.myorg.MainClass'
+
alias mycommand='java -cp "/path/to/picocli-4.7.6.jar:/path/to/myapp.jar" org.myorg.MainClass'
@@ -18421,7 +18425,7 @@

-
path/to/native-image -cp picocli-4.7.5.jar --static -jar myapp.jar
+
path/to/native-image -cp picocli-4.7.6.jar --static -jar myapp.jar
@@ -18642,7 +18646,7 @@

30.1.2. G

-
@Grab('info.picocli:picocli-groovy:4.7.5')
+
@Grab('info.picocli:picocli-groovy:4.7.6')
 @GrabConfig(systemClassLoader=true)
 @Command(name = "myScript",
         mixinStandardHelpOptions = true, // add --help and --version options
@@ -18728,7 +18732,7 @@ 
30.1.2. G

@@ -18835,7 +18839,7 @@

-
@Grab('info.picocli:picocli-groovy:4.7.5')
+
@Grab('info.picocli:picocli-groovy:4.7.6')
 @GrabExclude('org.codehaus.groovy:groovy-all') // work around GROOVY-7613
 ...
@@ -19026,13 +19030,13 @@

37.1. Build too
Gradle
-
implementation 'info.picocli:picocli:4.7.5'
+
implementation 'info.picocli:picocli:4.7.6'
Gradle (Kotlin)
-
implementation("info.picocli:picocli:4.7.5")
+
implementation("info.picocli:picocli:4.7.6")
@@ -19041,46 +19045,46 @@

37.1. Build too 
<dependency>
   <groupId>info.picocli</groupId>
   <artifactId>picocli</artifactId>
-  <version>4.7.5</version>
+  <version>4.7.6</version>
 </dependency>

Scala SBT
-
libraryDependencies += "info.picocli" % "picocli" % "4.7.5"
+
libraryDependencies += "info.picocli" % "picocli" % "4.7.6"
Ivy
-
<dependency org="info.picocli" name="picocli" rev="4.7.5" />
+
<dependency org="info.picocli" name="picocli" rev="4.7.6" />
Grape
@Grapes(
-    @Grab(group='info.picocli', module='picocli', version='4.7.5')
+    @Grab(group='info.picocli', module='picocli', version='4.7.6')
 )
Leiningen
-
[info.picocli/picocli "4.7.5"]
+
[info.picocli/picocli "4.7.6"]
Buildr
-
'info.picocli:picocli:jar:4.7.5'
+
'info.picocli:picocli:jar:4.7.6'
JBang
-
//DEPS info.picocli:picocli:4.7.5
+
//DEPS info.picocli:picocli:4.7.6
@@ -19088,7 +19092,7 @@

37.1. Build too

37.2. Source

By using picocli in source form, you can avoid having an external dependency on picocli. -Picocli has only one source file: CommandLine.java. +Picocli has only one source file: CommandLine.java. This facilitates including picocli in your project: simply copy and paste the code of this file into a file called CommandLine.java, add it to your project, and enjoy!

@@ -19097,8 +19101,8 @@

37.2. Source

diff --git a/docs/man/gen-manpage.html b/docs/man/gen-manpage.html index c51ea0db6..68ff85ff5 100644 --- a/docs/man/gen-manpage.html +++ b/docs/man/gen-manpage.html @@ -1,28 +1,26 @@ - + - + gen-manpage(1) - - - + + +
@@ -548,7 +548,7 @@

Picocli Built-In Tools

diff --git a/docs/man/picocli.AutoComplete.html b/docs/man/picocli.AutoComplete.html index 619ff7252..8acff3b5e 100644 --- a/docs/man/picocli.AutoComplete.html +++ b/docs/man/picocli.AutoComplete.html @@ -1,28 +1,26 @@ - + - + picocli.AutoComplete(1) - - - + + + @@ -608,7 +608,7 @@

Migrating from Commons CLI to picocli

Remko Popma
-version 4.7.5, +version 4.7.6, 2018-11-19
@@ -1048,7 +1048,7 @@

Conclusion

diff --git a/docs/picocli-2.0-do-more-with-less.html b/docs/picocli-2.0-do-more-with-less.html index 5b6e41a80..f62ba29aa 100644 --- a/docs/picocli-2.0-do-more-with-less.html +++ b/docs/picocli-2.0-do-more-with-less.html @@ -1,5 +1,5 @@ - + @@ -525,88 +525,88 @@ .CodeRay .change .change{color:#66f} .CodeRay .head .head{color:#f4f} - - - + + +
@@ -995,7 +995,7 @@

Conclusion

diff --git a/docs/picocli-2.0-groovy-scripts-on-steroids.html b/docs/picocli-2.0-groovy-scripts-on-steroids.html index 2fd872576..30e8fd4da 100644 --- a/docs/picocli-2.0-groovy-scripts-on-steroids.html +++ b/docs/picocli-2.0-groovy-scripts-on-steroids.html @@ -1,5 +1,5 @@ - + @@ -525,88 +525,88 @@ .CodeRay .change .change{color:#66f} .CodeRay .head .head{color:#f4f} - - - + + +
@@ -885,7 +885,7 @@

Conclusion

diff --git a/docs/picocli-on-graalvm.html b/docs/picocli-on-graalvm.html index 396002696..9b918f4c5 100644 --- a/docs/picocli-on-graalvm.html +++ b/docs/picocli-on-graalvm.html @@ -1,5 +1,5 @@ - + @@ -436,88 +436,88 @@ @media amzn-kf8{#header,#content,#footnotes,#footer{padding:0}} - - - + + +
@@ -733,7 +733,7 @@

Conclusion

diff --git a/docs/picocli-programmatic-api.adoc b/docs/picocli-programmatic-api.adoc index e12540e63..5ccbba7d0 100644 --- a/docs/picocli-programmatic-api.adoc +++ b/docs/picocli-programmatic-api.adoc @@ -1,8 +1,8 @@ = Programmatic API //:author: Remko Popma //:email: rpopma@apache.org -:revnumber: 4.7.6-SNAPSHOT -:revdate: 2023-08-27 +:revnumber: 4.7.6 +:revdate: 2024-05-07 :toc: left :numbered: :toclevels: 2 diff --git a/docs/picocli-programmatic-api.html b/docs/picocli-programmatic-api.html index f610d038a..9afe3c38c 100644 --- a/docs/picocli-programmatic-api.html +++ b/docs/picocli-programmatic-api.html @@ -1,5 +1,5 @@ - + @@ -436,89 +436,89 @@ @media amzn-kf8{#header,#content,#footnotes,#footer{padding:0}} - - - + + +

When upgrading scripts from picocli versions older than 4.0, just changing the version number is not enough! -Scripts should use @Grab('info.picocli:picocli-groovy:4.7.5'). The old artifact id @Grab('info.picocli:picocli:4.7.5') will not work, +Scripts should use @Grab('info.picocli:picocli-groovy:4.7.6'). The old artifact id @Grab('info.picocli:picocli:4.7.6') will not work, because the @picocli.groovy.PicocliScript annotation class and supporting classes have been moved into a separate module, picocli-groovy.