Class ArgumentParserImpl
- All Implemented Interfaces:
ArgumentParser
-
Nested Class Summary
Nested Classes -
Constructor Summary
ConstructorsConstructorDescriptionArgumentParserImpl
(String prog) ArgumentParserImpl
(String prog, boolean addHelp) ArgumentParserImpl
(String prog, boolean addHelp, String prefixChars) ArgumentParserImpl
(String prog, boolean addHelp, String prefixChars, String fromFilePrefix) ArgumentParserImpl
(String prog, boolean addHelp, String prefixChars, String fromFilePrefix, TextWidthCounter textWidthCounter) ArgumentParserImpl
(String prog, boolean addHelp, String prefixChars, String fromFilePrefix, TextWidthCounter textWidthCounter, String command, ArgumentParserImpl mainParser) -
Method Summary
Modifier and TypeMethodDescriptionaddArgument
(String... nameOrFlags) Creates newArgument
object and adds to this parser and returns the object.addArgument
(ArgumentGroupImpl group, String... nameOrFlags) addArgumentGroup
(String title) Creates newArgumentGroup
object and adds to this parser and returns the object.Creates new mutually exclusive group,MutuallyExclusiveGroup
object, without title and adds to this parser and returns the object.addMutuallyExclusiveGroup
(String title) Creates new mutually exclusive group,MutuallyExclusiveGroup
object, and adds to this parser and returns the object.ReturnsSubparsers
.defaultHelp
(boolean defaultHelp) If defaultHelp istrue
, the default values of arguments are printed in help message.description
(String description) Set text to display before the argument help.Sets the text to display after the argument help.Returns help message.Returns a brief description of how the program should be invoked on the command line.Returns version string.getDefault
(String dest) Returns default value set byArgumentImpl.setDefault(Object)
orsetDefault(String, Object)
.Returns main (parent) parser.getProg()
void
Prints usage and error message.boolean
Parses command line arguments.void
void
Parses command line arguments.void
Parses command line arguments.void
Parses command line arguments.void
parseArgs
(ParseState state, Map<String, Object> attrs) parseArgsOrFail
(String[] args) Parses command line arguments, handling any errors.void
Prints help message in stdout.void
printHelp
(PrintWriter writer) Prints help message in writer.void
Print a brief description of how the program should be invoked on the command line in stdout.void
printUsage
(PrintWriter writer) Print a brief description of how the program should be invoked on the command line in writer.void
Prints version string in stdout.void
printVersion
(PrintWriter writer) Prints version string in writer.setDefault
(String dest, Object value) Sets parser-level default value of attributedest
.setDefaults
(Map<String, Object> attrs) Sets parser-level default values fromattrs
.Sets the text to display as usage line.Sets version string.
-
Constructor Details
-
ArgumentParserImpl
-
ArgumentParserImpl
-
ArgumentParserImpl
-
ArgumentParserImpl
-
ArgumentParserImpl
public ArgumentParserImpl(String prog, boolean addHelp, String prefixChars, String fromFilePrefix, TextWidthCounter textWidthCounter) -
ArgumentParserImpl
public ArgumentParserImpl(String prog, boolean addHelp, String prefixChars, String fromFilePrefix, TextWidthCounter textWidthCounter, String command, ArgumentParserImpl mainParser)
-
-
Method Details
-
addArgument
Description copied from interface:ArgumentParser
Creates new
Argument
object and adds to this parser and returns the object.The
nameOrFlags
is either a single name of positional argument or a list of option strings for optional argument, e.g.foo
or-f, --foo
.- Specified by:
addArgument
in interfaceArgumentParser
- Parameters:
nameOrFlags
- A name or a list of option strings of newArgument
.- Returns:
Argument
object.
-
addArgument
-
addSubparsers
Description copied from interface:ArgumentParser
Returns
Subparsers
.The method name is rather controversial because repeated call of this method does not add new
Subparsers
object. Instead, this method always returns sameSubparsers
object.Subparsers
object provides a way to add sub-commands.- Specified by:
addSubparsers
in interfaceArgumentParser
- Returns:
Subparsers
object.
-
addArgumentGroup
Description copied from interface:ArgumentParser
Creates new
ArgumentGroup
object and adds to this parser and returns the object.The
title
is printed in help message as a title of this group.ArgumentGroup
provides a way to conceptually group up command line arguments.- Specified by:
addArgumentGroup
in interfaceArgumentParser
- Parameters:
title
- The title printed in help message.- Returns:
ArgumentGroup
object.
-
addMutuallyExclusiveGroup
Description copied from interface:ArgumentParser
Creates new mutually exclusive group,
MutuallyExclusiveGroup
object, without title and adds to this parser and returns the object.- Specified by:
addMutuallyExclusiveGroup
in interfaceArgumentParser
- Returns:
MutuallyExclusiveGroup
object.
-
addMutuallyExclusiveGroup
Description copied from interface:ArgumentParser
Creates new mutually exclusive group,
MutuallyExclusiveGroup
object, and adds to this parser and returns the object.The arguments added to this group are mutually exclusive; if more than one argument belong to the group are specified, an error will be reported. The
title
is printed in help message as a title of this group.- Specified by:
addMutuallyExclusiveGroup
in interfaceArgumentParser
- Parameters:
title
- The title printed in help message.- Returns:
- The
MutuallyExclusiveGroup
object.
-
usage
Description copied from interface:ArgumentParser
Sets the text to display as usage line. By default, the usage line is calculated from the arguments this object contains.
If the given usage contains ${prog} string, it will be replaced with the program name given in
ArgumentParsers.newArgumentParser(String)
.- Specified by:
usage
in interfaceArgumentParser
- Parameters:
usage
- usage text- Returns:
- this
-
description
Set text to display before the argument help.- Specified by:
description
in interfaceArgumentParser
- Parameters:
description
- text to display before the argument help- Returns:
- this
-
epilog
Description copied from interface:ArgumentParser
Sets the text to display after the argument help.- Specified by:
epilog
in interfaceArgumentParser
- Parameters:
epilog
- The text to display after the argument help.- Returns:
- this
-
version
Description copied from interface:ArgumentParser
Sets version string. It will be displayed
ArgumentParser.printVersion()
.If the given usage contains ${prog} string, it will be replaced with the program name given in
ArgumentParsers.newArgumentParser(String)
. This processed text will be printed without text-wrapping.- Specified by:
version
in interfaceArgumentParser
- Parameters:
version
- The version string.- Returns:
- this
-
defaultHelp
Description copied from interface:ArgumentParser
If defaultHelp is
true
, the default values of arguments are printed in help message.By default, the default values are not printed in help message.
- Specified by:
defaultHelp
in interfaceArgumentParser
- Parameters:
defaultHelp
- Switch to display the default value in help message.- Returns:
- this
-
isDefaultHelp
public boolean isDefaultHelp() -
printHelp
public void printHelp()Description copied from interface:ArgumentParser
Prints help message in stdout.- Specified by:
printHelp
in interfaceArgumentParser
-
printHelp
Description copied from interface:ArgumentParser
Prints help message in writer.- Specified by:
printHelp
in interfaceArgumentParser
- Parameters:
writer
- Writer to print message.
-
formatHelp
Description copied from interface:ArgumentParser
Returns help message.- Specified by:
formatHelp
in interfaceArgumentParser
- Returns:
- The help message.
-
printUsage
public void printUsage()Description copied from interface:ArgumentParser
Print a brief description of how the program should be invoked on the command line in stdout.- Specified by:
printUsage
in interfaceArgumentParser
-
printUsage
Description copied from interface:ArgumentParser
Print a brief description of how the program should be invoked on the command line in writer.- Specified by:
printUsage
in interfaceArgumentParser
- Parameters:
writer
- Writer to print message.
-
formatUsage
Description copied from interface:ArgumentParser
Returns a brief description of how the program should be invoked on the command line.- Specified by:
formatUsage
in interfaceArgumentParser
- Returns:
- Usage text.
-
setDefault
Description copied from interface:ArgumentParser
Sets parser-level default value of attribute
dest
.The parser-level defaults always override argument-level defaults.
- Specified by:
setDefault
in interfaceArgumentParser
- Parameters:
dest
- The attribute name.value
- The default value.- Returns:
- this
-
setDefaults
Description copied from interface:ArgumentParser
Sets parser-level default values from
attrs
.All key-value pair in
attrs
are registered to parser-level defaults. The parser-level defaults always override argument-level defaults.- Specified by:
setDefaults
in interfaceArgumentParser
- Parameters:
attrs
- The parser-level default values to add.- Returns:
- this
-
getDefault
Returns default value set byArgumentImpl.setDefault(Object)
orsetDefault(String, Object)
. Please note that while parser-level defaults always override argument-level defaults while parsing, this method examines argument-level defaults first. If no default value is found, then check parser-level defaults.- Specified by:
getDefault
in interfaceArgumentParser
- Parameters:
dest
- attribute name of default value to get.- Returns:
- default value of given dest.
-
parseArgsOrFail
Description copied from interface:ArgumentParser
Parses command line arguments, handling any errors.
This is a shortcut method that combines
ArgumentParser.parseArgs(java.lang.String[])
andArgumentParser.handleError(net.sourceforge.argparse4j.inf.ArgumentParserException)
. If the arguments can be successfully parsed, the resulted attributes are returned as aNamespace
object. Otherwise, the program exits with a1
return code.- Specified by:
parseArgsOrFail
in interfaceArgumentParser
- Parameters:
args
- Command line arguments.- Returns:
Namespace
object.
-
parseArgs
Description copied from interface:ArgumentParser
Parses command line arguments.
The resulted attributes are returned as
Namespace
object. This method must not alter the status of this parser and can be called multiple times.- Specified by:
parseArgs
in interfaceArgumentParser
- Parameters:
args
- Command line arguments.- Returns:
Namespace
object.- Throws:
ArgumentParserException
- If an error occurred.
-
parseArgs
Description copied from interface:ArgumentParser
Parses command line arguments.
Unlike
ArgumentParser.parseArgs(String[])
, which returnsNamespace
object, this method stores attributes in givenattrs
.- Specified by:
parseArgs
in interfaceArgumentParser
- Parameters:
args
- Command line arguments.attrs
- Map object to store attributes.- Throws:
ArgumentParserException
- If an error occurred.
-
parseArgs
Description copied from interface:ArgumentParser
Parses command line arguments.
Unlike
ArgumentParser.parseArgs(String[])
, which returnsNamespace
object, this method stores attributes in givenuserData
. The location to store value is designated usingArg
annotations. User don't have to specifyArg
for all attributes: the missing attributes are just skipped. This method performs simpleList
to generic array conversion. For example, user can assignList<Integer>
attribute to generic arrayint[]
.- Specified by:
parseArgs
in interfaceArgumentParser
- Parameters:
args
- Command line arguments.userData
- Object to store attributes.- Throws:
ArgumentParserException
- If an error occurred.
-
parseArgs
public void parseArgs(String[] args, Map<String, Object> attrs, Object userData) throws ArgumentParserExceptionDescription copied from interface:ArgumentParser
Parses command line arguments.
This is a combination of
ArgumentParser.parseArgs(String[], Map)
andArgumentParser.parseArgs(String[], Object)
. The all attributes will be stored inattrs
. The attributes specified inArg
annotations will be also stored inuserData
.- Specified by:
parseArgs
in interfaceArgumentParser
- Parameters:
args
- Command line arguments.attrs
- Map to store attributes.userData
- Object to store attributes.- Throws:
ArgumentParserException
- If an error occurred.
-
parseArgs
public void parseArgs(String[] args, int offset, Map<String, Object> attrs) throws ArgumentParserException- Throws:
ArgumentParserException
-
parseArgs
- Throws:
ArgumentParserException
-
getProg
-
printVersion
public void printVersion()Description copied from interface:ArgumentParser
Prints version string in stdout.- Specified by:
printVersion
in interfaceArgumentParser
-
printVersion
Description copied from interface:ArgumentParser
Prints version string in writer.- Specified by:
printVersion
in interfaceArgumentParser
- Parameters:
writer
- Writer to print version string.
-
formatVersion
Description copied from interface:ArgumentParser
Returns version string.- Specified by:
formatVersion
in interfaceArgumentParser
- Returns:
- The version string.
-
handleError
Description copied from interface:ArgumentParser
Prints usage and error message.
Please note that this method does not terminate the program.
- Specified by:
handleError
in interfaceArgumentParser
- Parameters:
e
- Error thrown byArgumentParser.parseArgs(String[])
.
-
getCommand
-
getTextWidthCounter
-
getPrefixChars
-
getFromFilePrefixChars
-
getMainParser
Returns main (parent) parser.- Returns:
- The main (parent) parser. null if this object is a root parser.
-