Package org.jline.console
Class CmdDesc
- java.lang.Object
-
- org.jline.console.CmdDesc
-
public class CmdDesc extends java.lang.Object
Represents a command description used for generating command help and documentation. This class stores information about a command, including its main description, argument descriptions, and option descriptions. It is used by the JLine Widgets framework to display command help in the terminal.
-
-
Constructor Summary
Constructors Constructor Description CmdDesc()
Creates a new command description that is not a command.CmdDesc(boolean valid)
Creates a new command description with the specified validity.CmdDesc(java.util.List<ArgDesc> argsDesc)
Creates a new command description with the specified argument descriptions.CmdDesc(java.util.List<ArgDesc> argsDesc, java.util.Map<java.lang.String,java.util.List<AttributedString>> optsDesc)
Creates a new command description with the specified argument and option descriptions.CmdDesc(java.util.List<AttributedString> mainDesc, java.util.List<ArgDesc> argsDesc, java.util.Map<java.lang.String,java.util.List<AttributedString>> optsDesc)
Creates a new command description with the specified main description, argument descriptions, and option descriptions.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.util.List<ArgDesc>
getArgsDesc()
Returns the descriptions of the command's arguments.int
getErrorIndex()
Returns the index of the error in the command.java.util.regex.Pattern
getErrorPattern()
Returns the pattern used to identify errors in the command.java.util.List<AttributedString>
getMainDesc()
Returns the main description of the command.java.util.TreeMap<java.lang.String,java.util.List<AttributedString>>
getOptsDesc()
Returns the descriptions of the command's options.boolean
isCommand()
Returns whether this is a command (as opposed to a method or syntax).boolean
isHighlighted()
Returns whether the command should be highlighted.boolean
isSubcommand()
Returns whether this is a subcommand.boolean
isValid()
Returns whether the command is valid.CmdDesc
mainDesc(java.util.List<AttributedString> mainDesc)
Sets the main description of the command and returns this command description.AttributedString
optionDescription(java.lang.String key)
Returns the description of the specified option.boolean
optionWithValue(java.lang.String option)
Returns whether the specified option takes a value.void
setErrorIndex(int errorIndex)
Sets the index of the error in the command.void
setErrorPattern(java.util.regex.Pattern errorPattern)
Sets the pattern used to identify errors in the command.void
setHighlighted(boolean highlighted)
Sets whether the command should be highlighted.void
setMainDesc(java.util.List<AttributedString> mainDesc)
Sets the main description of the command.void
setSubcommand(boolean subcommand)
Sets whether this is a subcommand.
-
-
-
Constructor Detail
-
CmdDesc
public CmdDesc()
Creates a new command description that is not a command.
-
CmdDesc
public CmdDesc(boolean valid)
Creates a new command description with the specified validity.- Parameters:
valid
- whether the command is valid
-
CmdDesc
public CmdDesc(java.util.List<ArgDesc> argsDesc)
Creates a new command description with the specified argument descriptions.- Parameters:
argsDesc
- the descriptions of the command's arguments
-
CmdDesc
public CmdDesc(java.util.List<ArgDesc> argsDesc, java.util.Map<java.lang.String,java.util.List<AttributedString>> optsDesc)
Creates a new command description with the specified argument and option descriptions.- Parameters:
argsDesc
- the descriptions of the command's argumentsoptsDesc
- the descriptions of the command's options
-
CmdDesc
public CmdDesc(java.util.List<AttributedString> mainDesc, java.util.List<ArgDesc> argsDesc, java.util.Map<java.lang.String,java.util.List<AttributedString>> optsDesc)
Creates a new command description with the specified main description, argument descriptions, and option descriptions.- Parameters:
mainDesc
- the main description of the commandargsDesc
- the descriptions of the command's argumentsoptsDesc
- the descriptions of the command's options
-
-
Method Detail
-
isValid
public boolean isValid()
Returns whether the command is valid.- Returns:
- true if the command is valid, false otherwise
-
isCommand
public boolean isCommand()
Returns whether this is a command (as opposed to a method or syntax).- Returns:
- true if this is a command, false otherwise
-
setSubcommand
public void setSubcommand(boolean subcommand)
Sets whether this is a subcommand.- Parameters:
subcommand
- true if this is a subcommand, false otherwise
-
isSubcommand
public boolean isSubcommand()
Returns whether this is a subcommand.- Returns:
- true if this is a subcommand, false otherwise
-
setHighlighted
public void setHighlighted(boolean highlighted)
Sets whether the command should be highlighted.- Parameters:
highlighted
- true if the command should be highlighted, false otherwise
-
isHighlighted
public boolean isHighlighted()
Returns whether the command should be highlighted.- Returns:
- true if the command should be highlighted, false otherwise
-
mainDesc
public CmdDesc mainDesc(java.util.List<AttributedString> mainDesc)
Sets the main description of the command and returns this command description.- Parameters:
mainDesc
- the main description of the command- Returns:
- this command description
-
setMainDesc
public void setMainDesc(java.util.List<AttributedString> mainDesc)
Sets the main description of the command.- Parameters:
mainDesc
- the main description of the command
-
getMainDesc
public java.util.List<AttributedString> getMainDesc()
Returns the main description of the command.- Returns:
- the main description of the command
-
getOptsDesc
public java.util.TreeMap<java.lang.String,java.util.List<AttributedString>> getOptsDesc()
Returns the descriptions of the command's options.- Returns:
- the descriptions of the command's options
-
setErrorPattern
public void setErrorPattern(java.util.regex.Pattern errorPattern)
Sets the pattern used to identify errors in the command.- Parameters:
errorPattern
- the pattern used to identify errors
-
getErrorPattern
public java.util.regex.Pattern getErrorPattern()
Returns the pattern used to identify errors in the command.- Returns:
- the pattern used to identify errors
-
setErrorIndex
public void setErrorIndex(int errorIndex)
Sets the index of the error in the command.- Parameters:
errorIndex
- the index of the error, or -1 if no error
-
getErrorIndex
public int getErrorIndex()
Returns the index of the error in the command.- Returns:
- the index of the error, or -1 if no error
-
getArgsDesc
public java.util.List<ArgDesc> getArgsDesc()
Returns the descriptions of the command's arguments.- Returns:
- the descriptions of the command's arguments
-
optionWithValue
public boolean optionWithValue(java.lang.String option)
Returns whether the specified option takes a value.- Parameters:
option
- the option to check- Returns:
- true if the option takes a value, false otherwise
-
optionDescription
public AttributedString optionDescription(java.lang.String key)
Returns the description of the specified option.- Parameters:
key
- the option key- Returns:
- the description of the option, or an empty string if the option has no description
-
-