Method complete

cmd2/cmd2.py:2569–2671

Handle completion for an input line. :param text: the current word that user is typing :param line: current input line :param begidx: beginning index of text :param endidx: ending index of text :param custom_settings: used when not completing the main command

(
        self,
        text: str,
        line: str,
        begidx: int,
        endidx: int,
        custom_settings: utils.CustomCompletionSettings | None = None,
    )

        return dataclasses.replace(completions, _add_opening_quote=_add_opening_quote, _quote_char=_quote_char)

    def complete(
        self,
        text: str,
        line: str,
        begidx: int,
        endidx: int,
        custom_settings: utils.CustomCompletionSettings | None = None,
    ) -> Completions:
        """Handle completion for an input line.

        :param text: the current word that user is typing
        :param line: current input line
        :param begidx: beginning index of text
        :param endidx: ending index of text
        :param custom_settings: used when not completing the main command line
        :return: a Completions object
        """
        try:
            # lstrip the original line
            orig_line = line
            line = orig_line.lstrip()
            num_stripped = len(orig_line) - len(line)

            # Calculate new indexes for the stripped line. If the cursor is at a position before the end of a
            # line of spaces, then the following math could result in negative indexes. Enforce a max of 0.
            begidx = max(begidx - num_stripped, 0)
            endidx = max(endidx - num_stripped, 0)

            # Shortcuts are not word break characters when completing. Therefore, shortcuts become part
            # of the text variable if there isn't a word break, like a space, after it. We need to remove it
            # from text and update the indexes. This only applies if we are at the beginning of the command line.
            shortcut_to_restore = ""
            if begidx == 0 and custom_settings is None:
                for shortcut, _ in self.statement_parser.shortcuts:
                    if text.startswith(shortcut):
                        # Save the shortcut to restore later
                        shortcut_to_restore = shortcut

                        # Adjust text and where it begins
                        text = text[len(shortcut_to_restore) :]
                        begidx += len(shortcut_to_restore)
                        break
                else:
                    # No shortcut was found. Complete the command token.
                    parser = argparse_utils.DEFAULT_ARGUMENT_PARSER(add_help=False)
                    parser.add_argument(
                        "command",
                        metavar="COMMAND",
                        help="command, alias, or macro name",
                        choices=self._get_commands_aliases_and_macros_choices(),
                    )
                    custom_settings = utils.CustomCompletionSettings(parser)

            completions = self._perform_completion(text, line, begidx, endidx, custom_settings)

            # Check if we need to restore a shortcut in the completion text
            # so it doesn't get erased from the command line.
            if completions and shortcut_to_restore: