Syntrel/cogs/help.py

import discord
from discord import app_commands
from discord.ext import commands
from discord.ext.commands import Context


class Help(commands.Cog, name="help"):
    def __init__(self, bot) -> None:
        self.bot = bot

    async def category_autocomplete(
        self,
        interaction: discord.Interaction,
        current: str,
    ) -> list[app_commands.Choice[str]]:
        categories = ["general", "fun", "moderation", "owner", "sidestore", "idevice", "miscellaneous", "utilities"]
        
        suggestions = []
        for category in categories:
            if current.lower() in category.lower():
                suggestions.append(
                    app_commands.Choice(
                        name=f"{category.capitalize()} Commands",
                        value=category
                    )
                )
        
        return suggestions[:25]

    @commands.hybrid_command(
        name="help", description="List all commands the bot has loaded."
    )
    @app_commands.allowed_contexts(guilds=True, dms=True, private_channels=True)
    @app_commands.allowed_installs(guilds=True, users=True)
    @app_commands.describe(category="Choose a specific category to view its commands")
    @app_commands.autocomplete(category=category_autocomplete)
    async def help(self, context: Context, category: str = None) -> None:
        
        category_mapping = {
            # General Commands
            "general": "general",
            
            # Fun Commands
            "fun": "fun",
            
            # idevice Commands
            "idevice": "idevice",
            
            # Moderation Commands
            "kick": "moderation",
            "ban": "moderation",
            "nick": "moderation",
            "purge": "moderation",
            "hackban": "moderation",
            "warnings": "moderation",
            "archive": "moderation",
            
            # SideStore Commands
            "sidestore": "sidestore",
            "refresh": "sidestore",
            "code": "sidestore",
            "crash": "sidestore",
            "pairing": "sidestore",
            "server": "sidestore",
            "half": "sidestore",
            "sparse": "sidestore",
            "afc": "sidestore",
            "udid": "sidestore",
            
            # Owner Commands
            "sync": "owner",
            "cog_management": "owner",
            "shutdown": "owner",
            "say": "owner",
            "invite": "owner",
            "logs": "owner",
            
            # Utilities Commands
            "translate": "utilities",
            
            # Miscellaneous Commands
            "keanu": "miscellaneous",
            "labubu": "miscellaneous",
            "piracy": "miscellaneous",
            "tryitandsee": "miscellaneous",
            "rr": "miscellaneous",
        }
        
        category_descriptions = {
            "general": "General commands",
            "fun": "Fun commands", 
            "moderation": "Administration commands",
            "owner": "Owner commands",
            "sidestore": "SideStore troubleshooting commands",
            "idevice": "idevice troubleshooting commands",
            "utilities": "Utility commands",
            "miscellaneous": "Miscellaneous commands"
        }
        
        if category is None:
            embed = discord.Embed(
                title="Help", 
                color=0x7289DA
            )
            embed.set_author(name="Help", icon_url="https://yes.nighty.works/raw/T9mnBO.png")
            
            available_categories = set()
            for cog_name in self.bot.cogs:
                mapped_category = category_mapping.get(cog_name.lower())
                if mapped_category:
                    available_categories.add(mapped_category)
            
            category_list = []
            for cat in sorted(available_categories):
                description = category_descriptions.get(cat, f"{cat.capitalize()} commands")
                category_list.append(f"**/help {cat}** » {description}")
            
            if category_list:
                embed.add_field(
                    name="", 
                    value="\n".join(category_list), 
                    inline=False
                )
            
            if context.interaction:
                await context.interaction.response.send_message(embed=embed, ephemeral=True)
            else:
                await context.author.send(embed=embed)
            return
        
        category = category.lower()
        if category not in category_descriptions:
            embed = discord.Embed(
                title="Error",
                description=f"Category '{category}' not found. Use `/help` to see available categories.",
                color=0x7289DA
            )
            if context.interaction:
                await context.interaction.response.send_message(embed=embed, ephemeral=True)
            else:
                await context.author.send(embed=embed)
            return
        
        
        commands_in_category = []
        seen_names = set()
        for cog_name in self.bot.cogs:
            if category_mapping.get(cog_name.lower()) == category:
                cog = self.bot.get_cog(cog_name)
                if cog:
                    commands_list = cog.get_commands()
                    for command in commands_list:
                        name = command.name
                        if name in seen_names:
                            continue
                        description = command.description.partition("\n")[0] if command.description else "No description available"
                        commands_in_category.append((name, description))
                        seen_names.add(name)

        for app_command in self.bot.tree.get_commands():
            bound_cog = getattr(app_command, "binding", None)
            if bound_cog is None:
                continue
            bound_cog_name = getattr(bound_cog, "qualified_name", "").lower()
            if category_mapping.get(bound_cog_name) != category:
                continue
            if app_command.name in seen_names:
                continue
            description = app_command.description.partition("\n")[0] if getattr(app_command, "description", None) else "No description available"
            commands_in_category.append((app_command.name, description))
            seen_names.add(app_command.name)
            
            if hasattr(app_command, 'commands') and category in ["fun", "general", "idevice"]:
                for subcommand in app_command.commands:
                    if subcommand.name in seen_names:
                        continue
                    sub_desc = subcommand.description.partition("\n")[0] if getattr(subcommand, "description", None) else "No description available"
                    commands_in_category.append((f"{app_command.name} {subcommand.name}", sub_desc))
                    seen_names.add(f"{app_command.name} {subcommand.name}")
        
        if not commands_in_category:
            embed = discord.Embed(
                title="Error",
                description=f"No commands found in category '{category}'.",
                color=0x7289DA
            )
            if context.interaction:
                await context.interaction.response.send_message(embed=embed, ephemeral=True)
            else:
                await context.author.send(embed=embed)
            return
        
        embed = discord.Embed(
            title=f"/help » {category.lower()}",
            color=0x7289DA
        )
        embed.set_author(name="Help", icon_url="https://yes.nighty.works/raw/T9mnBO.png")
        data = []
        for command_name, description in sorted(commands_in_category):
            data.append(f"**/{command_name}** » {description}")
        help_text = "\n".join(data)
        embed.add_field(
            name="", 
            value=help_text, 
            inline=False
        )
        if context.interaction:
            await context.interaction.response.send_message(embed=embed, ephemeral=True)
        else:
            await context.author.send(embed=embed)


async def setup(bot) -> None:
    await bot.add_cog(Help(bot))