Method detach_subcommand

cmd2/argparse_utils.py:832–850

Detach a subcommand from a command at the specified path. :param subcommand_path: sequence of subcommand names leading to the parser hosting the subcommand to be detached. An empty sequence indicates this parser. :param subcommand: name of the subcomm

(self, subcommand_path: Iterable[str], subcommand: str)

            subparsers_action._name_parser_map[alias] = subcommand_parser

    def detach_subcommand(self, subcommand_path: Iterable[str], subcommand: str) -> "Cmd2ArgumentParser":
        """Detach a subcommand from a command at the specified path.

        :param subcommand_path: sequence of subcommand names leading to the parser hosting the
                                subcommand to be detached. An empty sequence indicates this parser.
        :param subcommand: name of the subcommand to detach
        :return: the detached parser
        :raises ValueError: if the command path is invalid or the subcommand doesn't exist
        """
        target_parser = self.find_parser(subcommand_path)
        subparsers_action = target_parser.get_subparsers_action()

        try:
            return cast(
                Cmd2ArgumentParser,
                subparsers_action.remove_parser(subcommand),  # type: ignore[attr-defined]
            )
        except ValueError:
            raise ValueError(f"Subcommand '{subcommand}' does not exist for '{target_parser.prog}'") from None

    def error(self, message: str) -> NoReturn:
        """Override that applies custom formatting to the error message."""