feat: Add presence property to User (#1005)

* feat: Add ``presence`` property to ``User``

* ci: correct from checks.

* make optional

* ref: remove `"` in docstring

Co-authored-by: Max <[email protected]>

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

Author: 3 people

interactions/api/gateway/client.py

@@ -407,6 +407,8 @@ def _dispatch_event(self, event: str, data: dict) -> None:
                 if id is None:
                     if model.__name__ == "GuildScheduledEventUser":
                         id = model.guild_scheduled_event_id
+                    elif model.__name__ == "Presence":
+                        id = obj.user.id
                     elif model.__name__ in [
                         "Invite",
                         "GuildBan",

interactions/api/models/user.py

@@ -1,9 +1,12 @@
-from typing import Optional, Union
+from typing import TYPE_CHECKING, Optional, Union
 
 from .attrs_utils import ClientSerializerMixin, define, field
 from .flags import UserFlags
 from .misc import IDMixin, Snowflake
 
+if TYPE_CHECKING:
+    from .gw import Presence
+
 __all__ = ("User",)
 
 
@@ -96,3 +99,15 @@ def banner_url(self) -> Optional[str]:
         url = f"https://cdn.discordapp.com/banners/{int(self.id)}/{self.banner}"
         url += ".gif" if self.banner.startswith("a_") else ".png"
         return url
+
+    @property
+    def presence(self) -> Optional["Presence"]:
+        """
+        Returns the presence of the user.
+
+        :return: Presence of the user (None will be returned if not cached)
+        :rtype: Optional[Presence]
+        """
+        from .gw import Presence
+
+        return self._client.cache[Presence].get(self.id)