Merge branch 'master' into fix-auto-sync

Signed-off-by: Ice Wolfy <44532864+Icebluewolf@users.noreply.github.com>

Author: Icebluewolf

.github/workflows/codeql.yml

@@ -28,10 +28,10 @@ jobs:
       - name: "Checkout repository"
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
       - name: "Initialize CodeQL"
-        uses: github/codeql-action/init@5595ccaf912efad79be6eef63a5619ff05969be3 # v4.37.6
+        uses: github/codeql-action/init@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4.37.7
         with:
           languages: ${{ matrix.language }}
       - name: "Autobuild"
-        uses: github/codeql-action/autobuild@5595ccaf912efad79be6eef63a5619ff05969be3 # v4.37.6
+        uses: github/codeql-action/autobuild@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4.37.7
       - name: "Perform CodeQL Analysis"
-        uses: github/codeql-action/analyze@5595ccaf912efad79be6eef63a5619ff05969be3 # v4.37.6
+        uses: github/codeql-action/analyze@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4.37.7

CHANGELOG.md

@@ -14,7 +14,7 @@ These changes are available on the `master` branch, but have not yet been releas
 
 - Added `Member.vr_status` property.
   ([#3328](https://github.com/Pycord-Development/pycord/pull/3328))
-- Documented `SlashCommandGroup.add_command`.
+- Added `SlashCommandGroup.add_command`.
   ([#3346](https://github.com/Pycord-Development/pycord/pull/3346))
 
 ### Changed
@@ -1839,7 +1839,7 @@ These changes are available on the `master` branch, but have not yet been releas
 [unreleased]: https://github.com/Pycord-Development/pycord/compare/v2.8.1...HEAD
 [2.8.1]: https://github.com/Pycord-Development/pycord/compare/v2.8.0...v2.8.1
 [2.8.0]: https://github.com/Pycord-Development/pycord/compare/v2.7.2...v2.8.0
-[2.8.0rc1]: https://github.com/Pycord-Development/pycord/compare/v2.8.0rc1...v2.8.0rc2
+[2.8.0rc2]: https://github.com/Pycord-Development/pycord/compare/v2.8.0rc1...v2.8.0rc2
 [2.8.0rc1]: https://github.com/Pycord-Development/pycord/compare/v2.7.2...v2.8.0rc1
 [2.7.2]: https://github.com/Pycord-Development/pycord/compare/v2.7.1...v2.7.2
 [2.7.1]: https://github.com/Pycord-Development/pycord/compare/v2.7.0...v2.7.1

discord/abc.py

@@ -351,6 +351,10 @@ def __init__(
         ): ...
 
     def __str__(self) -> str:
+        flags = getattr(self, "flags", None)
+        if flags is not None and getattr(flags, "obfuscated", False):
+            return f"Obfuscated Channel ({self.id})"
+
         return self.name
 
     @property

discord/client.py

@@ -169,6 +169,10 @@ class Client:
         If not given, defaults to a regularly constructed :class:`Intents` class.
 
         .. versionadded:: 1.5
+    capabilities: :class:`GatewayCapabilities`
+        Gateway capabilities to include with the IDENTIFY payload. Defaults to
+        :meth:`GatewayCapabilities.none`. These are mostly undocumented and may not
+        be supported for bot accounts.
     member_cache_flags: :class:`MemberCacheFlags`
         Allows for finer control over how the library caches members.
         If not given, defaults to cache as much as possible with the

discord/flags.py

@@ -35,6 +35,7 @@
     "MessageFlags",
     "AttachmentFlags",
     "PublicUserFlags",
+    "GatewayCapabilities",
     "Intents",
     "MemberCacheFlags",
     "ApplicationFlags",
@@ -588,6 +589,36 @@ def all(self) -> list[UserFlags]:
         ]
 
 
+@fill_with_flags()
+class GatewayCapabilities(BaseFlags):
+    """Wraps Discord gateway capabilities.
+
+    These bits are mostly undocumented and meant for specialized clients. They are
+    sent with the IDENTIFY payload as the ``capabilities`` field.
+
+    Attributes
+    ----------
+    value: :class:`int`
+        The raw capability value. Prefer toggling via the provided attributes.
+    """
+
+    __slots__ = ()
+
+    @classmethod
+    def none(cls) -> GatewayCapabilities:
+        """Creates a :class:`GatewayCapabilities` instance with no bits enabled."""
+
+        self = cls.__new__(cls)
+        self.value = cls.DEFAULT_VALUE
+        return self
+
+    @flag_value
+    def obfuscated_channels(self):
+        """:class:`bool`: Obfuscates channel identifiers in gateway events."""
+
+        return 1 << 15
+
+
 @fill_with_flags()
 class Intents(BaseFlags):
     r"""Wraps up a Discord gateway intent flag.
@@ -1587,6 +1618,12 @@ def hide_media_download_options(self):
         """
         return 1 << 15
 
+    @flag_value
+    def obfuscated(self):
+        """:class:`bool`: Returns ``True`` if the channel is obfuscated by the gateway."""
+
+        return 1 << 17
+
 
 @fill_with_flags()
 class AttachmentFlags(BaseFlags):

discord/gateway.py

@@ -368,6 +368,7 @@ async def from_client(
         ws.session_id = session
         ws.sequence = sequence
         ws._max_heartbeat_timeout = client._connection.heartbeat_timeout
+        ws.capabilities = client._connection.capabilities.value
 
         if client._enable_debug_events:
             ws.send = ws.debug_send
@@ -432,6 +433,9 @@ async def identify(self) -> None:
                 },
                 "compress": True,
                 "large_threshold": 250,
+                "capabilities": (
+                    self.capabilities if hasattr(self, "capabilities") else 0
+                ),
             },
         }
 

discord/state.py

@@ -49,7 +49,7 @@
 from .channel import _channel_factory
 from .emoji import AppEmoji, GuildEmoji
 from .enums import ChannelType, InteractionType, ScheduledEventStatus, Status, try_enum
-from .flags import ApplicationFlags, Intents, MemberCacheFlags
+from .flags import ApplicationFlags, GatewayCapabilities, Intents, MemberCacheFlags
 from .guild import Guild
 from .integrations import _integration_factory
 from .interactions import Interaction
@@ -247,6 +247,18 @@ def __init__(
         self._status: str | None = status
         self._intents: Intents = intents
 
+        capabilities = options.get("capabilities")
+        if capabilities is None:
+            capabilities = GatewayCapabilities.none()
+        elif isinstance(capabilities, int):
+            capabilities = GatewayCapabilities._from_value(capabilities)
+        elif not isinstance(capabilities, GatewayCapabilities):
+            raise TypeError(
+                "capabilities parameter must be GatewayCapabilities or int."
+            )
+
+        self.capabilities: GatewayCapabilities = capabilities
+
         if not intents.members or cache_flags._empty:
             self.store_user = self.create_user  # type: ignore
             self.deref_user = self.deref_user_no_intents  # type: ignore

discord/ui/media_gallery.py

@@ -55,11 +55,6 @@ class MediaGallery(ViewItem[V]):
         The initial items contained in this gallery, up to 10.
     id: Optional[:class:`int`]
         The gallery's ID.
-
-    Attributes
-    ----------
-    items: List[:class:`~discord.MediaGalleryItem`]
-        The list of media items in this gallery.
     """
 
     __item_repr_attributes__: tuple[str, ...] = (

discord/ui/radio_group.py

@@ -46,17 +46,6 @@ class RadioGroup(ModalItem):
     """Represents a UI Radio Group component.
 
     .. versionadded:: 2.8
-
-    Attributes
-    ----------
-    custom_id: Optional[:class:`str`]
-        The ID of the radio group that gets received during an interaction.
-    options: List[:class:`discord.RadioGroupOption`]
-        A list of options that can be selected from this group. Must provide between 2 and 10 options.
-    required: Optional[:class:`bool`]
-        Whether an option selection is required or not. Defaults to ``True``.
-    id: Optional[:class:`int`]
-        The radio group's ID.
     """
 
     __item_repr_attributes__: tuple[str, ...] = (

discord/voice/client.py

@@ -85,12 +85,6 @@ class VoiceClient(VoiceProtocol):
 
     Attributes
     ----------
-    session_id: :class:`str`
-        The voice connection session ID.
-    token: :class:`str`
-        The voice connection token.
-    endpoint: :class:`str`
-        The endpoint we are connecting to.
     channel: Union[:class:`VoiceChannel`, :class:`StageChannel`]
         The channel we are connected to.