Go!

changelog/1152.feature.rst

@@ -0,0 +1 @@
+Add raw equivalent of :func:`on_presence_update` - :func:`on_raw_presence_update`.

disnake/enums.py

@@ -1229,6 +1229,9 @@ class Event(Enum):
     """Called when a message has a specific reaction removed from it.
     Represents the :func:`on_reaction_clear_emoji` event.
     """
+    raw_presence_update = "raw_presence_update"
+    """Called when a user's presence changes regardless of the state of the internal member cache.
+    Represents the :func:`on_raw_presence_update` event."""
     raw_reaction_add = "raw_reaction_add"
     """Called when a message has a reaction added regardless of the state of the internal message cache.
     Represents the :func:`on_raw_reaction_add` event.

disnake/raw_models.py

@@ -24,6 +24,7 @@
         MessageReactionRemoveEmojiEvent,
         MessageReactionRemoveEvent,
         MessageUpdateEvent,
+        PresenceUpdateEvent,
         ThreadDeleteEvent,
         TypingStartEvent,
     )
@@ -43,6 +44,7 @@
     "RawThreadMemberRemoveEvent",
     "RawTypingEvent",
     "RawGuildMemberRemoveEvent",
+    "RawPresenceUpdateEvent",
 )
 
 
@@ -446,3 +448,30 @@ class RawGuildMemberRemoveEvent(_RawReprMixin):
     def __init__(self, user: Union[User, Member], guild_id: int) -> None:
         self.user: Union[User, Member] = user
         self.guild_id: int = guild_id
+
+
+class RawPresenceUpdateEvent(_RawReprMixin):
+    """Represents the event payload for an :func:`on_raw_presence_update` event.
+
+    .. versionadded:: 2.10
+
+    Attributes
+    ----------
+    user_id: :class:`int`
+        The ID of the user whose presence was updated.
+    guild_id: :class:`int`
+        The ID of the guild where the user's presence changed.
+    data: :class:`dict`
+        The raw data given by the :ddocs:`gateway <topics/gateway-events#presence-update>`.
+    """
+
+    __slots__ = (
+        "user_id",
+        "guild_id",
+        "data",
+    )
+
+    def __init__(self, data: PresenceUpdateEvent) -> None:
+        self.user_id = int(data["user"]["id"])
+        self.guild_id = int(data["guild_id"])
+        self.data = data

disnake/state.py

@@ -69,6 +69,7 @@
     RawIntegrationDeleteEvent,
     RawMessageDeleteEvent,
     RawMessageUpdateEvent,
+    RawPresenceUpdateEvent,
     RawReactionActionEvent,
     RawReactionClearEmojiEvent,
     RawReactionClearEvent,
@@ -973,13 +974,13 @@ def parse_presence_update(self, data: gateway.PresenceUpdateEvent) -> None:
             _log.debug("PRESENCE_UPDATE referencing an unknown guild ID: %s. Discarding.", guild_id)
             return
 
+        raw = RawPresenceUpdateEvent(data)
+        self.dispatch("raw_presence_update", raw)
+
         user = data["user"]
         member_id = int(user["id"])
         member = guild.get_member(member_id)
         if member is None:
-            _log.debug(
-                "PRESENCE_UPDATE referencing an unknown member ID: %s. Discarding", member_id
-            )
             return
 
         old_member = Member._copy(member)

docs/api/events.rst

@@ -865,6 +865,23 @@ Members
     :param after: The updated member's updated info.
     :type after: :class:`Member`
 
+.. function:: on_raw_presence_update(payload)
+
+    Called when a :class:`User` updates their presence.
+    Unlike :func:`on_presence_update`, this is called regardless of the member cache.
+
+    This is called when one or more of the following things change:
+
+    - status
+    - activity
+
+    This requires :attr:`Intents.presences` and :attr:`Intents.members` to be enabled.
+
+    .. versionadded:: 2.10
+
+    :param payload: The raw event payload data.
+    :type payload: :class:`RawPresenceUpdateEvent`
+
 .. function:: on_user_update(before, after)
 
     Called when a :class:`User` is updated.

docs/api/members.rst

@@ -34,6 +34,14 @@ RawGuildMemberRemoveEvent
 .. autoclass:: RawGuildMemberRemoveEvent()
     :members:
 
+RawPresenceUpdateEvent
+~~~~~~~~~~~~~~~~~~~~~~
+
+.. attributetable:: RawGuildMemberRemoveEvent
+
+.. autoclass:: RawPresenceUpdateEvent()
+    :members:
+
 Events
 ------
 
@@ -45,4 +53,5 @@ Events
 - :func:`on_member_ban(guild, user) <disnake.on_member_ban>`
 - :func:`on_member_unban(guild, user) <disnake.on_member_unban>`
 - :func:`on_presence_update(before, after) <disnake.on_presence_update>`
+- :func:`on_raw_presence_update(payload) <disnake.on_raw_presence_update>`
 - :func:`on_user_update(before, after) <disnake.on_user_update>`

pyproject.toml

@@ -16,6 +16,7 @@ keywords = ["disnake", "discord", "discord api"]
 license = { text = "MIT" }
 dependencies = [
     "aiohttp>=3.7.0,<4.0",
+    "esbonio>=0.16.4",
 ]
 classifiers = [
     "Development Status :: 5 - Production/Stable",