fix: revisit current cog extender, (docs): add module doc.

Author: i0bs

interactions/__init__.py

@@ -1,4 +1,5 @@
 """
+(interactions)
 discord-interactions
 
 Easy, simple, scalable and modular: a Python API wrapper for interactions.

interactions/api/__init__.py

@@ -1,3 +1,10 @@
+"""
+interactions.api
+
+This section of the library maintains and
+handles all of the Gateway and HTTP
+work.
+"""
 from ..base import *  # noqa: F401 F403
 from .cache import *  # noqa: F401 F403
 from .enums import *  # noqa: F401 F403

interactions/api/models/__init__.py

@@ -1,3 +1,10 @@
+"""
+interactions.api.models
+
+This section of the library maintains
+and stores all of the data defining
+models for dispatched Gateway events.
+"""
 from .channel import *  # noqa: F401 F403
 from .guild import *  # noqa: F401 F403
 from .gw import *  # noqa: F401 F403

interactions/client.py

@@ -581,32 +581,33 @@ async def raw_guild_create(self, guild) -> dict:
         return guild._json
 
 
-class Extension:
-    """
-    A class that allows you to represent "extensions" of your code, or
-    essentially cogs that can be ran independent of the root file in
-    an object-oriented structure.
+# TODO: Implement the rest of cog behaviour when possible.
+# class Extension:
+#     """
+#     A class that allows you to represent "extensions" of your code, or
+#     essentially cogs that can be ran independent of the root file in
+#     an object-oriented structure.
 
-    The structure of an extension:
+#     The structure of an extension:
 
-    .. code-block:: python
+#     .. code-block:: python
 
-        class CoolCode(interactions.Extension):
-            def __init__(self, client):
-                ...
+#         class CoolCode(interactions.Extension):
+#             def __init__(self, client):
+#                 ...
 
-            @self.client.command(
-                type=interactions.ApplicationCommandType.USER,
-                name="User command in cog",
-            )
-            async def cog_user_cmd(self, ctx):
-                ...
+#             @self.client.command(
+#                 type=interactions.ApplicationCommandType.USER,
+#                 name="User command in cog",
+#             )
+#             async def cog_user_cmd(self, ctx):
+#                 ...
 
-        def setup(bot):
-            CoolCode(bot)
-    """
+#         def setup(bot):
+#             CoolCode(bot)
+#     """
 
-    client: Client
+#     client: Client
 
-    def __new__(cls, bot: Client) -> None:
-        cls.client = bot
+#     def __new__(cls, bot: Client) -> None:
+#         cls.client = bot

interactions/models/__init__.py

@@ -1,3 +1,10 @@
+"""
+interactions.models
+
+This section of the library maintains
+and stores all of the data defining
+models for interaction creation events.
+"""
 from .command import *  # noqa: F401 F403
 from .component import *  # noqa: F401 F403
 from .misc import *  # noqa: F401 F403