Class 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<org.jline.utils.AttributedString>> optsDesc)
      Creates a new command description with the specified argument and option descriptions.
      CmdDesc​(java.util.List<org.jline.utils.AttributedString> mainDesc, java.util.List<ArgDesc> argsDesc, java.util.Map<java.lang.String,​java.util.List<org.jline.utils.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<org.jline.utils.AttributedString> getMainDesc()
      Returns the main description of the command.
      java.util.TreeMap<java.lang.String,​java.util.List<org.jline.utils.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<org.jline.utils.AttributedString> mainDesc)
      Sets the main description of the command and returns this command description.
      org.jline.utils.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<org.jline.utils.AttributedString> mainDesc)
      Sets the main description of the command.
      void setSubcommand​(boolean subcommand)
      Sets whether this is a subcommand.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • 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<org.jline.utils.AttributedString>> optsDesc)
        Creates a new command description with the specified argument and option descriptions.
        Parameters:
        argsDesc - the descriptions of the command's arguments
        optsDesc - the descriptions of the command's options
      • CmdDesc

        public CmdDesc​(java.util.List<org.jline.utils.AttributedString> mainDesc,
                       java.util.List<ArgDesc> argsDesc,
                       java.util.Map<java.lang.String,​java.util.List<org.jline.utils.AttributedString>> optsDesc)
        Creates a new command description with the specified main description, argument descriptions, and option descriptions.
        Parameters:
        mainDesc - the main description of the command
        argsDesc - the descriptions of the command's arguments
        optsDesc - 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<org.jline.utils.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<org.jline.utils.AttributedString> mainDesc)
        Sets the main description of the command.
        Parameters:
        mainDesc - the main description of the command
      • getMainDesc

        public java.util.List<org.jline.utils.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<org.jline.utils.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 org.jline.utils.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