Package org.refcodes.cli

package org.refcodes.cli

This artifact defines some helpful toolkit to parse your command line arguments (as passed to your public static void main( String[] args) { ... } method. It lets you define the exact valid combinations of command line arguments, it parses them arguments for you and it lets you print the syntax as you programmatically defined it. Let's get started!

Please refer to the refcodes-cli: ArgsParser your args[] documentation for an up-to-date and detailed description on the usage of this artifact.

Class	Description
AbstractCondition	The AbstractCondition is an abstract implementation of the Condition interface providing the boiler plate when implementing the Condition interface as done by the AbstractCondition's sub-classes.
AbstractDirective<T>	The AbstractDirective is an abstract implementation of an Directive providing the boiler plate when implementing the Directive interface.
AbstractOperand<T>	The AbstractOperand is an abstract implementation of an Operand providing the boiler plate when implementing the Operand interface.
AbstractOption<T>	The AbstractOption is an abstract implementation of an Option providing the boiler plate when implementing the Option interface.
AbstractProperty<T>	The AbstractProperty is an abstract implementation of a Property providing the boiler plate when implementing the Property interface.
AllCondition	The AllCondition enforces that the encapsulated Term consumes all arguments passed via invoking its Term.parseArgs(String[], CliContext), else a SuperfluousArgsException is thrown.
AmbiguousArgsException	Thrown in case the command line arguments do not match the required syntax.
AndCondition	An AndCondition contains (represents) a list of Condition (Term) instances (nested by the AndCondition) of which all are to be parsed successfully as of invoking the Term.parseArgs(String[], String[], CliContext) methods.
AnyCondition	Any of the nested Condition conditions may match for the AnyCondition to match, e.g. all of the nested conditions are optional.
ArgsAccessor	Provides an accessor for a command line arguments (short "args") array.
ArgsAccessor.ArgsMutator	Provides a mutator for a args property.
ArgsAccessor.ArgsProperty	Provides a args property.
ArgsFilter	Enumeration declaring command line argument filter.
ArgsParser	The ArgsParser provides means for parsing command line arguments and constructing a command line utility's help output.
ArgsParserAccessor	Provides an accessor for a ArgsParser property.
ArgsParserAccessor.ArgsParserBuilder<B extends ArgsParserAccessor.ArgsParserBuilder<B>>	Provides a builder method for a ArgsParser property returning the builder for applying multiple build operations.
ArgsParserAccessor.ArgsParserMutator	Provides a mutator for a ArgsParser property.
ArgsParserAccessor.ArgsParserProperty	Provides a ArgsParser property.
ArgsParserBuilder<B extends ArgsParserBuilder<B>>	This mixin provides builder additions (as of the builder pattern for chained configuring method calls) for parsing command line arguments.
ArgsProcessorBuilder<B extends ArgsProcessorBuilder<B>>	The ArgsProcessorBuilder provides common minimum builder functionality required by to build an argument processing instance.
ArgsProvidierBuilder<B extends ArgsProvidierBuilder<B>>	The ArgsProvidierBuilder interface provides builder methods for feeding command line arguments.
ArgsSyntaxAccessor	Provides an accessor for a (root) Term property.
ArgsSyntaxAccessor.ArgsSyntaxBuilder<B extends ArgsSyntaxAccessor.ArgsSyntaxBuilder<B>>	Provides a builder method for a (root) Term property returning the builder for applying multiple build operations.
ArgsSyntaxAccessor.ArgsSyntaxMutator	Provides a mutator for a (root) Term property.
ArgsSyntaxAccessor.ArgsSyntaxProperty	Provides a (root) Term property.
ArgsSyntaxException	Thrown in case of a command line arguments mismatch regarding provided and expected args.
ArgumentEscapeCodeAccessor	Provides an accessor for a argument Escape-Code property.
ArgumentEscapeCodeAccessor.ArgumentEscapeCodeBuilder<B extends ArgumentEscapeCodeAccessor.ArgumentEscapeCodeBuilder<B>>	Provides a builder method for a argument Escape-Code property returning the builder for applying multiple build operations.
ArgumentEscapeCodeAccessor.ArgumentEscapeCodeMutator	Provides a mutator for a argument Escape-Code property.
ArgumentEscapeCodeAccessor.ArgumentEscapeCodeProperty	Provides a argument Escape-Code property.
ArgumentPrefixAccessor	Provides an accessor for an argument prefix property.
ArgumentPrefixAccessor.ArgumentPrefixBuilder<B extends ArgumentPrefixAccessor.ArgumentPrefixBuilder<B>>	Provides a builder method for an argument prefix property returning the builder for applying multiple build operations.
ArgumentPrefixAccessor.ArgumentPrefixMutator	Provides a mutator for an argument prefix property.
ArgumentPrefixAccessor.ArgumentPrefixProperty	Provides an argument prefix property.
ArgumentSuffixAccessor	Provides an accessor for an argument suffix property.
ArgumentSuffixAccessor.ArgumentSuffixBuilder<B extends ArgumentSuffixAccessor.ArgumentSuffixBuilder<B>>	Provides a builder method for an argument suffix property returning the builder for applying multiple build operations.
ArgumentSuffixAccessor.ArgumentSuffixMutator	Provides a mutator for an argument suffix property.
ArgumentSuffixAccessor.ArgumentSuffixProperty	Provides an argument suffix property.
ArrayDirective<T>	Creates an array representation facade for the encapsulated Directive.
ArrayOperand<T>	Creates an array representation facade for the encapsulated Operand.
ArrayOption<T>	Creates an array representation facade for the encapsulated Option.
BannerBorderEscapeCodeAccessor	Provides an accessor for a banner border Escape-Code property.
BannerBorderEscapeCodeAccessor.BannerBorderEscapeCodeBuilder<B extends BannerBorderEscapeCodeAccessor.BannerBorderEscapeCodeBuilder<B>>	Provides a builder method for a banner border Escape-Code property returning the builder for applying multiple build operations.
BannerBorderEscapeCodeAccessor.BannerBorderEscapeCodeMutator	Provides a mutator for a banner border Escape-Code property.
BannerBorderEscapeCodeAccessor.BannerBorderEscapeCodeProperty	Provides a banner border Escape-Code property.
BannerEscapeCodeAccessor	Provides an accessor for a banner Escape-Code property.
BannerEscapeCodeAccessor.BannerEscapeCodeBuilder<B extends BannerEscapeCodeAccessor.BannerEscapeCodeBuilder<B>>	Provides a builder method for a banner Escape-Code property returning the builder for applying multiple build operations.
BannerEscapeCodeAccessor.BannerEscapeCodeMutator	Provides a mutator for a banner Escape-Code property.
BannerEscapeCodeAccessor.BannerEscapeCodeProperty	Provides a banner Escape-Code property.
BannerFontAccessor	Provides an accessor for a banner Font property.
BannerFontAccessor.BannerFontBuilder<B extends BannerFontAccessor.BannerFontBuilder<B>>	Provides a builder method for a banner Font property returning the builder for applying multiple build operations.
BannerFontAccessor.BannerFontMutator	Provides a mutator for a banner Font property.
BannerFontAccessor.BannerFontProperty	Provides a banner Font property.
BannerFontPaletteAccessor	Provides an accessor for a banner font palette property.
BannerFontPaletteAccessor.BannerFontPaletteBuilder<B extends BannerFontPaletteAccessor.BannerFontPaletteBuilder<B>>	Provides a builder method for a banner font palette property returning the builder for applying multiple build operations.
BannerFontPaletteAccessor.BannerFontPaletteMutator	Provides a mutator for a banner font palette property.
BannerFontPaletteAccessor.BannerFontPaletteProperty	Provides a banner font palette property.
BooleanDirective	The BooleanDirective represents a Directive holding boolean values.
BooleanOption	The BooleanOption represents an Option holding boolean values.
BooleanProperty	The BooleanProperty represents an Property holding boolean values.
CasesCondition	The CasesCondition is an XorCondition making sure that all possible cases inside the XorCondition must(!)
CharDirective	The CharDirective represents a Directive holding String values.
CharOption	The CharOption represents an Option holding String values.
CharProperty	The CharProperty represents an Property holding String values.
CleanFlag	A predefined clean Flag: A predefined Flag gives its CleanFlag.SHORT_OPTION, its CleanFlag.LONG_OPTION as well as its CleanFlag.ALIAS an according semantics regarded by other subsystems.
CliArgsParser	A straightforward implementation of the ArgsParser interface.
CliContext	The CliContext describes the context in which an ArgsParser is running.
CliContext.Builder	Builder to build SyntaxMetricsAccessor.SyntaxMetricsBuilder instances.
CliContextAccessor	Provides an accessor for a CliContext property.
CliContextAccessor.CliContextBuilder<B extends CliContextAccessor.CliContextBuilder<B>>	Provides a builder method for a CliContext property returning the builder for applying multiple build operations.
CliContextAccessor.CliContextMutator	Provides a mutator for a CliContext property.
CliContextAccessor.CliContextProperty	Provides a CliContext property.
CliException	Base exception for the CLI artifact.
CliException.CliArgsException	This abstract exception is the base exception for all command line argument related exceptions.
CliMetrics	The CliMetrics define the attributes required to parse a Term tree's syntax by an ArgsParser.
CliSchemaOntology	The CliSchemaOntology describes the terms used in the CLI for Schema generation.
CliSugar	Declarative syntactic sugar which may be statically imported in order to allow declarative definitions for the command line Flag, Condition, Option and Operand elements.
CommandEscapeCodeAccessor	Provides an accessor for a command Escape-Code property.
CommandEscapeCodeAccessor.CommandEscapeCodeBuilder<B extends CommandEscapeCodeAccessor.CommandEscapeCodeBuilder<B>>	Provides a builder method for a command Escape-Code property returning the builder for applying multiple build operations.
CommandEscapeCodeAccessor.CommandEscapeCodeMutator	Provides a mutator for a command Escape-Code property.
CommandEscapeCodeAccessor.CommandEscapeCodeProperty	Provides a command Escape-Code property.
Condition	The Condition interface represents a node (and therewith the syntax for the arguments) in the command line arguments syntax tree by simply extending the Term interface and adding the functionality of providing access to the added Operands (leafs).
ConfigOption	The ConfigOption represents an Option holding a value specifying a configuration resource (file).
ConfigProperty	The ConfigProperty represents an Property holding a value specifying a configuration resource (file).
CopyrightAccessor	Provides an accessor for a copyright property.
CopyrightAccessor.CopyrightBuilder<B extends CopyrightAccessor.CopyrightBuilder<B>>	Provides a builder method for a copyright property returning the builder for applying multiple build operations.
CopyrightAccessor.CopyrightMutator	Provides a mutator for a copyright property.
CopyrightAccessor.CopyrightProperty	Provides a copyright property.
DaemonFlag	A predefined daemon Flag: A predefined Flag gives its DaemonFlag.SHORT_OPTION, its DaemonFlag.LONG_OPTION as well as its DaemonFlag.ALIAS an according semantics regarded by other subsystems.
DebugFlag	A predefined debug Flag: A predefined Flag gives its DebugFlag.SHORT_OPTION, its DebugFlag.LONG_OPTION as well as its DebugFlag.ALIAS an according semantics regarded by other subsystems.
DescriptionEscapeCodeAccessor	Provides an accessor for a description Escape-Code property.
DescriptionEscapeCodeAccessor.DescriptionEscapeCodeBuilder<B extends DescriptionEscapeCodeAccessor.DescriptionEscapeCodeBuilder<B>>	Provides a builder method for a description Escape-Code property returning the builder for applying multiple build operations.
DescriptionEscapeCodeAccessor.DescriptionEscapeCodeMutator	Provides a mutator for a description Escape-Code property.
DescriptionEscapeCodeAccessor.DescriptionEscapeCodeProperty	Provides a description Escape-Code property.
Directive<T>	An Directive represents a command line operation with the according operation's operand (value).
DoubleDirective	The DoubleDirective represents a Directive holding double values.
DoubleOption	The DoubleOption represents an Option holding double values.
DoubleProperty	The DoubleProperty represents an Property holding double values.
EnumDirective<T extends Enum<T>>	The EnumDirective represents a Directive of enumeration types.
EnumOption<T extends Enum<T>>	The EnumOption represents an Option of enumeration types.
EnumProperty<T extends Enum<T>>	The EnumProperty represents an Property of enumeration types.
Example	An example usage item describing a usage scenario.
ExamplesAccessor	Provides an accessor for an Example instances property.
ExamplesAccessor.ExamplesBuilder<B extends ExamplesAccessor.ExamplesBuilder<B>>	Provides a builder method for an Example instances property returning the builder for applying multiple build operations.
ExamplesAccessor.ExamplesMutator	Provides a mutator for an Example instances property.
ExamplesAccessor.ExamplesProperty	Provides an Example instances property.
FileDirective	The FileDirective represents a Directive holding File values.
FileOption	The FileOption represents an Option holding File values.
FileProperty	The FileProperty represents an Property holding File values.
Flag	The Flag class implements the Option interface for representing either a true or a false state: When a flag is provided to your command line arguments, then it is considered to be true, when it is omitted, then it is considered to be false as of Flag.isEnabled().
FloatDirective	The FloatDirective represents a Directive holding float values.
FloatOption	The FloatOption represents an Option holding float values.
FloatProperty	The FloatProperty represents an Property holding float values.
ForceFlag	A predefined force Flag: A predefined Flag gives its ForceFlag.SHORT_OPTION, its ForceFlag.LONG_OPTION as well as its ForceFlag.ALIAS an according semantics regarded by other subsystems.
HelpFlag	A predefined help Flag: A predefined Flag gives its HelpFlag.SHORT_OPTION, its HelpFlag.LONG_OPTION as well as its HelpFlag.ALIAS an according semantics regarded by other subsystems.
InitFlag	A predefined init Flag: A predefined Flag gives its InitFlag.SHORT_OPTION, its InitFlag.LONG_OPTION as well as its InitFlag.ALIAS an according semantics regarded by other subsystems.
IntDirective	The IntDirective represents a Directive holding int values.
IntOption	The IntOption represents an Option holding int values.
IntProperty	The IntProperty represents an Property holding int values.
KeywordEscapeCodeAccessor	Provides an accessor for a keyword (e.g. short- and long-options) Escape-Code property.
KeywordEscapeCodeAccessor.KeywordEscapeCodeBuilder<B extends KeywordEscapeCodeAccessor.KeywordEscapeCodeBuilder<B>>	Provides a builder method for a keyword (e.g. short- and long-options) Escape-Code property returning the builder for applying multiple build operations.
KeywordEscapeCodeAccessor.KeywordEscapeCodeMutator	Provides a mutator for a keyword (e.g. short- and long-options) Escape-Code property.
KeywordEscapeCodeAccessor.KeywordEscapeCodeProperty	Provides a keyword (e.g. short- and long-options) Escape-Code property.
LicenseAccessor	Provides an accessor for a license property.
LicenseAccessor.LicenseBuilder<B extends LicenseAccessor.LicenseBuilder<B>>	Provides a builder method for a license property returning the builder for applying multiple build operations.
LicenseAccessor.LicenseMutator	Provides a mutator for a license property.
LicenseAccessor.LicenseProperty	Provides a license property.
LineSeparatorEscapeCodeAccessor	Provides an accessor for a line separator Escape-Code property.
LineSeparatorEscapeCodeAccessor.LineSeparatorEscapeCodeBuilder<B extends LineSeparatorEscapeCodeAccessor.LineSeparatorEscapeCodeBuilder<B>>	Provides a builder method for a line separator Escape-Code property returning the builder for applying multiple build operations.
LineSeparatorEscapeCodeAccessor.LineSeparatorEscapeCodeMutator	Provides a mutator for a line separator Escape-Code property.
LineSeparatorEscapeCodeAccessor.LineSeparatorEscapeCodeProperty	Provides a line separator Escape-Code property.
LongDirective	The LongDirective represents a Directive holding long values.
LongOption	The LongOption represents an Option holding long values.
LongOptionAccessor	Provides an accessor for a long option property.
LongOptionAccessor.LongOptionBuilder<B extends LongOptionAccessor.LongOptionBuilder<B>>	Provides a builder method for a long option property returning the builder for applying multiple build operations.
LongOptionAccessor.LongOptionMutator	Provides a mutator for a long option property.
LongOptionAccessor.LongOptionProperty	Provides a long option property.
LongOptionPrefixAccessor	Provides an accessor for a long option prefix property.
LongOptionPrefixAccessor.LongOptionPrefixBuilder<B extends LongOptionPrefixAccessor.LongOptionPrefixBuilder<B>>	Provides a builder method for a long option prefix property returning the builder for applying multiple build operations.
LongOptionPrefixAccessor.LongOptionPrefixMutator	Provides a mutator for a long option prefix property.
LongOptionPrefixAccessor.LongOptionPrefixProperty	Provides a long option prefix property.
LongProperty	The LongProperty represents an Property holding long values.
LongPropertyPrefixAccessor	Provides an accessor for a long option prefix property.
LongPropertyPrefixAccessor.LongPropertyPrefixBuilder<B extends LongPropertyPrefixAccessor.LongPropertyPrefixBuilder<B>>	Provides a builder method for a long option prefix property returning the builder for applying multiple build operations.
LongPropertyPrefixAccessor.LongPropertyPrefixMutator	Provides a mutator for a long option prefix property.
LongPropertyPrefixAccessor.LongPropertyPrefixProperty	Provides a long option prefix property.
MatchCountAccessor	Provides an accessor for a match-count property.
MatchCountAccessor.MatchCountBuilder<B extends MatchCountAccessor.MatchCountBuilder<B>>	Provides a builder method for a match-count property returning the builder for applying multiple build operations.
MatchCountAccessor.MatchCountMutator	Provides a mutator for a match-count property.
MatchCountAccessor.MatchCountProperty	Provides a match-count property.
NoneOperand	The NoneOperand represents an empty set of arguments, e.g. no command line argument is being passed.
Operand<T>	An Operand represents a value parsed from command line arguments.
Operation	The Operation is an argument representing an action of functioning or the fact of being active or in effect and is either provided (as command line argument) or not provided as of Operation.isEnabled().
OperationAccessor	Provides an accessor for a operation property.
OperationAccessor.OperationBuilder<B extends OperationAccessor.OperationBuilder<B>>	Provides a builder method for a operation property returning the builder for applying multiple build operations.
OperationAccessor.OperationMutator	Provides a mutator for a operation property.
OperationAccessor.OperationProperty	Provides a operation property.
Option<T>	An Option represents a command line option with the according option's value.
Optionable	Provides means to determine context specific information on Option instances.
OrCondition	An OrCondition represents a list of Condition (Term) instances of which at least one must be parsed successfully when the Term s' Term.parseArgs(String[], String[], CliContext) methods are invoked.
ParseArgsException	Thrown in case the provided command line arguments do not respect the required semantics or cannot be converted to the required type.
ParsedArgsAccessor	Provides an accessor for a command line arguments (short "args") array.
ParsedArgsAccessor.ParsedArgsMutator	Provides a mutator for a parsed args property.
ParsedArgsAccessor.ParsedArgsProperty	Provides a parsed args property.
ParseDirectiveArgsException	Thrown in case the provided command line arguments do not respect the required semantics or cannot be converted to the required type by a Directive (having an operation alongside an expected operand), e.g. the arguments were rejected as them did not work for the according syntax.
ParseOptionArgsException	Thrown in case the provided command line arguments do not respect the required semantics or cannot be converted to the required type by an Option (having a short- and/or a long-option), e.g. the arguments were rejected as them did not work for the according syntax.
Property<T>	An Property represents an option property with the according porperty's key and value separated by a = (and no whitespace inbetween).
PropertyEscapeCodeAccessor	Provides an accessor for a option Escape-Code property.
PropertyEscapeCodeAccessor.PropertyEscapeCodeBuilder<B extends PropertyEscapeCodeAccessor.PropertyEscapeCodeBuilder<B>>	Provides a builder method for a option Escape-Code property returning the builder for applying multiple build operations.
PropertyEscapeCodeAccessor.PropertyEscapeCodeMutator	Provides a mutator for a option Escape-Code property.
PropertyEscapeCodeAccessor.PropertyEscapeCodeProperty	Provides a option Escape-Code property.
QuietFlag	A predefined "be quiet" Flag: A predefined Flag gives its QuietFlag.SHORT_OPTION, its QuietFlag.LONG_OPTION as well as its QuietFlag.ALIAS an according semantics regarded by other subsystems.
ShortOptionAccessor	Provides an accessor for a short option property.
ShortOptionAccessor.ShortOptionBuilder<B extends ShortOptionAccessor.ShortOptionBuilder<B>>	Provides a builder method for a short option property returning the builder for applying multiple build operations.
ShortOptionAccessor.ShortOptionMutator	Provides a mutator for a short option property.
ShortOptionAccessor.ShortOptionProperty	Provides a short option property.
ShortOptionPrefixAccessor	Provides an accessor for a short option prefix property.
ShortOptionPrefixAccessor.ShortOptionPrefixBuilder<B extends ShortOptionPrefixAccessor.ShortOptionPrefixBuilder<B>>	Provides a builder method for a short option prefix property returning the builder for applying multiple build operations.
ShortOptionPrefixAccessor.ShortOptionPrefixMutator	Provides a mutator for a short option prefix property.
ShortOptionPrefixAccessor.ShortOptionPrefixProperty	Provides a short option prefix property.
ShortPropertyPrefixAccessor	Provides an accessor for a short option prefix property.
ShortPropertyPrefixAccessor.ShortPropertyPrefixBuilder<B extends ShortPropertyPrefixAccessor.ShortPropertyPrefixBuilder<B>>	Provides a builder method for a short option prefix property returning the builder for applying multiple build operations.
ShortPropertyPrefixAccessor.ShortPropertyPrefixMutator	Provides a mutator for a short option prefix property.
ShortPropertyPrefixAccessor.ShortPropertyPrefixProperty	Provides a short option prefix property.
StringDirective	The StringDirective represents a Directive holding String values.
StringOperand	An Operand (neither a short option nor a long option prepended nor being a flag) represents an argument of type String.
StringOption	The StringOption represents an Option holding String values.
StringProperty	The StringProperty represents an Property holding String values.
SuperfluousArgsException	Thrown in case there were arguments found not being used (superfluous arguments).
Synopsisable	The Synopsisable interface defines those methods required to create a human readable usage String similar to a manpage's synopsis from the implementing instance.
SyntaxMetrics	The SyntaxMetrics provides properties specific to a specific command line syntax notation.
SyntaxMetricsAccessor	Provides an accessor for a SyntaxMetrics property.
SyntaxMetricsAccessor.SyntaxMetricsBuilder<B extends SyntaxMetricsAccessor.SyntaxMetricsBuilder<B>>	Provides a builder method for a SyntaxMetrics property returning the builder for applying multiple build operations.
SyntaxMetricsAccessor.SyntaxMetricsMutator	Provides a mutator for a SyntaxMetrics property.
SyntaxMetricsAccessor.SyntaxMetricsProperty	Provides a SyntaxMetrics property.
SyntaxMetricsBuilder	The SyntaxMetricsBuilder class implements the SyntaxMetrics interface for building custom SyntaxMetrics instances.
SyntaxMetricsBuilder.Builder	Builder to build SyntaxMetrics instances.
SyntaxNotation	The SyntaxNotation is used by a the Term.toSyntax(CliContext) method to determine which notation to be used for the generated syntax.
SysInfoFlag	A predefined system information Flag: A predefined Flag gives its SysInfoFlag.SHORT_OPTION, its SysInfoFlag.LONG_OPTION as well as its SysInfoFlag.ALIAS an according semantics regarded by other subsystems..
Term	A Term represents a node within a command line argument syntax tree.
UnknownArgsException	Thrown in case command line arguments were not processed (did not match the expected arguments), e.g. the arguments were rejected as them did not work for the according syntax.
UnknownOperationArgsException	Thrown in case command line arguments were not processed (did not match the expected arguments) by an Option (having a short- and/or a long-option), e.g. the arguments were rejected as them did not work for the according syntax.
UnknownOptionArgsException	Thrown in case command line arguments were not processed (did not match the expected arguments) by an Option (having a short- and/or a long-option), e.g. the arguments were rejected as them did not work for the according syntax.
VerboseFlag	A predefined verbose Flag: A predefined Flag gives its VerboseFlag.SHORT_OPTION, its VerboseFlag.LONG_OPTION as well as its VerboseFlag.ALIAS an according semantics regarded by other subsystems.
XorCondition	An XorCondition represents a list of Condition (Term) instances of which only one is allowed to be parsed successfully when the Term.parseArgs(String[], String[], CliContext) methods are invoked.