Method _build_command_info

cmd2/cmd2.py:4236–4260

Categorizes and sorts visible commands and help topics for display. :return: tuple containing: - dictionary mapping category names to lists of command names - list of help topic names that are not also commands

(self)

        return completer.complete_subcommand_help(text, line, begidx, endidx, arg_tokens["subcommands"])

    def _build_command_info(self) -> tuple[dict[str, list[str]], list[str]]:
        """Categorizes and sorts visible commands and help topics for display.

        :return: tuple containing:
                  - dictionary mapping category names to lists of command names
                  - list of help topic names that are not also commands
        """
        # Get a sorted list of help topics
        help_topics = sorted(self.get_help_topics(), key=utils.DEFAULT_STR_SORT_KEY)

        # Get a sorted list of visible command names
        visible_commands = sorted(self.get_visible_commands(), key=utils.DEFAULT_STR_SORT_KEY)
        cmds_cats: dict[str, list[str]] = {}

        for command in visible_commands:
            # Prevent the command from showing as both a command and help topic in the output
            if command in help_topics:
                help_topics.remove(command)

            # Store the command within its category
            command_func = cast(BoundCommandFunc, self.get_command_func(command))
            category = self._get_command_category(command_func)
            cmds_cats.setdefault(category, []).append(command)

        return cmds_cats, help_topics

    @classmethod
    def _build_help_parser(cls) -> Cmd2ArgumentParser: