Module org.refcodes.cli

Package org.refcodes.cli

Class ArgsParser

java.lang.Object

org.refcodes.cli.ArgsParser

All Implemented Interfaces:

ArgsParserBuilder<ParseArgs>, ArgsProcessorBuilder<ParseArgs>, ArgsSyntaxAccessor, ArgsSyntaxAccessor.ArgsSyntaxBuilder<ParseArgs>, ArgsSyntaxAccessor.ArgsSyntaxMutator, ArgsSyntaxAccessor.ArgsSyntaxProperty, ArgumentEscapeCodeAccessor, ArgumentEscapeCodeAccessor.ArgumentEscapeCodeBuilder<ParseArgs>, ArgumentEscapeCodeAccessor.ArgumentEscapeCodeMutator, ArgumentEscapeCodeAccessor.ArgumentEscapeCodeProperty, BannerBorderEscapeCodeAccessor, BannerBorderEscapeCodeAccessor.BannerBorderEscapeCodeBuilder<ParseArgs>, BannerBorderEscapeCodeAccessor.BannerBorderEscapeCodeMutator, BannerBorderEscapeCodeAccessor.BannerBorderEscapeCodeProperty, BannerEscapeCodeAccessor, BannerEscapeCodeAccessor.BannerEscapeCodeBuilder<ParseArgs>, BannerEscapeCodeAccessor.BannerEscapeCodeMutator, BannerEscapeCodeAccessor.BannerEscapeCodeProperty, BannerFontAccessor, BannerFontAccessor.BannerFontBuilder<ParseArgs>, BannerFontAccessor.BannerFontMutator, BannerFontAccessor.BannerFontProperty, BannerFontPaletteAccessor, BannerFontPaletteAccessor.BannerFontPaletteBuilder<ParseArgs>, BannerFontPaletteAccessor.BannerFontPaletteMutator, BannerFontPaletteAccessor.BannerFontPaletteProperty, CliMetrics, CommandEscapeCodeAccessor, CommandEscapeCodeAccessor.CommandEscapeCodeBuilder<ParseArgs>, CommandEscapeCodeAccessor.CommandEscapeCodeMutator, CommandEscapeCodeAccessor.CommandEscapeCodeProperty, CopyrightAccessor, CopyrightAccessor.CopyrightBuilder<ParseArgs>, CopyrightAccessor.CopyrightMutator, CopyrightAccessor.CopyrightProperty, DescriptionEscapeCodeAccessor, DescriptionEscapeCodeAccessor.DescriptionEscapeCodeBuilder<ParseArgs>, DescriptionEscapeCodeAccessor.DescriptionEscapeCodeMutator, DescriptionEscapeCodeAccessor.DescriptionEscapeCodeProperty, ExamplesAccessor, ExamplesAccessor.ExamplesBuilder<ParseArgs>, ExamplesAccessor.ExamplesMutator, ExamplesAccessor.ExamplesProperty, LicenseAccessor, LicenseAccessor.LicenseBuilder<ParseArgs>, LicenseAccessor.LicenseMutator, LicenseAccessor.LicenseProperty, LineSeparatorEscapeCodeAccessor, LineSeparatorEscapeCodeAccessor.LineSeparatorEscapeCodeBuilder<ParseArgs>, LineSeparatorEscapeCodeAccessor.LineSeparatorEscapeCodeMutator, LineSeparatorEscapeCodeAccessor.LineSeparatorEscapeCodeProperty, LongOptionPrefixAccessor, LongOptionPrefixAccessor.LongOptionPrefixBuilder<ParseArgs>, LongOptionPrefixAccessor.LongOptionPrefixMutator, LongOptionPrefixAccessor.LongOptionPrefixProperty, Optionable, OptionEscapeCodeAccessor, OptionEscapeCodeAccessor.OptionEscapeCodeBuilder<ParseArgs>, OptionEscapeCodeAccessor.OptionEscapeCodeMutator, OptionEscapeCodeAccessor.OptionEscapeCodeProperty, ParseArgs, ShortOptionPrefixAccessor, ShortOptionPrefixAccessor.ShortOptionPrefixBuilder<ParseArgs>, ShortOptionPrefixAccessor.ShortOptionPrefixMutator, ShortOptionPrefixAccessor.ShortOptionPrefixProperty, SyntaxMetricsAccessor, SyntaxMetricsAccessor.SyntaxMetricsBuilder<ParseArgs>, SyntaxMetricsAccessor.SyntaxMetricsMutator, SyntaxMetricsAccessor.SyntaxMetricsProperty, org.refcodes.mixin.ConsoleWidthAccessor, org.refcodes.mixin.ConsoleWidthAccessor.ConsoleWidthBuilder<ParseArgs>, org.refcodes.mixin.ConsoleWidthAccessor.ConsoleWidthMutator, org.refcodes.mixin.ConsoleWidthAccessor.ConsoleWidthProperty, org.refcodes.mixin.DescriptionAccessor, org.refcodes.mixin.DescriptionAccessor.DescriptionBuilder<ParseArgs>, org.refcodes.mixin.DescriptionAccessor.DescriptionMutator, org.refcodes.mixin.DescriptionAccessor.DescriptionProperty, org.refcodes.mixin.EscapeCodesStatusAccessor, org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusBuilder<ParseArgs>, org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusMutator, org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusProperty, org.refcodes.mixin.LineBreakAccessor, org.refcodes.mixin.LineBreakAccessor.LineBreakBuilder<ParseArgs>, org.refcodes.mixin.LineBreakAccessor.LineBreakMutator, org.refcodes.mixin.LineBreakAccessor.LineBreakProperty, org.refcodes.mixin.MaxConsoleWidthAccessor, org.refcodes.mixin.MaxConsoleWidthAccessor.MaxConsoleWidthBuilder<ParseArgs>, org.refcodes.mixin.MaxConsoleWidthAccessor.MaxConsoleWidthMutator, org.refcodes.mixin.MaxConsoleWidthAccessor.MaxConsoleWidthProperty, org.refcodes.mixin.NameAccessor, org.refcodes.mixin.NameAccessor.NameBuilder<ParseArgs>, org.refcodes.mixin.NameAccessor.NameMutator, org.refcodes.mixin.NameAccessor.NameProperty, org.refcodes.mixin.Resetable, org.refcodes.mixin.ResetEscapeCodeAccessor, org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeBuilder<ParseArgs>, org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeMutator, org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeProperty, org.refcodes.mixin.Schemable, org.refcodes.mixin.TitleAccessor, org.refcodes.mixin.TitleAccessor.TitleBuilder<ParseArgs>, org.refcodes.mixin.TitleAccessor.TitleMutator, org.refcodes.mixin.TitleAccessor.TitleProperty, org.refcodes.textual.TextBoxGridAccessor, org.refcodes.textual.TextBoxGridAccessor.TextBoxGridBuilder<ParseArgs>, org.refcodes.textual.TextBoxGridAccessor.TextBoxGridMutator, org.refcodes.textual.TextBoxGridAccessor.TextBoxGridProperty

public class ArgsParser
extends Object
implements ParseArgs

A straightforward implementation of the ParseArgs interface. The constructor only provides means to set the required attributes as the attributes to be adjusted optionally are already sufficiently preconfigured. For adjusting them, a flavor of the Builder-Pattern is provided with which you can easily chain the configuration of this instance; as them methods return the instance of this class being configured. This helps to prevent the telescoping constructor anti-pattern.

The SyntaxNotation is pre-set with the SyntaxNotation.LOGICAL notation.

The console width id preconfigured with the console's width as determined by the SystemUtility.getTerminalWidth().

The standard out PrintStream is preconfigured with the System.out PrintStream.

The newline characters to be used for line breaks is "\r\n" on Windows machines and "\"n" on all other machines as of the SystemUtility.getLineBreak().

See Also:

• "http://en.wikipedia.org/wiki/Builder_pattern"

Nested Class Summary

Nested classes/interfaces inherited from interface org.refcodes.cli.ArgsSyntaxAccessor

ArgsSyntaxAccessor.ArgsSyntaxBuilder<B extends ArgsSyntaxAccessor.ArgsSyntaxBuilder<B>>, ArgsSyntaxAccessor.ArgsSyntaxMutator, ArgsSyntaxAccessor.ArgsSyntaxProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.ArgumentEscapeCodeAccessor

ArgumentEscapeCodeAccessor.ArgumentEscapeCodeBuilder<B extends ArgumentEscapeCodeAccessor.ArgumentEscapeCodeBuilder<B>>, ArgumentEscapeCodeAccessor.ArgumentEscapeCodeMutator, ArgumentEscapeCodeAccessor.ArgumentEscapeCodeProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.BannerBorderEscapeCodeAccessor

BannerBorderEscapeCodeAccessor.BannerBorderEscapeCodeBuilder<B extends BannerBorderEscapeCodeAccessor.BannerBorderEscapeCodeBuilder<B>>, BannerBorderEscapeCodeAccessor.BannerBorderEscapeCodeMutator, BannerBorderEscapeCodeAccessor.BannerBorderEscapeCodeProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.BannerEscapeCodeAccessor

BannerEscapeCodeAccessor.BannerEscapeCodeBuilder<B extends BannerEscapeCodeAccessor.BannerEscapeCodeBuilder<B>>, BannerEscapeCodeAccessor.BannerEscapeCodeMutator, BannerEscapeCodeAccessor.BannerEscapeCodeProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.BannerFontAccessor

BannerFontAccessor.BannerFontBuilder<B extends BannerFontAccessor.BannerFontBuilder<B>>, BannerFontAccessor.BannerFontMutator, BannerFontAccessor.BannerFontProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.BannerFontPaletteAccessor

BannerFontPaletteAccessor.BannerFontPaletteBuilder<B extends BannerFontPaletteAccessor.BannerFontPaletteBuilder<B>>, BannerFontPaletteAccessor.BannerFontPaletteMutator, BannerFontPaletteAccessor.BannerFontPaletteProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.CommandEscapeCodeAccessor

CommandEscapeCodeAccessor.CommandEscapeCodeBuilder<B extends CommandEscapeCodeAccessor.CommandEscapeCodeBuilder<B>>, CommandEscapeCodeAccessor.CommandEscapeCodeMutator, CommandEscapeCodeAccessor.CommandEscapeCodeProperty

Nested classes/interfaces inherited from interface org.refcodes.mixin.ConsoleWidthAccessor

org.refcodes.mixin.ConsoleWidthAccessor.ConsoleWidthBuilder<B extends org.refcodes.mixin.ConsoleWidthAccessor.ConsoleWidthBuilder<B>>, org.refcodes.mixin.ConsoleWidthAccessor.ConsoleWidthMutator, org.refcodes.mixin.ConsoleWidthAccessor.ConsoleWidthProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.CopyrightAccessor

CopyrightAccessor.CopyrightBuilder<B extends CopyrightAccessor.CopyrightBuilder<B>>, CopyrightAccessor.CopyrightMutator, CopyrightAccessor.CopyrightProperty

Nested classes/interfaces inherited from interface org.refcodes.mixin.DescriptionAccessor

org.refcodes.mixin.DescriptionAccessor.DescriptionBuilder<B extends org.refcodes.mixin.DescriptionAccessor.DescriptionBuilder<B>>, org.refcodes.mixin.DescriptionAccessor.DescriptionMutator, org.refcodes.mixin.DescriptionAccessor.DescriptionProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.DescriptionEscapeCodeAccessor

DescriptionEscapeCodeAccessor.DescriptionEscapeCodeBuilder<B extends DescriptionEscapeCodeAccessor.DescriptionEscapeCodeBuilder<B>>, DescriptionEscapeCodeAccessor.DescriptionEscapeCodeMutator, DescriptionEscapeCodeAccessor.DescriptionEscapeCodeProperty

Nested classes/interfaces inherited from interface org.refcodes.mixin.EscapeCodesStatusAccessor

org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusBuilder<B extends org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusBuilder<B>>, org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusMutator, org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.ExamplesAccessor

ExamplesAccessor.ExamplesBuilder<B extends ExamplesAccessor.ExamplesBuilder<B>>, ExamplesAccessor.ExamplesMutator, ExamplesAccessor.ExamplesProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.LicenseAccessor

LicenseAccessor.LicenseBuilder<B extends LicenseAccessor.LicenseBuilder<B>>, LicenseAccessor.LicenseMutator, LicenseAccessor.LicenseProperty

Nested classes/interfaces inherited from interface org.refcodes.mixin.LineBreakAccessor

org.refcodes.mixin.LineBreakAccessor.LineBreakBuilder<B extends org.refcodes.mixin.LineBreakAccessor.LineBreakBuilder<B>>, org.refcodes.mixin.LineBreakAccessor.LineBreakMutator, org.refcodes.mixin.LineBreakAccessor.LineBreakProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.LineSeparatorEscapeCodeAccessor

LineSeparatorEscapeCodeAccessor.LineSeparatorEscapeCodeBuilder<B extends LineSeparatorEscapeCodeAccessor.LineSeparatorEscapeCodeBuilder<B>>, LineSeparatorEscapeCodeAccessor.LineSeparatorEscapeCodeMutator, LineSeparatorEscapeCodeAccessor.LineSeparatorEscapeCodeProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.LongOptionPrefixAccessor

LongOptionPrefixAccessor.LongOptionPrefixBuilder<B extends LongOptionPrefixAccessor.LongOptionPrefixBuilder<B>>, LongOptionPrefixAccessor.LongOptionPrefixMutator, LongOptionPrefixAccessor.LongOptionPrefixProperty

Nested classes/interfaces inherited from interface org.refcodes.mixin.MaxConsoleWidthAccessor

org.refcodes.mixin.MaxConsoleWidthAccessor.MaxConsoleWidthBuilder<B extends org.refcodes.mixin.MaxConsoleWidthAccessor.MaxConsoleWidthBuilder<B>>, org.refcodes.mixin.MaxConsoleWidthAccessor.MaxConsoleWidthMutator, org.refcodes.mixin.MaxConsoleWidthAccessor.MaxConsoleWidthProperty

Nested classes/interfaces inherited from interface org.refcodes.mixin.NameAccessor

org.refcodes.mixin.NameAccessor.NameBuilder<B extends org.refcodes.mixin.NameAccessor.NameBuilder<B>>, org.refcodes.mixin.NameAccessor.NameMutator, org.refcodes.mixin.NameAccessor.NameProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.OptionEscapeCodeAccessor

OptionEscapeCodeAccessor.OptionEscapeCodeBuilder<B extends OptionEscapeCodeAccessor.OptionEscapeCodeBuilder<B>>, OptionEscapeCodeAccessor.OptionEscapeCodeMutator, OptionEscapeCodeAccessor.OptionEscapeCodeProperty

Nested classes/interfaces inherited from interface org.refcodes.mixin.ResetEscapeCodeAccessor

org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeBuilder<B extends org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeBuilder<B>>, org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeMutator, org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.ShortOptionPrefixAccessor

ShortOptionPrefixAccessor.ShortOptionPrefixBuilder<B extends ShortOptionPrefixAccessor.ShortOptionPrefixBuilder<B>>, ShortOptionPrefixAccessor.ShortOptionPrefixMutator, ShortOptionPrefixAccessor.ShortOptionPrefixProperty

Nested classes/interfaces inherited from interface org.refcodes.cli.SyntaxMetricsAccessor

SyntaxMetricsAccessor.SyntaxMetricsBuilder<B extends SyntaxMetricsAccessor.SyntaxMetricsBuilder<B>>, SyntaxMetricsAccessor.SyntaxMetricsMutator, SyntaxMetricsAccessor.SyntaxMetricsProperty

Nested classes/interfaces inherited from interface org.refcodes.textual.TextBoxGridAccessor

org.refcodes.textual.TextBoxGridAccessor.TextBoxGridBuilder<B extends org.refcodes.textual.TextBoxGridAccessor.TextBoxGridBuilder<?>>, org.refcodes.textual.TextBoxGridAccessor.TextBoxGridMutator, org.refcodes.textual.TextBoxGridAccessor.TextBoxGridProperty

Nested classes/interfaces inherited from interface org.refcodes.mixin.TitleAccessor

org.refcodes.mixin.TitleAccessor.TitleBuilder<B extends org.refcodes.mixin.TitleAccessor.TitleBuilder<B>>, org.refcodes.mixin.TitleAccessor.TitleMutator, org.refcodes.mixin.TitleAccessor.TitleProperty

Field Summary

Fields

Modifier and Type	Field	Description
protected PrintStream	_errStream
protected PrintStream	_stdStream

Constructor Summary

Constructors

Constructor	Description
ArgsParser()	Constructs the ParseArgs instance without any restrictions to the parsed arguments.
ArgsParser(CliContext aCliCtx)	Constructs the ParseArgs instance without any restrictions to the parsed arguments.
ArgsParser(Term aArgsSyntax)	Constructs the ParseArgs instance with the given root Condition and the default SyntaxNotation.LOGICAL.
ArgsParser(Term aArgsSyntax, CliContext aCliCtx)	Constructs the ParseArgs instance with the given root Condition and the default SyntaxNotation.LOGICAL.

Method Summary

Modifier and Type	Method	Description
void	addExample(Example aExampleUsage)	Adds a usage example by providing a description of the example and the command line arguments required by the example.
void	errorLn(String aLine)	Prints the given line to standard error with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.
Operand<?>[]	evalArgs(String[] aArgs)	Evaluates the provided command line arguments and determines the according values by evaluating the root Condition.
Term	getArgsSyntax()	Retrieves the (root) Term from the (root) Term property.
String	getArgumentEscapeCode()	Retrieves the argument Escape-Code from the argument Escape-Code property.
String	getBannerBorderEscapeCode()	Retrieves the banner border Escape-Code from the banner border Escape-Code property.
String	getBannerEscapeCode()	Retrieves the banner Escape-Code from the banner Escape-Code property.
org.refcodes.textual.Font	getBannerFont()	Retrieves the banner Font from the banner Font property.
char[]	getBannerFontPalette()	Retrieves the banner font palette from the banner font palette property.
String	getCommandEscapeCode()	Retrieves the command Escape-Code from the command Escape-Code property.
int	getConsoleWidth()
String	getCopyright()	Retrieves the copyright from the copyright property.
protected char	getDelimiter()	The delimiter to be used for colliding command line args when creating non colliding arg's aliases (keys for key/value-pairs).
String	getDescription()
String	getDescriptionEscapeCode()	Retrieves the description Escape-Code from the description Escape-Code property.
Example[]	getExamples()	Retrieves the Example instances from the Example instances property.
String	getLicense()	Retrieves the license from the license property.
String	getLineBreak()
String	getLineSeparatorEscapeCode()	Retrieves the line separator Escape-Code from the line separator Escape-Code property.
String	getLongOptionPrefix()	Retrieves the long option prefix from the long option prefix property.
int	getMaxConsoleWidth()
String	getName()
String	getOptionEscapeCode()	Retrieves the option Escape-Code from the option Escape-Code property.
String	getResetEscapeCode()
char	getSeparatorLnChar()	Gets the character to be used when printing a separator line with the ParseArgs.printSeparatorLn() method.
Character	getShortOptionPrefix()	Retrieves the short option prefix from the short option prefix property.
SyntaxMetrics	getSyntaxMetrics()	Retrieves the SyntaxMetrics from the SyntaxMetrics property.
org.refcodes.textual.TextBoxGrid	getTextBoxGrid()
String	getTitle()
boolean	isEscapeCodesEnabled()
void	printBanner()	Prints the banner; the banner most probably is an ASCII_HEADER_ASCII_BODY art text block which's look depends strongly on the taste of the author implementing this interface.
void	printCopyright()	Prints the copyright note as specified by the ParseArgs.withCopyright(String) method; with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.
void	printDescription()	Prints the description as set by the ParseArgs.withDescription(String) method with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.
void	printExamples()	Prints example usages as as added by the ParseArgs.addExample(String, Operand...) method with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.
void	printHeader()	Prints the header, which might be a simplified banner: Can be used when overriding methods such as ParseArgs.printHelp() or ParseArgs.printBanner().
void	printLicense()	Prints the license note as specified by the ParseArgs.withLicense(String) method; with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.
void	printLn()	Prints an empty line / a line break.
void	printLn(String aLine)	Prints the given line to standard out with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.
void	printOptions()	Prints the Options (short- and the long-options), the Flages and the Operand and their description with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.
void	printSeparatorLn()	Prints a separator line using the separator character as specified by the ParseArgs.withSeparatorLnChar(char) method; with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.
void	printSynopsis()	Prints the syntax as retrieved by the root Condition element as of Synopsisable.toSynopsis(SyntaxNotation) with regards to the SyntaxNotation set by the ParseArgs.withSyntaxMetrics(SyntaxMetrics) method.
void	reset()
void	setArgsSyntax(Term aArgsSyntax)	Sets the (root) Term for the (root) Term property.
void	setArgumentEscapeCode(String aParamEscapeCode)	Sets the argument Escape-Code for the argument Escape-Code property.
void	setBannerBorderEscapeCode(String aBannerBorderEscapeCode)	Sets the banner border Escape-Code for the banner border Escape-Code property.
void	setBannerEscapeCode(String aBannerEscapeCode)	Sets the banner Escape-Code for the banner Escape-Code property.
void	setBannerFont(org.refcodes.textual.Font aBannerFont)	Sets the banner Font for the banner Font property.
void	setBannerFontPalette(char[] aColorPalette)	Sets the banner font palette for the banner font palette property.
void	setBannerFontPalette(org.refcodes.data.AsciiColorPalette aBannerFontPalette)	Sets the banner font palette for the banner font palette property.
void	setCommandEscapeCode(String aCommandEscapeCode)	Sets the command Escape-Code for the command Escape-Code property.
void	setConsoleWidth(int aConsoleWidth)
void	setCopyright(String aCopyrightNote)	Sets the copyright for the copyright property.
void	setDescription(String aDescription)
void	setDescriptionEscapeCode(String aDescriptionEscapeCode)	Sets the description Escape-Code for the description Escape-Code property.
void	setErrorOut(PrintStream aErrorOut)	Set the error out PrintStream and make other adjustments with the result (with regards to the Builder-Pattern).
void	setEscapeCodesEnabled(boolean isEscapeCodesEnabled)
void	setExamples(Example[] aExamples)	Sets the Example instances for the Example instances property.
void	setLicense(String aLicenseNote)	Sets the license for the license property.
void	setLineBreak(String aLineBreak)
void	setLineSeparatorEscapeCode(String aLineSeparatorEscapeCode)	Sets the line separator Escape-Code for the line separator Escape-Code property.
void	setLongOptionPrefix(String aLongOptionPrefix)	Sets the long option prefix for the long option prefix property.
void	setMaxConsoleWidth(int aMaxConsoleWidth)
void	setName(String aName)
void	setOptionEscapeCode(String aOptEscapeCode)	Sets the option Escape-Code for the option Escape-Code property.
void	setResetEscapeCode(String aResetEscapeCode)
void	setSeparatorLnChar(char aSeparatorLnChar)	Set the character to be used when printing a separator line with the ParseArgs.printSeparatorLn() method.
void	setShortOptionPrefix(Character aShortOptionPrefix)	Sets the short option prefix for the short option prefix property.
void	setStandardOut(PrintStream aStandardOut)	Set the standard out PrintStream and make other adjustments with the result (with regards to the Builder-Pattern).
void	setSyntaxMetrics(SyntaxMetrics aSyntaxMetrics)	Sets the SyntaxMetrics for the SyntaxMetrics property.
void	setTextBoxGrid(org.refcodes.textual.TextBoxGrid aTextBoxGrid)
void	setTitle(String aTitle)
ArgsParser	withAddExample(String aDescription, Operand<?>... aOperands)	Builder method adding an application's Example element.
ArgsParser	withAddExample(Example aExamples)	Builder method adding an application's Example element.
ArgsParser	withArgsSyntax(Term aArgsSyntax)	Sets the (root) Term for the (root) Term property.
ArgsParser	withArgumentEscapeCode(String aParamEscCode)	Sets the argument Escape-Code for the argument Escape-Code property.
ArgsParser	withBannerBorderEscapeCode(String aBannerBorderEscCode)	Sets the banner border Escape-Code for the banner border Escape-Code property.
ArgsParser	withBannerEscapeCode(String aBannerEscCode)	Sets the banner Escape-Code for the banner Escape-Code property.
ArgsParser	withBannerFont(org.refcodes.textual.Font aBannerFont)	Sets the banner Font for the banner Font property.
ArgsParser	withBannerFontPalette(char[] aColorPalette)	Sets the banner font palette for the banner font palette property.
ArgsParser	withBannerFontPalette(org.refcodes.data.AsciiColorPalette aBannerFontPalette)	Sets the banner font palette for the banner font palette property.
ArgsParser	withCommandEscapeCode(String aCommandEscCode)	Sets the command Escape-Code for the command Escape-Code property.
ArgsParser	withConsoleWidth(int aConsoleWidth)
ArgsParser	withCopyright(String aCopyright)	Sets the copyright for the copyright property.
ArgsParser	withDescription(String aDescription)
ArgsParser	withDescriptionEscapeCode(String aDescriptionEscCode)	Sets the description Escape-Code for the description Escape-Code property.
ArgsParser	withErrorOut(PrintStream aErrorOut)	Set the error out PrintStream and make other adjustments with the result (with regards to the Builder-Pattern).
ArgsParser	withEscapeCodesEnabled(boolean aIsEscCodeEnabled)
ArgsParser	withEvalArgs(String[] aArgs)	Evaluates the provided command line arguments.
ArgsParser	withEvalArgs(String[] aArgs, Pattern aFilterExp)	Evaluates the provided command line arguments, filtering (excluding) the arguments matching the provided Pattern.
ArgsParser	withEvalArgs(String[] aArgs, ArgsFilter aArgsFilter)	Evaluates the provided command line arguments, filtering (excluding) the arguments matching the provided ArgsFilter.
ArgsParser	withEvalArgs(List<String> aArgs)	Evaluates the provided command line arguments .
ArgsParser	withEvalArgs(List<String> aArgs, Pattern aFilterExp)	Evaluates the provided command line arguments, filtering (excluding) the arguments matching the provided Pattern.
ArgsParser	withEvalArgs(List<String> aArgs, ArgsFilter aArgsFilter)	Evaluates the provided command line arguments, filtering (excluding) the arguments matching the provided ArgsFilter.
ArgsParser	withExamples(Collection<Example> aExamples)	Builder method providing the application's Example elements.
ArgsParser	withExamples(Example[] aExamples)	Sets the Example instances for the Example instances property.
ArgsParser	withLicense(String aLicense)	Sets the license for the license property.
ArgsParser	withLineBreak(String aLineBreak)
ArgsParser	withLineSeparatorEscapeCode(String aLineSeparatorEscCode)	Sets the line separator Escape-Code for the line separator Escape-Code property.
ArgsParser	withLongOptionPrefix(String aLongOptionPrefix)	Sets the long option prefix for the long option prefix property.
ArgsParser	withMaxConsoleWidth(int aMaxConsoleWidth)
ArgsParser	withName(String aName)
ArgsParser	withOptionEscapeCode(String aOptEscCode)	Sets the option Escape-Code for the option Escape-Code property.
ArgsParser	withResetEscapeCode(String aResetEscCode)
ArgsParser	withSeparatorLnChar(char aSeparatorLnChar)	Builder method adding an separator line char.
ArgsParser	withShortOptionPrefix(Character aShortOptionPrefix)	Sets the short option prefix for the short option prefix property.
ArgsParser	withStandardOut(PrintStream aStandardOut)	Set the standard out PrintStream and make other adjustments with the result (with regards to the Builder-Pattern).
ArgsParser	withSyntaxMetrics(SyntaxMetrics aSyntaxMetrics)	Sets the SyntaxMetrics for the SyntaxMetrics property.
ArgsParser	withSyntaxMetrics(SyntaxNotation aSyntaxNotation)	Sets the SyntaxNotation for the SyntaxNotation property.
ArgsParser	withTextBoxGrid(org.refcodes.textual.TextBoxGrid aTextBoxGrid)
ArgsParser	withTextBoxGrid(org.refcodes.textual.TextBoxStyle aTextBoxStyle)
ArgsParser	withTitle(String aTitle)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.refcodes.cli.ArgsSyntaxAccessor.ArgsSyntaxProperty

letArgsSyntax

Methods inherited from interface org.refcodes.cli.ArgumentEscapeCodeAccessor.ArgumentEscapeCodeProperty

letArgumentEscapeCode

Methods inherited from interface org.refcodes.cli.BannerBorderEscapeCodeAccessor.BannerBorderEscapeCodeProperty

letBannerBorderEscapeCode

Methods inherited from interface org.refcodes.cli.BannerEscapeCodeAccessor.BannerEscapeCodeProperty

letBannerEscapeCode

Methods inherited from interface org.refcodes.cli.BannerFontAccessor.BannerFontProperty

letBannerFont

Methods inherited from interface org.refcodes.cli.BannerFontPaletteAccessor.BannerFontPaletteProperty

letBannerFontPalette

Methods inherited from interface org.refcodes.cli.CommandEscapeCodeAccessor.CommandEscapeCodeProperty

letCommandEscapeCode

Methods inherited from interface org.refcodes.mixin.ConsoleWidthAccessor.ConsoleWidthProperty

letConsoleWidth

Methods inherited from interface org.refcodes.cli.CopyrightAccessor.CopyrightProperty

letCopyright

Methods inherited from interface org.refcodes.mixin.DescriptionAccessor.DescriptionProperty

letDescription

Methods inherited from interface org.refcodes.cli.DescriptionEscapeCodeAccessor.DescriptionEscapeCodeProperty

letDescriptionEscapeCode

Methods inherited from interface org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusProperty

letEscapeCodesEnabled

Methods inherited from interface org.refcodes.cli.ExamplesAccessor.ExamplesMutator

setExamples

Methods inherited from interface org.refcodes.cli.ExamplesAccessor.ExamplesProperty

letExamples

Methods inherited from interface org.refcodes.cli.LicenseAccessor.LicenseProperty

letLicense

Methods inherited from interface org.refcodes.mixin.LineBreakAccessor.LineBreakProperty

letLineBreak

Methods inherited from interface org.refcodes.cli.LineSeparatorEscapeCodeAccessor.LineSeparatorEscapeCodeProperty

letLineSeparatorEscapeCode

Methods inherited from interface org.refcodes.cli.LongOptionPrefixAccessor.LongOptionPrefixProperty

letLongOptionPrefix

Methods inherited from interface org.refcodes.mixin.MaxConsoleWidthAccessor.MaxConsoleWidthProperty

letMaxConsoleWidth

Methods inherited from interface org.refcodes.mixin.NameAccessor.NameProperty

letName

Methods inherited from interface org.refcodes.cli.OptionEscapeCodeAccessor.OptionEscapeCodeProperty

letOptionEscapeCode

Methods inherited from interface org.refcodes.cli.ParseArgs

addExample, evalArgs, evalArgs, evalArgs, evalArgs, evalArgs, printBody, printHelp, toOptions, toSchema

Methods inherited from interface org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeProperty

letResetEscapeCode

Methods inherited from interface org.refcodes.cli.ShortOptionPrefixAccessor.ShortOptionPrefixProperty

letShortOptionPrefix

Methods inherited from interface org.refcodes.cli.SyntaxMetricsAccessor.SyntaxMetricsMutator

setSyntaxMetrics

Methods inherited from interface org.refcodes.cli.SyntaxMetricsAccessor.SyntaxMetricsProperty

letSyntaxMetrics, letSyntaxMetrics

Methods inherited from interface org.refcodes.textual.TextBoxGridAccessor.TextBoxGridMutator

setTextBoxGrid

Methods inherited from interface org.refcodes.textual.TextBoxGridAccessor.TextBoxGridProperty

letTextBoxGrid, letTextBoxGrid

Methods inherited from interface org.refcodes.mixin.TitleAccessor.TitleProperty

letTitle

Field Details

_errStream

protected PrintStream _errStream

_stdStream

protected PrintStream _stdStream

Constructor Details

ArgsParser

public ArgsParser()

Constructs the ParseArgs instance without any restrictions to the parsed arguments. The constructor only provides means to set the required attributes as the attributes to be adjusted optionally are already sufficiently preconfigured. For adjusting them, a flavor of the Builder-Pattern is provided with which you can easily chain the configuration of this instance; as them methods return the instance of this class being configured.

ArgsParser

public ArgsParser(CliContext aCliCtx)

Constructs the ParseArgs instance without any restrictions to the parsed arguments. The constructor only provides means to set the required attributes as the attributes to be adjusted optionally are already sufficiently preconfigured. For adjusting them, a flavor of the Builder-Pattern is provided with which you can easily chain the configuration of this instance; as them methods return the instance of this class being configured.

Parameters:

aCliCtx - The CliContext to be used for initializing.

ArgsParser

public ArgsParser(Term aArgsSyntax)

Constructs the ParseArgs instance with the given root Condition and the default SyntaxNotation.LOGICAL. The constructor only provides means to set the required attributes as the attributes to be adjusted optionally are already sufficiently preconfigured. For adjusting them, a flavor of the Builder-Pattern is provided with which you can easily chain the configuration of this instance; as them methods return the instance of this class being configured.

Parameters:

aArgsSyntax - The args syntax root Term node being the node from which parsing the command line arguments starts.

ArgsParser

public ArgsParser(Term aArgsSyntax,
 CliContext aCliCtx)

Constructs the ParseArgs instance with the given root Condition and the default SyntaxNotation.LOGICAL. The constructor only provides means to set the required attributes as the attributes to be adjusted optionally are already sufficiently preconfigured. For adjusting them, a flavor of the Builder-Pattern is provided with which you can easily chain the configuration of this instance; as them methods return the instance of this class being configured.

Parameters:

aArgsSyntax - The args syntax root Term node being the node from which parsing the command line arguments starts.

aCliCtx - The CliContext to be used for initializing.

Method Details

addExample

public void addExample(Example aExampleUsage)

Adds a usage example by providing a description of the example and the command line arguments required by the example.

Specified by:

addExample in interface ParseArgs

Parameters:

aExampleUsage - The description as well as the command line arguments used by the example.

errorLn

public void errorLn(String aLine)

Prints the given line to standard error with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.

Specified by:

errorLn in interface ParseArgs

Parameters:

aLine - The line to be printed.

evalArgs

public Operand<?>[] evalArgs(String[] aArgs)
                      throws ArgsSyntaxException

Evaluates the provided command line arguments and determines the according values by evaluating the root Condition. In case of parsing failure, an according exception is thrown. ATTENTION: This method tests(!) for superfluous command line arguments being passed; e.g. command line arguments not being evaluated by any of the Term instance being traversed starting at the root Condition will be reported. Business logic therefore should invoke this root node's ParseArgs.evalArgs(String[]) method instead of a Condition's Term.parseArgs(String[], String[], CliContext) method; as ignoring superfluous command line arguments will aCause unexpected behavior from the point of view of the invoker.

Specified by:

evalArgs in interface ParseArgs

Parameters:

aArgs - The command line arguments to be evaluated.

Returns:

The list of evaluated command line arguments being instances of the Operand interfaces or its sub-types. In case an Operand implements the Approvable interface or inherits from the AbstractOperand type, then the Operand is also approved by invoking Approvable.approve() or AbstractOperand.approve() (which may trigger a registered lambda expression).

Throws:

ArgsSyntaxException - thrown in case of a command line arguments mismatch regarding provided and expected args.

getArgsSyntax

public Term getArgsSyntax()

Retrieves the (root) Term from the (root) Term property.

Specified by:

getArgsSyntax in interface ArgsSyntaxAccessor

Specified by:

getArgsSyntax in interface ParseArgs

Returns:

The (root) Term stored by the (root) Term property.

getArgumentEscapeCode

public String getArgumentEscapeCode()

Retrieves the argument Escape-Code from the argument Escape-Code property.

Specified by:

getArgumentEscapeCode in interface ArgumentEscapeCodeAccessor

Specified by:

getArgumentEscapeCode in interface ParseArgs

Returns:

The argument Escape-Code stored by the argument Escape-Code property.

getBannerBorderEscapeCode

public String getBannerBorderEscapeCode()

Retrieves the banner border Escape-Code from the banner border Escape-Code property.

Specified by:

getBannerBorderEscapeCode in interface BannerBorderEscapeCodeAccessor

Specified by:

getBannerBorderEscapeCode in interface ParseArgs

Returns:

The banner border Escape-Code stored by the banner border Escape-Code property.

getBannerEscapeCode

public String getBannerEscapeCode()

Retrieves the banner Escape-Code from the banner Escape-Code property.

Specified by:

getBannerEscapeCode in interface BannerEscapeCodeAccessor

Specified by:

getBannerEscapeCode in interface ParseArgs

Returns:

The banner Escape-Code stored by the banner Escape-Code property.

getBannerFont

public org.refcodes.textual.Font getBannerFont()

Retrieves the banner Font from the banner Font property.

Specified by:

getBannerFont in interface BannerFontAccessor

Returns:

The banner Font stored by the banner Font property.

getBannerFontPalette

public char[] getBannerFontPalette()

Retrieves the banner font palette from the banner font palette property.

Specified by:

getBannerFontPalette in interface BannerFontPaletteAccessor

Returns:

The banner font palette stored by the banner font palette property.

getCommandEscapeCode

public String getCommandEscapeCode()

Retrieves the command Escape-Code from the command Escape-Code property.

Specified by:

getCommandEscapeCode in interface CommandEscapeCodeAccessor

Specified by:

getCommandEscapeCode in interface ParseArgs

Returns:

The command Escape-Code stored by the command Escape-Code property.

getConsoleWidth

public int getConsoleWidth()

Specified by:

getConsoleWidth in interface org.refcodes.mixin.ConsoleWidthAccessor

getCopyright

public String getCopyright()

Retrieves the copyright from the copyright property.

Specified by:

getCopyright in interface CopyrightAccessor

Specified by:

getCopyright in interface ParseArgs

Returns:

The copyright stored by the copyright property.

getDescription

public String getDescription()

Specified by:

getDescription in interface org.refcodes.mixin.DescriptionAccessor

Specified by:

getDescription in interface ParseArgs

getDescriptionEscapeCode

public String getDescriptionEscapeCode()

Retrieves the description Escape-Code from the description Escape-Code property.

Specified by:

getDescriptionEscapeCode in interface DescriptionEscapeCodeAccessor

Specified by:

getDescriptionEscapeCode in interface ParseArgs

Returns:

The description Escape-Code stored by the description Escape-Code property.

getExamples

public Example[] getExamples()

Retrieves the Example instances from the Example instances property.

Specified by:

getExamples in interface ExamplesAccessor

Specified by:

getExamples in interface ParseArgs

Returns:

The Example instances stored by the Example instances property.

getLicense

public String getLicense()

Retrieves the license from the license property.

Specified by:

getLicense in interface LicenseAccessor

Specified by:

getLicense in interface ParseArgs

Returns:

The license stored by the license property.

getLineBreak

public String getLineBreak()

Specified by:

getLineBreak in interface org.refcodes.mixin.LineBreakAccessor

getLineSeparatorEscapeCode

public String getLineSeparatorEscapeCode()

Retrieves the line separator Escape-Code from the line separator Escape-Code property.

Specified by:

getLineSeparatorEscapeCode in interface LineSeparatorEscapeCodeAccessor

Specified by:

getLineSeparatorEscapeCode in interface ParseArgs

Returns:

The line separator Escape-Code stored by the line separator Escape-Code property.

getLongOptionPrefix

public String getLongOptionPrefix()

Retrieves the long option prefix from the long option prefix property.

Specified by:

getLongOptionPrefix in interface LongOptionPrefixAccessor

Returns:

The long option prefix stored by the long option prefix property.

getMaxConsoleWidth

public int getMaxConsoleWidth()

Specified by:

getMaxConsoleWidth in interface org.refcodes.mixin.MaxConsoleWidthAccessor

getName

public String getName()

Specified by:

getName in interface org.refcodes.mixin.NameAccessor

getOptionEscapeCode

public String getOptionEscapeCode()

Retrieves the option Escape-Code from the option Escape-Code property.

Specified by:

getOptionEscapeCode in interface OptionEscapeCodeAccessor

Specified by:

getOptionEscapeCode in interface ParseArgs

Returns:

The option Escape-Code stored by the option Escape-Code property.

getResetEscapeCode

public String getResetEscapeCode()

Specified by:

getResetEscapeCode in interface org.refcodes.mixin.ResetEscapeCodeAccessor

getSeparatorLnChar

public char getSeparatorLnChar()

Gets the character to be used when printing a separator line with the ParseArgs.printSeparatorLn() method.

Specified by:

getSeparatorLnChar in interface ParseArgs

Returns:

aSeparatorChar The character used by the ParseArgs.printSeparatorLn() method when printing out the line of characters..

getShortOptionPrefix

public Character getShortOptionPrefix()

Retrieves the short option prefix from the short option prefix property.

Specified by:

getShortOptionPrefix in interface ShortOptionPrefixAccessor

Returns:

The short option prefix stored by the short option prefix property.

getSyntaxMetrics

public SyntaxMetrics getSyntaxMetrics()

Retrieves the SyntaxMetrics from the SyntaxMetrics property.

Specified by:

getSyntaxMetrics in interface SyntaxMetricsAccessor

Returns:

The SyntaxMetrics stored by the decorator (enabled) tags property.

getTextBoxGrid

public org.refcodes.textual.TextBoxGrid getTextBoxGrid()

Specified by:

getTextBoxGrid in interface org.refcodes.textual.TextBoxGridAccessor

getTitle

public String getTitle()

Specified by:

getTitle in interface org.refcodes.mixin.TitleAccessor

isEscapeCodesEnabled

public boolean isEscapeCodesEnabled()

Specified by:

isEscapeCodesEnabled in interface org.refcodes.mixin.EscapeCodesStatusAccessor

printBanner

public void printBanner()

Prints the banner; the banner most probably is an ASCII_HEADER_ASCII_BODY art text block which's look depends strongly on the taste of the author implementing this interface.

Specified by:

printBanner in interface ParseArgs

printCopyright

public void printCopyright()

Prints the copyright note as specified by the ParseArgs.withCopyright(String) method; with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.

Specified by:

printCopyright in interface ParseArgs

printDescription

public void printDescription()

Prints the description as set by the ParseArgs.withDescription(String) method with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.

Specified by:

printDescription in interface ParseArgs

printExamples

public void printExamples()

Prints example usages as as added by the ParseArgs.addExample(String, Operand...) method with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.

Specified by:

printExamples in interface ParseArgs

printHeader

public void printHeader()

Prints the header, which might be a simplified banner: Can be used when overriding methods such as ParseArgs.printHelp() or ParseArgs.printBanner().

Specified by:

printHeader in interface ParseArgs

printLicense

public void printLicense()

Prints the license note as specified by the ParseArgs.withLicense(String) method; with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.

Specified by:

printLicense in interface ParseArgs

printLn

public void printLn()

Prints an empty line / a line break.

Specified by:

printLn in interface ParseArgs

printLn

public void printLn(String aLine)

Prints the given line to standard out with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.

Specified by:

printLn in interface ParseArgs

Parameters:

aLine - The line to be printed.

printOptions

public void printOptions()

Prints the Options (short- and the long-options), the Flages and the Operand and their description with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.

Specified by:

printOptions in interface ParseArgs

printSeparatorLn

public void printSeparatorLn()

Prints a separator line using the separator character as specified by the ParseArgs.withSeparatorLnChar(char) method; with regards to the console width as specified by the ParseArgs.withConsoleWidth(int) method.

Specified by:

printSeparatorLn in interface ParseArgs

printSynopsis

public void printSynopsis()

Prints the syntax as retrieved by the root Condition element as of Synopsisable.toSynopsis(SyntaxNotation) with regards to the SyntaxNotation set by the ParseArgs.withSyntaxMetrics(SyntaxMetrics) method.

Specified by:

printSynopsis in interface ParseArgs

reset

public void reset()

Specified by:

reset in interface org.refcodes.mixin.Resetable

setArgsSyntax

public void setArgsSyntax(Term aArgsSyntax)

Sets the (root) Term for the (root) Term property.

Specified by:

setArgsSyntax in interface ArgsSyntaxAccessor.ArgsSyntaxMutator

Parameters:

aArgsSyntax - The (root) Term to be stored by the (root) Term property.

setArgumentEscapeCode

public void setArgumentEscapeCode(String aParamEscapeCode)

Sets the argument Escape-Code for the argument Escape-Code property.

Specified by:

setArgumentEscapeCode in interface ArgumentEscapeCodeAccessor.ArgumentEscapeCodeMutator

Parameters:

aParamEscapeCode - The argument Escape-Code to be stored by the argument Escape-Code property.

setBannerBorderEscapeCode

public void setBannerBorderEscapeCode(String aBannerBorderEscapeCode)

Sets the banner border Escape-Code for the banner border Escape-Code property.

Specified by:

setBannerBorderEscapeCode in interface BannerBorderEscapeCodeAccessor.BannerBorderEscapeCodeMutator

Parameters:

aBannerBorderEscapeCode - The banner border Escape-Code to be stored by the banner border Escape-Code property.

setBannerEscapeCode

public void setBannerEscapeCode(String aBannerEscapeCode)

Sets the banner Escape-Code for the banner Escape-Code property.

Specified by:

setBannerEscapeCode in interface BannerEscapeCodeAccessor.BannerEscapeCodeMutator

Parameters:

aBannerEscapeCode - The banner Escape-Code to be stored by the banner Escape-Code property.

setBannerFont

public void setBannerFont(org.refcodes.textual.Font aBannerFont)

Sets the banner Font for the banner Font property.

Specified by:

setBannerFont in interface BannerFontAccessor.BannerFontMutator

Parameters:

aBannerFont - The banner Font to be stored by the banner Font property.

setBannerFontPalette

public void setBannerFontPalette(org.refcodes.data.AsciiColorPalette aBannerFontPalette)

Sets the banner font palette for the banner font palette property.

Specified by:

setBannerFontPalette in interface BannerFontPaletteAccessor.BannerFontPaletteMutator

Parameters:

aBannerFontPalette - The banner font palette to be stored by the banner palette property.

setBannerFontPalette

public void setBannerFontPalette(char[] aColorPalette)

Sets the banner font palette for the banner font palette property.

Specified by:

setBannerFontPalette in interface BannerFontPaletteAccessor.BannerFontPaletteMutator

Parameters:

aColorPalette - The banner font palette to be stored by the banner palette property.

setCommandEscapeCode

public void setCommandEscapeCode(String aCommandEscapeCode)

Sets the command Escape-Code for the command Escape-Code property.

Specified by:

setCommandEscapeCode in interface CommandEscapeCodeAccessor.CommandEscapeCodeMutator

Parameters:

aCommandEscapeCode - The command Escape-Code to be stored by the command Escape-Code property.

setConsoleWidth

public void setConsoleWidth(int aConsoleWidth)

Specified by:

setConsoleWidth in interface org.refcodes.mixin.ConsoleWidthAccessor.ConsoleWidthMutator

setCopyright

public void setCopyright(String aCopyrightNote)

Sets the copyright for the copyright property.

Specified by:

setCopyright in interface CopyrightAccessor.CopyrightMutator

Parameters:

aCopyrightNote - The copyright to be stored by the console width property.

setDescription

public void setDescription(String aDescription)

Specified by:

setDescription in interface org.refcodes.mixin.DescriptionAccessor.DescriptionMutator

setDescriptionEscapeCode

public void setDescriptionEscapeCode(String aDescriptionEscapeCode)

Sets the description Escape-Code for the description Escape-Code property.

Specified by:

setDescriptionEscapeCode in interface DescriptionEscapeCodeAccessor.DescriptionEscapeCodeMutator

Parameters:

aDescriptionEscapeCode - The description Escape-Code to be stored by the description Escape-Code property.

setErrorOut

public void setErrorOut(PrintStream aErrorOut)

Set the error out PrintStream and make other adjustments with the result (with regards to the Builder-Pattern).

Specified by:

setErrorOut in interface ParseArgs

Parameters:

aErrorOut - The error out PrintStream to set.

setEscapeCodesEnabled

public void setEscapeCodesEnabled(boolean isEscapeCodesEnabled)

Specified by:

setEscapeCodesEnabled in interface org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusMutator

setExamples

public void setExamples(Example[] aExamples)

Sets the Example instances for the Example instances property.

Specified by:

setExamples in interface ExamplesAccessor.ExamplesMutator

Parameters:

aExamples - The Example instances to be stored.

setLicense

public void setLicense(String aLicenseNote)

Sets the license for the license property.

Specified by:

setLicense in interface LicenseAccessor.LicenseMutator

Parameters:

aLicenseNote - The license to be stored by the console width property.

setLineBreak

public void setLineBreak(String aLineBreak)

Specified by:

setLineBreak in interface org.refcodes.mixin.LineBreakAccessor.LineBreakMutator

setLineSeparatorEscapeCode

public void setLineSeparatorEscapeCode(String aLineSeparatorEscapeCode)

Sets the line separator Escape-Code for the line separator Escape-Code property.

Specified by:

setLineSeparatorEscapeCode in interface LineSeparatorEscapeCodeAccessor.LineSeparatorEscapeCodeMutator

Specified by:

setLineSeparatorEscapeCode in interface ParseArgs

Parameters:

aLineSeparatorEscapeCode - The line separator Escape-Code to be stored by the line separator Escape-Code property.

setLongOptionPrefix

public void setLongOptionPrefix(String aLongOptionPrefix)

Sets the long option prefix for the long option prefix property.

Specified by:

setLongOptionPrefix in interface LongOptionPrefixAccessor.LongOptionPrefixMutator

Parameters:

aLongOptionPrefix - The long option prefix to be stored by the long option prefix property.

setMaxConsoleWidth

public void setMaxConsoleWidth(int aMaxConsoleWidth)

Specified by:

setMaxConsoleWidth in interface org.refcodes.mixin.MaxConsoleWidthAccessor.MaxConsoleWidthMutator

setName

public void setName(String aName)

Specified by:

setName in interface org.refcodes.mixin.NameAccessor.NameMutator

setOptionEscapeCode

public void setOptionEscapeCode(String aOptEscapeCode)

Sets the option Escape-Code for the option Escape-Code property.

Specified by:

setOptionEscapeCode in interface OptionEscapeCodeAccessor.OptionEscapeCodeMutator

Parameters:

aOptEscapeCode - The option Escape-Code to be stored by the option Escape-Code property.

setResetEscapeCode

public void setResetEscapeCode(String aResetEscapeCode)

Specified by:

setResetEscapeCode in interface org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeMutator

setSeparatorLnChar

public void setSeparatorLnChar(char aSeparatorLnChar)

Set the character to be used when printing a separator line with the ParseArgs.printSeparatorLn() method.

Specified by:

setSeparatorLnChar in interface ParseArgs

Parameters:

aSeparatorLnChar - The character used by the ParseArgs.printSeparatorLn() method when printing out the line of characters..

setShortOptionPrefix

public void setShortOptionPrefix(Character aShortOptionPrefix)

Sets the short option prefix for the short option prefix property.

Specified by:

setShortOptionPrefix in interface ShortOptionPrefixAccessor.ShortOptionPrefixMutator

Parameters:

aShortOptionPrefix - The short option prefix to be stored by the short option prefix property.

setStandardOut

public void setStandardOut(PrintStream aStandardOut)

Set the standard out PrintStream and make other adjustments with the result (with regards to the Builder-Pattern).

Specified by:

setStandardOut in interface ParseArgs

Parameters:

aStandardOut - The standard out PrintStream to set.

setSyntaxMetrics

public void setSyntaxMetrics(SyntaxMetrics aSyntaxMetrics)

Sets the SyntaxMetrics for the SyntaxMetrics property.

Specified by:

setSyntaxMetrics in interface ParseArgs

Specified by:

setSyntaxMetrics in interface SyntaxMetricsAccessor.SyntaxMetricsMutator

Parameters:

aSyntaxMetrics - The SyntaxMetrics to be stored by the SyntaxMetrics property.

setTextBoxGrid

public void setTextBoxGrid(org.refcodes.textual.TextBoxGrid aTextBoxGrid)

Specified by:

setTextBoxGrid in interface org.refcodes.textual.TextBoxGridAccessor.TextBoxGridMutator

setTitle

public void setTitle(String aTitle)

Specified by:

setTitle in interface org.refcodes.mixin.TitleAccessor.TitleMutator

withAddExample

public ArgsParser withAddExample(Example aExamples)

Builder method adding an application's Example element.

Specified by:

withAddExample in interface ArgsProcessorBuilder<ParseArgs>

Specified by:

withAddExample in interface ParseArgs

Parameters:

aExamples - The application's Example element to be added.

Returns:

This builder as of the builder pattern.

withAddExample

public ArgsParser withAddExample(String aDescription,
 Operand<?>... aOperands)

Builder method adding an application's Example element.

Specified by:

withAddExample in interface ArgsProcessorBuilder<ParseArgs>

Specified by:

withAddExample in interface ParseArgs

Parameters:

aDescription - The example's description.

aOperands - The command line arguments required by the example.

Returns:

This builder as of the builder pattern.

withArgsSyntax

public ArgsParser withArgsSyntax(Term aArgsSyntax)

Sets the (root) Term for the (root) Term property.

Specified by:

withArgsSyntax in interface ArgsSyntaxAccessor.ArgsSyntaxBuilder<ParseArgs>

Parameters:

aArgsSyntax - The (root) Term to be stored by the (root) Term property.

Returns:

The builder for applying multiple build operations.

withArgumentEscapeCode

public ArgsParser withArgumentEscapeCode(String aParamEscCode)

Sets the argument Escape-Code for the argument Escape-Code property.

Specified by:

withArgumentEscapeCode in interface ArgumentEscapeCodeAccessor.ArgumentEscapeCodeBuilder<ParseArgs>

Specified by:

withArgumentEscapeCode in interface ParseArgs

Parameters:

aParamEscCode - The argument Escape-Code to be stored by the argument Escape-Code property.

Returns:

The builder for applying multiple build operations.

withBannerBorderEscapeCode

public ArgsParser withBannerBorderEscapeCode(String aBannerBorderEscCode)

Sets the banner border Escape-Code for the banner border Escape-Code property.

Specified by:

withBannerBorderEscapeCode in interface BannerBorderEscapeCodeAccessor.BannerBorderEscapeCodeBuilder<ParseArgs>

Specified by:

withBannerBorderEscapeCode in interface ParseArgs

Parameters:

aBannerBorderEscCode - The banner border Escape-Code to be stored by the banner border Escape-Code property.

Returns:

The builder for applying multiple build operations.

withBannerEscapeCode

public ArgsParser withBannerEscapeCode(String aBannerEscCode)

Sets the banner Escape-Code for the banner Escape-Code property.

Specified by:

withBannerEscapeCode in interface BannerEscapeCodeAccessor.BannerEscapeCodeBuilder<ParseArgs>

Specified by:

withBannerEscapeCode in interface ParseArgs

Parameters:

aBannerEscCode - The banner Escape-Code to be stored by the banner Escape-Code property.

Returns:

The builder for applying multiple build operations.

withBannerFont

public ArgsParser withBannerFont(org.refcodes.textual.Font aBannerFont)

Sets the banner Font for the banner Font property.

Specified by:

withBannerFont in interface BannerFontAccessor.BannerFontBuilder<ParseArgs>

Specified by:

withBannerFont in interface ParseArgs

Parameters:

aBannerFont - The banner Font to be stored by the banner Font property.

Returns:

The builder for applying multiple build operations.

withBannerFontPalette

public ArgsParser withBannerFontPalette(org.refcodes.data.AsciiColorPalette aBannerFontPalette)

Sets the banner font palette for the banner font palette property.

Specified by:

withBannerFontPalette in interface BannerFontPaletteAccessor.BannerFontPaletteBuilder<ParseArgs>

Parameters:

aBannerFontPalette - The banner font palette to be stored by the banner palette property.

Returns:

The builder for applying multiple build operations.

withBannerFontPalette

public ArgsParser withBannerFontPalette(char[] aColorPalette)

Sets the banner font palette for the banner font palette property.

Specified by:

withBannerFontPalette in interface BannerFontPaletteAccessor.BannerFontPaletteBuilder<ParseArgs>

Specified by:

withBannerFontPalette in interface ParseArgs

Parameters:

aColorPalette - The banner font palette to be stored by the banner palette property.

Returns:

The builder for applying multiple build operations.

withCommandEscapeCode

public ArgsParser withCommandEscapeCode(String aCommandEscCode)

Sets the command Escape-Code for the command Escape-Code property.

Specified by:

withCommandEscapeCode in interface CommandEscapeCodeAccessor.CommandEscapeCodeBuilder<ParseArgs>

Specified by:

withCommandEscapeCode in interface ParseArgs

Parameters:

aCommandEscCode - The command Escape-Code to be stored by the command Escape-Code property.

Returns:

The builder for applying multiple build operations.

withConsoleWidth

public ArgsParser withConsoleWidth(int aConsoleWidth)

Specified by:

withConsoleWidth in interface org.refcodes.mixin.ConsoleWidthAccessor.ConsoleWidthBuilder<ParseArgs>

Specified by:

withConsoleWidth in interface ParseArgs

withCopyright

public ArgsParser withCopyright(String aCopyright)

Sets the copyright for the copyright property.

Specified by:

withCopyright in interface CopyrightAccessor.CopyrightBuilder<ParseArgs>

Specified by:

withCopyright in interface ParseArgs

Parameters:

aCopyright - The copyright to be stored by the console width property.

Returns:

The builder for applying multiple build operations.

withDescription

public ArgsParser withDescription(String aDescription)

Specified by:

withDescription in interface org.refcodes.mixin.DescriptionAccessor.DescriptionBuilder<ParseArgs>

Specified by:

withDescription in interface ParseArgs

withDescriptionEscapeCode

public ArgsParser withDescriptionEscapeCode(String aDescriptionEscCode)

Sets the description Escape-Code for the description Escape-Code property.

Specified by:

withDescriptionEscapeCode in interface DescriptionEscapeCodeAccessor.DescriptionEscapeCodeBuilder<ParseArgs>

Specified by:

withDescriptionEscapeCode in interface ParseArgs

Parameters:

aDescriptionEscCode - The description Escape-Code to be stored by the description Escape-Code property.

Returns:

The builder for applying multiple build operations.

withErrorOut

public ArgsParser withErrorOut(PrintStream aErrorOut)

Set the error out PrintStream and make other adjustments with the result (with regards to the Builder-Pattern).

Specified by:

withErrorOut in interface ArgsProcessorBuilder<ParseArgs>

Specified by:

withErrorOut in interface ParseArgs

Parameters:

aErrorOut - The error out PrintStream to set.

Returns:

This instance with regard to the builder pattern.

withEscapeCodesEnabled

public ArgsParser withEscapeCodesEnabled(boolean aIsEscCodeEnabled)

Specified by:

withEscapeCodesEnabled in interface org.refcodes.mixin.EscapeCodesStatusAccessor.EscapeCodeStatusBuilder<ParseArgs>

Specified by:

withEscapeCodesEnabled in interface ParseArgs

withEvalArgs

public ArgsParser withEvalArgs(List<String> aArgs)
                        throws ArgsSyntaxException

Evaluates the provided command line arguments .

Specified by:

withEvalArgs in interface ArgsParserBuilder<ParseArgs>

Specified by:

withEvalArgs in interface ParseArgs

Parameters:

aArgs - The command line arguments to be evaluated.

Returns:

This instance as of the builder pattern to chain further method calls.

Throws:

ArgsSyntaxException - thrown in case of a command line arguments mismatch regarding provided and expected args.

withEvalArgs

public ArgsParser withEvalArgs(List<String> aArgs,
 ArgsFilter aArgsFilter)
                        throws ArgsSyntaxException

Evaluates the provided command line arguments, filtering (excluding) the arguments matching the provided ArgsFilter.

Specified by:

withEvalArgs in interface ArgsParserBuilder<ParseArgs>

Parameters:

aArgs - The command line arguments to be evaluated.

aArgsFilter - The ArgsFilter used to filter (exclude) any "unwanted" or otherwise evaluated arguments.

Returns:

This instance as of the builder pattern to chain further method calls.

Throws:

ArgsSyntaxException - thrown in case of a command line arguments mismatch regarding provided and expected args.

withEvalArgs

public ArgsParser withEvalArgs(List<String> aArgs,
 Pattern aFilterExp)
                        throws ArgsSyntaxException

Evaluates the provided command line arguments, filtering (excluding) the arguments matching the provided Pattern.

Specified by:

withEvalArgs in interface ArgsParserBuilder<ParseArgs>

Parameters:

aArgs - The command line arguments to be evaluated.

aFilterExp - The Pattern used to filter (exclude) any "unwanted" or otherwise evaluated arguments.

Returns:

This instance as of the builder pattern to chain further method calls.

Throws:

ArgsSyntaxException - thrown in case of a command line arguments mismatch regarding provided and expected args.

withEvalArgs

public ArgsParser withEvalArgs(String[] aArgs)
                        throws ArgsSyntaxException

Evaluates the provided command line arguments.

Specified by:

withEvalArgs in interface ArgsParserBuilder<ParseArgs>

Specified by:

withEvalArgs in interface ParseArgs

Parameters:

aArgs - The command line arguments to be evaluated.

Returns:

This instance as of the builder pattern to chain further method calls.

Throws:

ArgsSyntaxException - thrown in case of a command line arguments mismatch regarding provided and expected args.

withEvalArgs

public ArgsParser withEvalArgs(String[] aArgs,
 ArgsFilter aArgsFilter)
                        throws ArgsSyntaxException

Evaluates the provided command line arguments, filtering (excluding) the arguments matching the provided ArgsFilter.

Specified by:

withEvalArgs in interface ArgsParserBuilder<ParseArgs>

Parameters:

aArgs - The command line arguments to be evaluated.

aArgsFilter - The ArgsFilter used to filter (exclude) any "unwanted" or otherwise evaluated arguments.

Returns:

This instance as of the builder pattern to chain further method calls.

Throws:

ArgsSyntaxException - thrown in case of a command line arguments mismatch regarding provided and expected args.

withEvalArgs

public ArgsParser withEvalArgs(String[] aArgs,
 Pattern aFilterExp)
                        throws ArgsSyntaxException

Evaluates the provided command line arguments, filtering (excluding) the arguments matching the provided Pattern.

Specified by:

withEvalArgs in interface ArgsParserBuilder<ParseArgs>

Parameters:

aArgs - The command line arguments to be evaluated.

aFilterExp - The Pattern used to filter (exclude) any "unwanted" or otherwise evaluated arguments.

Returns:

This instance as of the builder pattern to chain further method calls.

Throws:

ArgsSyntaxException - thrown in case of a command line arguments mismatch regarding provided and expected args.

withExamples

public ArgsParser withExamples(Collection<Example> aExamples)

Builder method providing the application's Example elements.

Specified by:

withExamples in interface ExamplesAccessor.ExamplesBuilder<ParseArgs>

Specified by:

withExamples in interface ParseArgs

Parameters:

aExamples - The application's Example elements to use.

Returns:

This builder as of the builder pattern.

withExamples

public ArgsParser withExamples(Example[] aExamples)

Sets the Example instances for the Example instances property.

Specified by:

withExamples in interface ExamplesAccessor.ExamplesBuilder<ParseArgs>

Specified by:

withExamples in interface ParseArgs

Parameters:

aExamples - The Example instances to be stored.

Returns:

The builder for applying multiple build operations.

withLicense

public ArgsParser withLicense(String aLicense)

Sets the license for the license property.

Specified by:

withLicense in interface LicenseAccessor.LicenseBuilder<ParseArgs>

Specified by:

withLicense in interface ParseArgs

Parameters:

aLicense - The license to be stored by the console width property.

Returns:

The builder for applying multiple build operations.

withLineBreak

public ArgsParser withLineBreak(String aLineBreak)

Specified by:

withLineBreak in interface org.refcodes.mixin.LineBreakAccessor.LineBreakBuilder<ParseArgs>

Specified by:

withLineBreak in interface ParseArgs

withLineSeparatorEscapeCode

public ArgsParser withLineSeparatorEscapeCode(String aLineSeparatorEscCode)

Sets the line separator Escape-Code for the line separator Escape-Code property.

Specified by:

withLineSeparatorEscapeCode in interface LineSeparatorEscapeCodeAccessor.LineSeparatorEscapeCodeBuilder<ParseArgs>

Specified by:

withLineSeparatorEscapeCode in interface ParseArgs

Parameters:

aLineSeparatorEscCode - The line separator Escape-Code to be stored by the line separator Escape-Code property.

Returns:

The builder for applying multiple build operations.

withLongOptionPrefix

public ArgsParser withLongOptionPrefix(String aLongOptionPrefix)

Sets the long option prefix for the long option prefix property.

Specified by:

withLongOptionPrefix in interface LongOptionPrefixAccessor.LongOptionPrefixBuilder<ParseArgs>

Specified by:

withLongOptionPrefix in interface ParseArgs

Parameters:

aLongOptionPrefix - The long option prefix to be stored by the long option prefix property.

Returns:

The builder for applying multiple build operations.

withMaxConsoleWidth

public ArgsParser withMaxConsoleWidth(int aMaxConsoleWidth)

Specified by:

withMaxConsoleWidth in interface org.refcodes.mixin.MaxConsoleWidthAccessor.MaxConsoleWidthBuilder<ParseArgs>

Specified by:

withMaxConsoleWidth in interface ParseArgs

withName

public ArgsParser withName(String aName)

Specified by:

withName in interface org.refcodes.mixin.NameAccessor.NameBuilder<ParseArgs>

Specified by:

withName in interface ParseArgs

withOptionEscapeCode

public ArgsParser withOptionEscapeCode(String aOptEscCode)

Sets the option Escape-Code for the option Escape-Code property.

Specified by:

withOptionEscapeCode in interface OptionEscapeCodeAccessor.OptionEscapeCodeBuilder<ParseArgs>

Specified by:

withOptionEscapeCode in interface ParseArgs

Parameters:

aOptEscCode - The option Escape-Code to be stored by the option Escape-Code property.

Returns:

The builder for applying multiple build operations.

withResetEscapeCode

public ArgsParser withResetEscapeCode(String aResetEscCode)

Specified by:

withResetEscapeCode in interface ParseArgs

Specified by:

withResetEscapeCode in interface org.refcodes.mixin.ResetEscapeCodeAccessor.ResetEscapeCodeBuilder<ParseArgs>

withSeparatorLnChar

public ArgsParser withSeparatorLnChar(char aSeparatorLnChar)

Builder method adding an separator line char.

Specified by:

withSeparatorLnChar in interface ArgsProcessorBuilder<ParseArgs>

Specified by:

withSeparatorLnChar in interface ParseArgs

Parameters:

aSeparatorLnChar - THe according separator line char to use.

Returns:

This builder as of the builder pattern.

withShortOptionPrefix

public ArgsParser withShortOptionPrefix(Character aShortOptionPrefix)

Sets the short option prefix for the short option prefix property.

Specified by:

withShortOptionPrefix in interface ParseArgs

Specified by:

withShortOptionPrefix in interface ShortOptionPrefixAccessor.ShortOptionPrefixBuilder<ParseArgs>

Parameters:

aShortOptionPrefix - The short option prefix to be stored by the short option prefix property.

Returns:

The builder for applying multiple build operations.

withStandardOut

public ArgsParser withStandardOut(PrintStream aStandardOut)

Set the standard out PrintStream and make other adjustments with the result (with regards to the Builder-Pattern).

Specified by:

withStandardOut in interface ArgsProcessorBuilder<ParseArgs>

Specified by:

withStandardOut in interface ParseArgs

Parameters:

aStandardOut - The standard out PrintStream to set.

Returns:

This instance with regard to the builder pattern.

withSyntaxMetrics

public ArgsParser withSyntaxMetrics(SyntaxMetrics aSyntaxMetrics)

Sets the SyntaxMetrics for the SyntaxMetrics property.

Specified by:

withSyntaxMetrics in interface ParseArgs

Specified by:

withSyntaxMetrics in interface SyntaxMetricsAccessor.SyntaxMetricsBuilder<ParseArgs>

Parameters:

aSyntaxMetrics - The SyntaxMetrics to be stored by the SyntaxMetrics property.

Returns:

The builder for applying multiple build operations.

withSyntaxMetrics

public ArgsParser withSyntaxMetrics(SyntaxNotation aSyntaxNotation)

Sets the SyntaxNotation for the SyntaxNotation property.

Specified by:

withSyntaxMetrics in interface SyntaxMetricsAccessor.SyntaxMetricsBuilder<ParseArgs>

Parameters:

aSyntaxNotation - The SyntaxNotation to be stored by the SyntaxNotation property.

Returns:

The builder for applying multiple build operations.

withTextBoxGrid

public ArgsParser withTextBoxGrid(org.refcodes.textual.TextBoxGrid aTextBoxGrid)

Specified by:

withTextBoxGrid in interface ParseArgs

Specified by:

withTextBoxGrid in interface org.refcodes.textual.TextBoxGridAccessor.TextBoxGridBuilder<ParseArgs>

withTextBoxGrid

public ArgsParser withTextBoxGrid(org.refcodes.textual.TextBoxStyle aTextBoxStyle)

Specified by:

withTextBoxGrid in interface ParseArgs

Specified by:

withTextBoxGrid in interface org.refcodes.textual.TextBoxGridAccessor.TextBoxGridBuilder<ParseArgs>

withTitle

public ArgsParser withTitle(String aTitle)

Specified by:

withTitle in interface ParseArgs

Specified by:

withTitle in interface org.refcodes.mixin.TitleAccessor.TitleBuilder<ParseArgs>

getDelimiter

protected char getDelimiter()

The delimiter to be used for colliding command line args when creating non colliding arg's aliases (keys for key/value-pairs). Used when parsing args without any syntax definition.

Returns:

The according delimiter for solving colliding command line args.