🧑‍💻 Make Client.intents writable

Author: Paillat-dev

discord/client.py

@@ -257,6 +257,7 @@ def __init__(
         self._connection: ConnectionState = self._get_state(**options)
         self._connection.shard_count = self.shard_count
         self._closed: bool = False
+        self._was_connected: bool = False
         self._ready: asyncio.Event = asyncio.Event()
         self._connection._get_websocket = self._get_websocket
         self._connection._get_client = lambda: self
@@ -639,6 +640,7 @@ async def connect(self, *, reconnect: bool = True) -> None:
             "initial": True,
             "shard_id": self.shard_id,
         }
+        self._was_connected = True
         while not self.is_closed():
             try:
                 coro = DiscordWebSocket.from_client(self, **ws_params)
@@ -885,6 +887,30 @@ def intents(self) -> Intents:
         """
         return self._connection.intents
 
+    @intents.setter
+    def intents(self, value: Any) -> None:  # pyright: ignore [reportExplicitAny]
+        """
+        Set the intents for this Client.
+
+        Parameters
+        ----------
+        value: :class:`Intents`
+            The intents to set for this Client.
+
+        Raises
+        ------
+        TypeError
+            The value is not an instance of Intents.
+        R
+        """
+        if not isinstance(value, Intents):
+            raise TypeError(
+                f"Intents must be an instance of Intents not {value.__class__!r}"
+            )
+        if self._was_connected:
+            raise ClientException("Cannot change intents on a running client.")
+        self._connection.intents = value
+
     # helpers/getters
 
     @property

discord/state.py

@@ -334,6 +334,26 @@ def intents(self) -> Intents:
         ret.value = self._intents.value
         return ret
 
+    @intents.setter
+    def intents(self, value: Any) -> None:  # pyright: ignore [reportExplicitAny]
+        """
+        Set the intents for the connection. This can only be set before the connection is
+        started or else the connection will crash.
+
+        Parameters
+        ----------
+        value: :class:`Intents`
+            The intents to use for the connection.
+
+        Raises
+        ------
+        TypeError
+            The value passed is not of type :class:`Intents`.
+        """
+        if not isinstance(value, Intents):
+            raise TypeError(f"Intents must be of type Intents not {value.__class__!r}")
+        self._intents.value = value.value
+
     @property
     def voice_clients(self) -> list[VoiceClient]:
         return list(self._voice_clients.values())