From ad25250e26ab8ac51c67c8242a63fc8ba275af12 Mon Sep 17 00:00:00 2001
From: Paillat <me@paillat.dev>
Date: Sun, 13 Oct 2024 17:32:10 +0200
Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20Add=20new=20role=20tags=20and=20met?=
 =?UTF-8?q?hods?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 discord/role.py | 69 ++++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 63 insertions(+), 6 deletions(-)

diff --git a/discord/role.py b/discord/role.py
index b403416704..58925f6502 100644
--- a/discord/role.py
+++ b/discord/role.py
@@ -68,22 +68,37 @@ class RoleTags:
         The bot's user ID that manages this role.
     integration_id: Optional[:class:`int`]
         The integration ID that manages the role.
+    subscription_listing_id: Optional[:class:`int`]
+        The subscription SKU and listing ID of the role.
+
+        .. versionadded:: 2.7
     """
 
     __slots__ = (
         "bot_id",
         "integration_id",
+        "subscription_listing_id",
         "_premium_subscriber",
+        "_available_for_purchase",
+        "_guild_connections",
     )
 
     def __init__(self, data: RoleTagPayload):
         self.bot_id: int | None = _get_as_snowflake(data, "bot_id")
         self.integration_id: int | None = _get_as_snowflake(data, "integration_id")
-        # NOTE: The API returns "null" for this if it's valid, which corresponds to None.
+        self.subscription_listing_id: int | None = _get_as_snowflake(
+            data, "subscription_listing_id"
+        )
+        # NOTE: The API returns "null" for this if the following tags True, and doesn't return them at all if False.
+        # However, "null" corresponds to None.
         # This is different from other fields where "null" means "not there".
         # So in this case, a value of None is the same as True.
         # Which means we would need a different sentinel.
         self._premium_subscriber: Any | None = data.get("premium_subscriber", MISSING)
+        self._available_for_purchase: Any | None = data.get(
+            "available_for_purchase", MISSING
+        )
+        self._guild_connections: Any | None = data.get("guild_connections", MISSING)
 
     def is_bot_managed(self) -> bool:
         """Whether the role is associated with a bot."""
@@ -94,13 +109,35 @@ def is_premium_subscriber(self) -> bool:
         return self._premium_subscriber is None
 
     def is_integration(self) -> bool:
-        """Whether the role is managed by an integration."""
+        """Whether the guild manages the role through some form of
+        integrations such as Twitch or trough guild subscriptions.
+        """
         return self.integration_id is not None
 
+    def is_available_for_purchase(self) -> bool:
+        """Whether the role is available for purchase.
+
+        Returns ``True`` if the role is available for purchase,
+        ``False`` if it is not or if the role is not linked to a guild subscription.
+
+        .. versionadded:: 2.7
+        """
+        return self._available_for_purchase is None
+
+    def is_guild_connections_role(self) -> bool:
+        """Whether the role is a guild connections role.
+
+        .. versionadded:: 2.7
+        """
+        return self._guild_connections is None
+
     def __repr__(self) -> str:
         return (
             f"<RoleTags bot_id={self.bot_id} integration_id={self.integration_id} "
-            f"premium_subscriber={self.is_premium_subscriber()}>"
+            f"subscription_listing_id={self.subscription_listing_id} "
+            f"premium_subscriber={self.is_premium_subscriber()} "
+            f"available_for_purchase={self.is_available_for_purchase()} "
+            f"guild_connections={self.is_guild_connections_role()}>"
         )
 
 
@@ -167,7 +204,10 @@ class Role(Hashable):
             operators on the role objects themselves.
 
     managed: :class:`bool`
-        Indicates if the role is managed by the guild. This is true if :meth:`Role.is_integration`, :meth:`Role.is_premium_subscriber`, or :meth:`Role.is_bot_managed` is ``True``.
+        Indicates if the role is managed by the guild.
+        This is true if any of :meth:`Role.is_integration`, :meth:`Role.is_premium_subscriber`,
+        :meth:`Role.is_bot_managed` or :meth:`Role.is_guild_connections_role`
+        are ``True``.
     mentionable: :class:`bool`
         Indicates if the role can be mentioned by users.
     tags: Optional[:class:`RoleTags`]
@@ -286,8 +326,8 @@ def is_premium_subscriber(self) -> bool:
         return self.tags is not None and self.tags.is_premium_subscriber()
 
     def is_integration(self) -> bool:
-        """Whether the role is managed by the guild through some form of
-        integrations such as Twitch.
+        """Whether the guild manages the role through some form of
+        integrations such as Twitch or trough guild subscriptions.
 
         .. versionadded:: 1.6
         """
@@ -305,6 +345,23 @@ def is_assignable(self) -> bool:
             and (me.top_role > self or me.id == self.guild.owner_id)
         )
 
+    def is_available_for_purchase(self) -> bool:
+        """Whether the role is available for purchase.
+
+        Returns ``True`` if the role is available for purchase,
+        ``False`` if it is not or if the role is not linked to a guild subscription.
+
+        .. versionadded:: 2.7
+        """
+        return self.tags is not None and self.tags.is_available_for_purchase()
+
+    def is_guild_connections_role(self) -> bool:
+        """Whether the role is a guild connections role.
+
+        .. versionadded:: 2.7
+        """
+        return self.tags is not None and self.tags.is_guild_connections_role()
+
     @property
     def permissions(self) -> Permissions:
         """Returns the role's permissions."""