feat: implement MessageCall

CHANGELOG.md

@@ -37,6 +37,8 @@ These changes are available on the `master` branch, but have not yet been releas
 - Added `MemberFlags`. ([#2489](https://github.com/Pycord-Development/pycord/pull/2489))
 - Added `bypass_verification` parameter to `Member.edit`.
   ([#2489](https://github.com/Pycord-Development/pycord/pull/2489))
+- Added `MessageCall` information.
+  ([#2488](https://github.com/Pycord-Development/pycord/pull/2488))
 
 ### Fixed
 

discord/message.py

@@ -52,6 +52,7 @@
 from .guild import Guild
 from .member import Member
 from .mixins import Hashable
+from .object import Object
 from .partial_emoji import PartialEmoji
 from .poll import Poll
 from .reaction import Reaction
@@ -80,9 +81,11 @@
     from .types.message import Message as MessagePayload
     from .types.message import MessageActivity as MessageActivityPayload
     from .types.message import MessageApplication as MessageApplicationPayload
+    from .types.message import MessageCall as MessageCallPayload
     from .types.message import MessageReference as MessageReferencePayload
     from .types.message import Reaction as ReactionPayload
     from .types.poll import Poll as PollPayload
+    from .types.snowflake import SnowflakeList
     from .types.threads import ThreadArchiveDuration
     from .types.user import User as UserPayload
     from .ui.view import View
@@ -96,6 +99,7 @@
     "Message",
     "PartialMessage",
     "MessageReference",
+    "MessageCall",
     "DeletedReferencedMessage",
 )
 
@@ -600,6 +604,34 @@ def to_dict(self) -> MessageReferencePayload:
     to_message_reference_dict = to_dict
 
 
+class MessageCall:
+    """Represents information about a call in a private channel.
+
+    .. versionadded:: 2.6
+    """
+
+    def __init__(self, state: ConnectionState, data: MessageCallPayload):
+        self._state: ConnectionState = state
+        self._participants: SnowflakeList = data.get("participants", [])
+        self._ended_timestamp: datetime.datetime | None = utils.parse_time(
+            data["ended_timestamp"]
+        )
+
+    @property
+    def participants(self) -> list[User | Object]:
+        """A list of :class:`User` that participated in this call.
+
+        If a user is not found in the client's cache,
+        then it will be returned as an :class:`Object`
+        """
+        return [self._state.get_user(int(i)) or Object(i) for i in self._participants]
+
+    @property
+    def ended_at(self) -> datetime.datetime | None:
+        """An aware timestamp of when the call ended."""
+        return self._ended_timestamp
+
+
 def flatten_handlers(cls):
     prefix = len("_handle_")
     handlers = [
@@ -747,6 +779,10 @@ class Message(Hashable):
     poll: Optional[:class:`Poll`]
         The poll associated with this message, if applicable.
 
+        .. versionadded:: 2.6
+    call: Optional[:class:`MessageCall`]
+        The call information associated with this message, if applicable.
+
         .. versionadded:: 2.6
     """
 
@@ -785,6 +821,7 @@ class Message(Hashable):
         "interaction_metadata",
         "thread",
         "_poll",
+        "call",
     )
 
     if TYPE_CHECKING:
@@ -895,6 +932,12 @@ def __init__(
         except KeyError:
             self.thread = None
 
+        self.call: MessageCall | None
+        try:
+            self.call = MessageCall(state=self._state, data=data["call"])
+        except KeyError:
+            self.call = None
+
         for handler in ("author", "member", "mentions", "mention_roles"):
             try:
                 getattr(self, f"_handle_{handler}")(data[handler])

discord/types/message.py

@@ -154,3 +154,8 @@ class AllowedMentions(TypedDict):
     roles: SnowflakeList
     users: SnowflakeList
     replied_user: bool
+
+
+class MessageCall(TypedDict):
+    participants: SnowflakeList
+    ended_timestamp: NotRequired[str]

docs/api/data_classes.rst

@@ -49,6 +49,11 @@ Message
 .. autoclass:: MessageReference
     :members:
 
+.. attributetable:: MessageCall
+
+.. autoclass:: MessageCall
+    :members:
+
 .. attributetable:: PartialMessage
 
 .. autoclass:: PartialMessage