✨ Rewrote command registration and added cogs

docs/api/cog.rst

@@ -0,0 +1,14 @@
+
+.. currentmodule:: pincer.cog
+
+Pincer Cog Module
+=================
+
+cog
+---
+.. attributetable:: Cog
+.. autoclass:: Cog()
+
+.. autofunction:: load_cog
+.. autofunction:: load_module
+.. autofunction:: reload_cog

docs/api/commands.rst

@@ -67,4 +67,11 @@ Command Groups
 .. currentmodule:: pincer.commands.groups
 
 .. autoclass:: Group()
-.. autoclass:: Subgroup()
+.. autoclass:: Subgroup()
+
+Interactable Objects
+~~~~~~~~~~~~~~~~~~~~
+.. currentmodule:: pincer.commands.interactable
+
+.. attributetable:: Interactable
+.. autoclass:: Interactable()

docs/api/index.rst

@@ -8,6 +8,7 @@ The Full Pincer API Referance
 
     pincer
     core
+    cog
     commands
     middleware
     objects/index

docs/api/objects/app.rst

@@ -51,12 +51,12 @@ AppCommand
 
 .. autoclass:: AppCommand()
 
-ClientCommandStructure
+InteractableStructure
 ~~~~~~~~~~~~~~~~~~~~~~
 
-.. attributetable:: ClientCommandStructure
+.. attributetable:: InteractableStructure
 
-.. autoclass:: ClientCommandStructure()
+.. autoclass:: InteractableStructure()
 
 Intents
 -------

docs/api/pincer.rst

@@ -13,6 +13,7 @@ Client
 
 .. autoclass:: Client
     :exclude-members: event
+    :inherited-members:
 
     .. automethod:: Client.event()
         :decorator:

examples/basic_cogs/cogs.py

@@ -0,0 +1,38 @@
+from typing import Any, Dict, List
+from pincer import Client, Cog, command
+from pincer.objects import MessageContext, Embed
+
+
+class ErrorHandler(Cog):
+    @Client.event
+    async def on_command_error(
+        self,
+        ctx: MessageContext,
+        error: Exception,
+        args: List[Any],
+        kwargs: Dict[str, Any]
+    ):
+        return Embed(
+            "Oops...",
+            "An error occurred while trying to execute the "
+            f"`{ctx.interaction.data.name}` command! Please retry later!",
+            color=0xff0000
+        ).add_field(
+            "Exception:",
+            f"```\n{type(error).__name__}:\n{error}\n```"
+        )
+
+
+class OnReadyCog(Cog):
+    @Client.event
+    async def on_ready(self):
+        print(
+            f"Started client on {self.client.bot}\n"
+            "Registered commands: " + ", ".join(self.client.chat_commands)
+        )
+
+
+class SayCog(Cog):
+    @command(description="Say something as the bot!")
+    async def say(self, ctx: MessageContext, message: str):
+        return Embed(description=f"{ctx.author.mention} said:\n{message}")

examples/basic_cogs/run.py

@@ -1,18 +1,13 @@
-from glob import glob
-
 from pincer import Client
 
+from cogs import OnReadyCog, SayCog, ErrorHandler
+
 
 class Bot(Client):
     def __init__(self, *args, **kwargs):
-        self.load_cogs()
+        super().load_cogs(OnReadyCog, SayCog, ErrorHandler)
         super().__init__(*args, **kwargs)
 
-    def load_cogs(self):
-        """Load all cogs from the `cogs` directory."""
-        for cog in glob("cogs/*.py"):
-            self.load_cog(cog.replace("/", ".").replace("\\", ".")[:-3])
-
 
 if __name__ == "__main__":
     Bot("XXXYOURBOTTOKENHEREXXX").run()

pincer/__init__.py

@@ -11,6 +11,7 @@
 
 from ._config import GatewayConfig
 from .client import event_middleware, Client, Bot
+from .cog import Cog
 from .commands import command, ChatCommandHandler
 from .exceptions import (
     PincerError, InvalidPayload, UnhandledException, NoExportMethod,
@@ -59,7 +60,7 @@ def __repr__(self) -> str:
 __version__ = repr(version_info)
 
 __all__ = (
-    "BadRequestError", "Bot", "ChatCommandHandler", "Client",
+    "BadRequestError", "Bot", "ChatCommandHandler", "Client", "Cog",
     "CogAlreadyExists", "CogError", "CogNotFound", "CommandAlreadyRegistered",
     "CommandCooldownError", "CommandDescriptionTooLong", "CommandError",
     "CommandIsNotCoroutine", "CommandReturnIsEmpty", "DisallowedIntentsError",