feat: Implement created_at property for models (#1190)

* feat: Implement `created_at` property for models

* Update message.py

* Update channel.py

* ci: correct from checks.

* fix: id of tag is not Snowflake object

* docs: make id as Snowflake

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: Damego

interactions/api/models/channel.py

@@ -308,20 +308,29 @@ class Tags(ClientSerializerMixin):  # helpers, hehe :D
         If the emoji is custom, it won't have name information.
 
     :ivar str name: Name of the tag. The limit is up to 20 characters.
-    :ivar int id: ID of the tag. Can also be 0 if manually created.
+    :ivar Snowflake id: ID of the tag. Can also be 0 if manually created.
     :ivar bool moderated: A boolean denoting whether this tag can be removed/added by moderators with the :attr:`.Permissions.MANAGE_THREADS` permission.
     :ivar Optional[Emoji] emoji: The emoji to represent the tag, if any.
 
     """
 
     # TODO: Rename these to discord-docs
     name: str = field()
-    id: int = field()
+    id: Snowflake = field(converter=Snowflake)
     moderated: bool = field()
     emoji: Optional[Emoji] = field(converter=Emoji, default=None)
 
     # Maybe on post_attrs_init replace emoji object with one from cache for name population?
 
+    @property
+    def created_at(self) -> datetime:
+        """
+        .. versionadded:: 4.4.0
+
+        Returns when the tag was created.
+        """
+        return self.id.timestamp
+
     async def delete(
         self, channel_id: Union[int, str, Snowflake, "Channel"]  # discord, why :hollow:
     ) -> None:
@@ -577,6 +586,15 @@ def voice_states(self) -> List["VoiceState"]:
         states.extend(state for state in data if state.channel_id == self.id)
         return states
 
+    @property
+    def created_at(self) -> datetime:
+        """
+        .. versionadded:: 4.4.0
+
+        Returns when the channel was created.
+        """
+        return self.id.timestamp
+
     def history(
         self,
         start_at: Optional[Union[int, str, Snowflake, "Message"]] = MISSING,

interactions/api/models/emoji.py

@@ -1,3 +1,4 @@
+from datetime import datetime
 from typing import TYPE_CHECKING, List, Optional, Union
 
 from ...utils.attrs_utils import ClientSerializerMixin, convert_list, define, field
@@ -53,6 +54,15 @@ def format(self) -> str:
             else self.name
         )
 
+    @property
+    def created_at(self) -> datetime:
+        """
+        .. versionadded:: 4.4.0
+
+        Returns when the emoji was created.
+        """
+        return self.id.timestamp
+
     @classmethod
     async def get(
         cls,

interactions/api/models/guild.py

@@ -495,6 +495,53 @@ def __attrs_post_init__(self):  # sourcery skip: last-if-guard
                 ):
                     member._extras["guild_id"] = self.id
 
+    @property
+    def voice_states(self) -> List["VoiceState"]:
+        """
+        .. versionadded:: 4.4.0
+
+        Gets all voice states of the guild.
+
+        :rtype: List[VoiceState]
+        """
+
+        if not self._client:
+            raise LibraryException(code=13)
+
+        from .gw import VoiceState
+
+        states: List[VoiceState] = []
+
+        data = self._client.cache[VoiceState].values.values()
+        states.extend(state for state in data if state.guild_id == self.id)
+        return states
+
+    @property
+    def mapped_voice_states(self) -> Dict[int, List["VoiceState"]]:
+        """
+        .. versionadded:: 4.4.0
+
+        Returns all the voice states mapped after their channel id.
+
+        :rtype: Dict[int, List[VoiceState]]
+        """
+        states = self.voice_states
+        _states: Dict[int, List[VoiceState]] = {int(state.channel_id): [] for state in states}
+
+        for state in states:
+            _states[int(state.channel_id)].append(state)
+
+        return _states
+
+    @property
+    def created_at(self) -> datetime:
+        """
+        .. versionadded:: 4.4.0
+
+        Returns when the guild was created.
+        """
+        return self.id.timestamp
+
     async def ban(
         self,
         member_id: Union[int, Member, Snowflake],
@@ -550,44 +597,6 @@ async def ban(
             if int(member.id) == _member_id:
                 return self.members.remove(member)
 
-    @property
-    def voice_states(self) -> List["VoiceState"]:
-        """
-        .. versionadded:: 4.4.0
-
-        Gets all voice states of the guild.
-
-        :rtype: List[VoiceState]
-        """
-
-        if not self._client:
-            raise LibraryException(code=13)
-
-        from .gw import VoiceState
-
-        states: List[VoiceState] = []
-
-        data = self._client.cache[VoiceState].values.values()
-        states.extend(state for state in data if state.guild_id == self.id)
-        return states
-
-    @property
-    def mapped_voice_states(self) -> Dict[int, List["VoiceState"]]:
-        """
-        .. versionadded:: 4.4.0
-
-        Returns all the voice states mapped after their channel id.
-
-        :rtype: Dict[int, List[VoiceState]]
-        """
-        states = self.voice_states
-        _states: Dict[int, List[VoiceState]] = {int(state.channel_id): [] for state in states}
-
-        for state in states:
-            _states[int(state.channel_id)].append(state)
-
-        return _states
-
     async def remove_ban(
         self,
         user_id: Union[int, Snowflake],  # only support ID since there's no member on the guild

interactions/api/models/message.py

@@ -589,6 +589,15 @@ class PartialSticker(DictSerializerMixin, IDMixin):
     name: str = field()
     format_type: int = field()
 
+    @property
+    def created_at(self) -> datetime:
+        """
+        .. versionadded:: 4.4.0
+
+        Returns when the sticker was created.
+        """
+        return self.id.timestamp
+
 
 @define()
 class Sticker(PartialSticker, IDMixin):
@@ -645,6 +654,15 @@ class StickerPack(DictSerializerMixin, IDMixin):
     description: str = field()
     banned_asset_id: Optional[Snowflake] = field(converter=Snowflake, default=None)
 
+    @property
+    def created_at(self) -> datetime:
+        """
+        .. versionadded:: 4.4.0
+
+        Returns when the sticker pack was created.
+        """
+        return self.id.timestamp
+
 
 @define()
 class ReactionObject(DictSerializerMixin):
@@ -746,6 +764,13 @@ class Message(ClientSerializerMixin, IDMixin):
     )  # deprecated
     position: Optional[int] = field(default=None, repr=False)
 
+    def __attrs_post_init__(self):
+        if self.member and self.guild_id:
+            self.member._extras["guild_id"] = self.guild_id
+
+        if self.author and self.member:
+            self.member.user = self.author
+
     @property
     def deletable(self) -> bool:
         """
@@ -755,12 +780,14 @@ def deletable(self) -> bool:
         """
         return self.type not in self.type.not_deletable()
 
-    def __attrs_post_init__(self):
-        if self.member and self.guild_id:
-            self.member._extras["guild_id"] = self.guild_id
+    @property
+    def created_at(self) -> datetime:
+        """
+        .. versionadded:: 4.4.0
 
-        if self.author and self.member:
-            self.member.user = self.author
+        Returns when the message was created.
+        """
+        return self.id.timestamp
 
     async def get_channel(self) -> Channel:
         """

interactions/api/models/role.py

@@ -1,3 +1,4 @@
+from datetime import datetime
 from typing import TYPE_CHECKING, List, Optional, Union
 
 from ...utils.attrs_utils import ClientSerializerMixin, DictSerializerMixin, define, field
@@ -81,6 +82,15 @@ def mention(self) -> str:
         """
         return f"<@&{self.id}>"
 
+    @property
+    def created_at(self) -> datetime:
+        """
+        .. versionadded:: 4.4.0
+
+        Returns when the role was created.
+        """
+        return self.id.timestamp
+
     async def delete(
         self,
         guild_id: Union[int, Snowflake, "Guild"],

interactions/api/models/team.py

@@ -1,3 +1,4 @@
+from datetime import datetime
 from typing import Any, List, Optional
 
 from ...utils.attrs_utils import ClientSerializerMixin, convert_list, define, field
@@ -117,3 +118,12 @@ def icon_url(self) -> Optional[str]:
         else:
             url = None
         return url
+
+    @property
+    def created_at(self) -> datetime:
+        """
+        .. versionadded:: 4.4.0
+
+        Returns when the application was created.
+        """
+        return self.id.timestamp

interactions/api/models/user.py

@@ -1,3 +1,4 @@
+from datetime import datetime
 from typing import TYPE_CHECKING, List, Optional, Union
 
 from ...utils.attrs_utils import ClientSerializerMixin, define, field
@@ -127,6 +128,15 @@ def presence(self) -> Optional["Presence"]:
 
         return self._client.cache[Presence].get(self.id)
 
+    @property
+    def created_at(self) -> datetime:
+        """
+        .. versionadded:: 4.4.0
+
+        Returns when the user was created.
+        """
+        return self.id.timestamp
+
     async def send(
         self,
         content: Optional[str] = MISSING,

interactions/api/models/webhook.py

@@ -1,5 +1,6 @@
 # versionadded is specified in docs gen file
 
+from datetime import datetime
 from enum import IntEnum
 from typing import TYPE_CHECKING, List, Optional, Union
 
@@ -72,6 +73,15 @@ def __attrs_post_init__(self):
             Channel(**self.source_channel, _client=self._client) if self.source_channel else None
         )
 
+    @property
+    def created_at(self) -> datetime:
+        """
+        .. versionadded:: 4.4.0
+
+        Returns when the webhook was created.
+        """
+        return self.id.timestamp
+
     @classmethod
     async def create(
         cls,