Method get_root_parser_and_subcmd_path

cmd2/cmd2.py:1168–1197

Tokenize a command string and resolve the associated root parser and relative subcommand path. This helper handles the initial resolution of a command string (e.g., 'foo bar baz') by identifying 'foo' as the root command, retrieving its associated parser, and returning any r

(self, command: str)

                self.detach_subcommand(full_command_name, subcommand_name)

    def get_root_parser_and_subcmd_path(self, command: str) -> tuple[Cmd2ArgumentParser, list[str]]:
        """Tokenize a command string and resolve the associated root parser and relative subcommand path.

        This helper handles the initial resolution of a command string (e.g., 'foo bar baz') by
        identifying 'foo' as the root command, retrieving its associated parser, and returning
        any remaining tokens (['bar', 'baz']) as a path relative to that parser for further traversal.

        :param command: full space-delimited command path leading to a parser (e.g. 'foo' or 'foo bar')
        :return: a tuple containing the Cmd2ArgumentParser for the root command and a list of
                 strings representing the relative path to the desired hosting parser.
        :raises ValueError: if the command is empty, the root command is not found, or
                            the root command does not use an argparse parser.
        """
        tokens = command.split()
        if not tokens:
            raise ValueError("Command path cannot be empty")

        root_command = tokens[0]
        subcommand_path = tokens[1:]

        # Search for the base command function and verify it has an argparser defined
        command_func = self.get_command_func(root_command)
        if command_func is None:
            raise ValueError(f"Root command '{root_command}' does not exist")

        root_parser = self.command_parsers.get(command_func)
        if root_parser is None:
            raise ValueError(f"Command '{root_command}' does not use argparse")

        return root_parser, subcommand_path

    def attach_subcommand(
        self,