chore!: Reflect new TODO work for launch.

Author: i0bs

interactions/api/enums.py

@@ -1,7 +1,7 @@
 # Normal libraries
 from enum import IntEnum
 
-# TODO: Implement this into the new error system at a later point.
+# TODO: post-v4: Implement this into the new error system at a later point.
 # class DefaultErrorType(IntEnum):
 #     """
 #     An enumerable object for the default errors that occur with interaction creation.
@@ -50,7 +50,7 @@ class OpCodeType(IntEnum):
     GUILD_SYNC = 12
 
 
-# TODO: Implement this into the new error system at a later point.
+# TODO: post-v4: Implement this into the new error system at a later point.
 # class WSCloseCodeType(IntEnum):
 #     """
 #     An enumerable object for the Gateway's closing connection codes.
@@ -76,7 +76,7 @@ class OpCodeType(IntEnum):
 #     DISALLOWED_INTENTS = 4014
 
 
-# TODO: Implement this into the new error system at a later point.
+# TODO: post-v4: Implement this into the new error system at a later point.
 # class HTTPResponseType(IntEnum):
 #     """
 #     An enumerable object for the HTTP response codes Discord gives out.
@@ -98,7 +98,7 @@ class OpCodeType(IntEnum):
 #     GATEWAY_UNAVAILABLE = 502
 
 
-# TODO: Implement this into the new error system at a later point.
+# TODO: post-v4: Implement this into the new error system at a later point.
 # class JSONResponseType(IntEnum):
 #     """
 #     An enumerable object for the JSON error response codes Discord gives out.

interactions/api/error.py

@@ -91,8 +91,6 @@ def error(self) -> None:
         _err_val = ""
         _err_unidentifiable = False
         _empty_space = " "
-
-        # TODO: determine need. do we need to override at all?
         _overrided = "message" in self.kwargs
 
         if issubclass(type(self._type), IntEnum):
@@ -269,5 +267,5 @@ def lookup() -> dict:
             20028: "The channel you are writing has hit the write rate limit",
             20031: "Your Stage topic, server name, server description, or channel names contain words that are not allowed",
             20035: "Guild premium subscription level too low"
-            #  TODO: finish dict.
+            #  TODO: post-v4: finish dict.
         }

interactions/api/http.py

@@ -405,10 +405,9 @@ async def send_message(
         if message_reference:
             payload["message_reference"] = message_reference
 
-        # TODO: add attachments to payload.
+        # TODO: post-v4. add attachments to payload.
 
         if isinstance(channel_id, Snowflake):
-            # TODO: Convert HTTP endpoints to support Snowflake model/str as per schema.
             channel_id = int(channel_id)
 
         return await self.create_message(payload, channel_id)

interactions/api/models/guild.py

@@ -190,7 +190,7 @@ class Guild(DictSerializerMixin):
         "nsfw_level",
         "stage_instances",
         "stickers",
-        # TODO: Investigate all of these once Discord has them all documented.
+        # TODO: post-v4: Investigate all of these once Discord has them all documented.
         "guild_hashes",
         "embedded_activities",
         "guild_scheduled_events",

interactions/api/models/guild.pyi

@@ -85,7 +85,7 @@ class Guild(DictSerializerMixin):
     stage_instances: Optional[List[StageInstance]]
     stickers: Optional[List[Sticker]]
 
-    # TODO: Investigate all of these once Discord has them all documented.
+    # TODO: post-v4: Investigate all of these once Discord has them all documented.
     guild_hashes: Any
     embedded_activities: Any
     guild_scheduled_events: Any

interactions/api/models/gw.pyi

@@ -56,7 +56,7 @@ class GuildMembers(DictSerializerMixin):
     not_found: Optional[list]
     presences: Optional[
         List["Presence"]
-    ]  # TODO: Check what this returns, then compare to existing models first.
+    ]
     nonce: Optional[str]
     def __init__(self, **kwargs): ...
 

interactions/api/models/member.py

@@ -39,7 +39,6 @@ class Member(DictSerializerMixin):
         "pending",
         "permissions",
         "communication_disabled_until",
-        # TODO: Investigate what this is for once documented by Discord.
         "hoisted_role",
     )
 

interactions/api/models/member.pyi

@@ -20,5 +20,5 @@ class Member(DictSerializerMixin):
     pending: Optional[bool]
     permissions: Optional[str]
     communication_disabled_until: Optional[str]
-    hoisted_role: Any  # TODO: Investigate what this is for when documented by Discord.
+    hoisted_role: Any  # TODO: post-v4: Investigate what this is for when documented by Discord.
     def __init__(self, **kwargs): ...

interactions/api/models/message.py

@@ -182,6 +182,7 @@ class Message(DictSerializerMixin):
     :ivar Optional[MessageActivity] activity?: Message activity object that's sent by Rich Presence
     :ivar Optional[Application] application?: Application object that's sent by Rich Presence
     :ivar Optional[MessageReference] message_reference?: Data showing the source of a message (crosspost, channel follow, add, pin, or replied message)
+    :ivar Optional[Any] allowed_mentions: The allowed mentions of roles attached in the message.
     :ivar int flags: Message flags
     :ivar Optional[MessageInteraction] interaction?: Message interaction object, if the message is sent by an interaction.
     :ivar Optional[Channel] thread:? The thread that started from this message, if any, with a thread member object embedded.
@@ -216,7 +217,7 @@ class Message(DictSerializerMixin):
         "application",
         "application_id",
         "message_reference",
-        "allowed_mentions",  # TODO: add this to the documentation.
+        "allowed_mentions",
         "flags",
         "referenced_message",
         "interaction",

interactions/api/models/misc.py

@@ -1,3 +1,4 @@
+# TODO: This is post-v4.
 # TODO: Reorganise these models based on which big obj uses little obj
 # TODO: Potentially rename some model references to enums, if applicable
 # TODO: Reorganise mixins to its own thing, currently placed here because circular import sucks.