cmd2.argparse_completer¶
This module defines the ArgparseCompleter class which provides argparse-based tab completion to cmd2 apps. See the header of argparse_custom.py for instructions on how to use these features.
- class cmd2.argparse_completer.ArgparseCompleter(parser: argparse.ArgumentParser, cmd2_app: cmd2.cmd2.Cmd, *, parent_tokens: Optional[Dict[str, List[str]]] = None)¶
Automatic command line tab completion based on argparse parameters
- complete(text: str, line: str, begidx: int, endidx: int, tokens: List[str], *, cmd_set: Optional[cmd2.command_definition.CommandSet] = None) → List[str]¶
Complete text using argparse metadata
- Parameters
text – the string prefix we are attempting to match (all matches must begin with it)
line – the current input line with leading whitespace removed
begidx – the beginning index of the prefix text
endidx – the ending index of the prefix text
tokens – list of argument tokens being passed to the parser
cmd_set – if tab completing a command, the CommandSet the command’s function belongs to, if applicable. Defaults to None.
- Raises
CompletionError for various types of tab completion errors
- complete_subcommand_help(text: str, line: str, begidx: int, endidx: int, tokens: List[str]) → List[str]¶
Supports cmd2’s help command in the completion of subcommand names :param text: the string prefix we are attempting to match (all matches must begin with it) :param line: the current input line with leading whitespace removed :param begidx: the beginning index of the prefix text :param endidx: the ending index of the prefix text :param tokens: arguments passed to command/subcommand :return: List of subcommand completions
- format_help(tokens: List[str]) → str¶
Supports cmd2’s help command in the retrieval of help text :param tokens: arguments passed to help command :return: help text of the command being queried