feat: ✨ Implement and document AuditLogDiff.communication_disabled_until (Pycord-Development#2883)

* ✨ Implement and document `AuditLogDiff.communication_disabled_until`

* 📝 CHANGELOG.md

---------

Signed-off-by: Lala Sabathil <[email protected]>
Co-authored-by: Lala Sabathil <[email protected]>
(cherry picked from commit 59d3f38)

Author: Paillat-dev

CHANGELOG.md

@@ -69,6 +69,8 @@ These changes are available on the `master` branch, but have not yet been releas
   ([#2818](https://github.com/Pycord-Development/pycord/pull/2818))
 - Added `Interaction.attachment_size_limit`.
   ([#2854](https://github.com/Pycord-Development/pycord/pull/2854))
+- Added `AuditLogDiff.communication_disabled_until`.
+  ([#2883](https://github.com/Pycord-Development/pycord/pull/2883))
 
 ### Fixed
 

discord/audit_logs.py

@@ -25,6 +25,7 @@
 
 from __future__ import annotations
 
+import datetime
 from functools import cached_property
 from typing import TYPE_CHECKING, Any, Callable, ClassVar, Generator, TypeVar
 
@@ -46,8 +47,6 @@
 
 
 if TYPE_CHECKING:
-    import datetime
-
     from . import abc
     from .emoji import GuildEmoji
     from .guild import Guild
@@ -197,6 +196,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__)
@@ -269,6 +276,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