Package org.apache.logging.log4j.core.tools.picocli
-
Interface Summary Interface Description CommandLine.Help.Ansi.IStyle Defines the interface for an ANSI escape sequence.CommandLine.Help.IOptionRenderer When customizing online help forOptiondetails, a customIOptionRenderercan be used to create textual representation of an Option in a tabular format: one or more rows, each containing one or more columns.CommandLine.Help.IParameterRenderer When customizing online help forParametersdetails, a customIParameterRenderercan be used to create textual representation of a Parameters field in a tabular format: one or more rows, each containing one or more columns.CommandLine.Help.IParamLabelRenderer When customizing online usage help for an option parameter or a positional parameter, a customIParamLabelRenderercan be used to render the parameter name or label to a String.CommandLine.IExceptionHandler Represents a function that can handle aParameterExceptionthat occurred while parsing the command line arguments.CommandLine.IParseResultHandler Represents a function that can process a List ofCommandLineobjects resulting from successfully parsing the command line arguments.CommandLine.ITypeConverter<K> When parsing command line arguments and initializing fields annotated with@Optionor@Parameters, String values can be converted to any type for which aITypeConverteris registered. -
Class Summary Class Description CommandLine CommandLine interpreter that uses reflection to initialize an annotated domain object with values obtained from the command line arguments.CommandLine.DefaultExceptionHandler Default exception handler that prints the exception message to the specifiedPrintStream, followed by the usage message for the command or subcommand whose input was invalid.CommandLine.Help A collection of methods and inner classes that provide fine-grained control over the contents and layout of the usage help message to display to end users when help is requested or invalid input values were specified.CommandLine.Help.ColorScheme All usage help message are generated with a color scheme that assigns certain styles and colors to common parts of a usage message: the command name, options, positional parameters and option parameters.CommandLine.Help.Column CommandLine.Help.Layout Use a Layout to format usage help text for options and parameters in tabular format.CommandLine.Help.TextTable Responsible for spacing outCommandLine.Help.Ansi.Textvalues according to theCommandLine.Help.Columndefinitions the table was created with.CommandLine.Help.TextTable.Cell Helper class to index positions in aHelp.TextTable.CommandLine.Range Describes the number of parameters required and accepted by an option or a positional parameter.CommandLine.RunAll Command line parse result handler that prints help if requested, and otherwise executes the top-level command and all subcommands asRunnableorCallable.CommandLine.RunFirst Command line parse result handler that prints help if requested, and otherwise executes the top-levelRunnableorCallablecommand.CommandLine.RunLast Command line parse result handler that prints help if requested, and otherwise executes the most specificRunnableorCallablesubcommand. -
Enum Summary Enum Description CommandLine.Help.Ansi Provides methods and inner classes to support using ANSI escape codes in usage help messages.CommandLine.Help.Ansi.Style A set of pre-defined ANSI escape code styles and colors, and a set of convenience methods for parsing text with embedded markup style names, as well as convenience methods for converting styles to strings with embedded escape codes.CommandLine.Help.Column.Overflow Policy for handling text that is longer than the column width: span multiple columns, wrap to the next row, or simply truncate the portion that doesn't fit. -
Exception Summary Exception Description CommandLine.DuplicateOptionAnnotationsException Exception indicating that multiple fields have been annotated with the same Option name.CommandLine.ExecutionException Exception indicating a problem while invoking a command or subcommand.CommandLine.InitializationException Exception indicating a problem duringCommandLineinitialization.CommandLine.MaxValuesforFieldExceededException Exception indicating that more values were specified for an option or parameter than itsarityallows.CommandLine.MissingParameterException Exception indicating that a required parameter was not specified.CommandLine.MissingTypeConverterException Exception indicating that an annotated field had a type for which noCommandLine.ITypeConverterwas registered.CommandLine.OverwrittenOptionException Exception indicating that an option for a single-value option field has been specified multiple times on the command line.CommandLine.ParameterException Exception indicating something went wrong while parsing command line options.CommandLine.ParameterIndexGapException Exception indicating that there was a gap in the indices of the fields annotated withCommandLine.Parameters.CommandLine.PicocliException Base class of all exceptions thrown bypicocli.CommandLine.CommandLine.TypeConversionException Exception thrown byCommandLine.ITypeConverterimplementations to indicate a String could not be converted.CommandLine.UnmatchedArgumentException Exception indicating that a command line argument could not be mapped to any of the fields annotated withCommandLine.OptionorCommandLine.Parameters. -
Annotation Types Summary Annotation Type Description CommandLine.Command Annotate your class with@Commandwhen you want more control over the format of the generated help message.CommandLine.Option Annotate fields in your class with@Optionand picocli will initialize these fields when matching arguments are specified on the command line.CommandLine.Parameters Fields annotated with@Parameterswill be initialized with positional parameters.