✨ Implement and document AuditLogDiff.communication_disabled_until

Author: Paillat-dev

discord/audit_logs.py

@@ -25,6 +25,7 @@
 
 from __future__ import annotations
 
+import datetime
 from typing import TYPE_CHECKING, Any, Callable, ClassVar, Generator, TypeVar
 
 from . import enums, utils
@@ -44,8 +45,6 @@
 
 
 if TYPE_CHECKING:
-    import datetime
-
     from . import abc
     from .emoji import GuildEmoji
     from .guild import Guild
@@ -209,6 +208,14 @@ def _transform_trigger_metadata(
         return AutoModTriggerMetadata.from_dict(data)
 
 
+def _transform_communication_disabled_until(
+    entry: AuditLogEntry, data: str
+) -> datetime.datetime | None:
+    if data:
+        return datetime.datetime.fromisoformat(data)
+    return None
+
+
 class AuditLogDiff:
     def __len__(self) -> int:
         return len(self.__dict__)
@@ -281,6 +288,7 @@ class AuditLogChanges:
         "trigger_metadata": (None, _transform_trigger_metadata),
         "exempt_roles": (None, _transform_roles),
         "exempt_channels": (None, _transform_channels),
+        "communication_disabled_until": (None, _transform_communication_disabled_until),
     }
 
     def __init__(

docs/api/audit_logs.rst

@@ -524,11 +524,17 @@ this goal, it must make use of a couple of data classes that aid in this goal.
 
         :type: :class:`str`
 
-   .. attribute:: image
+    .. attribute:: image
 
-      The cover image of a :class:`ScheduledEvent`.
+        The cover image of a :class:`ScheduledEvent`.
 
-      :type: :class:`str`
+        :type: :class:`str`
+
+    .. attribute:: communication_disabled_until
+
+        Until when a :class:`Member` will be timed out
+
+        :type: :class:`datetime.datetime` | :data:`None`
 
 .. this is currently missing the following keys: reason and application_id
    I'm not sure how to about porting these