feat: implement guild fetch role

changelog/1247.feature.rst

@@ -0,0 +1 @@
+Implement the new :meth:`.Guild.fetch_role` API method.

disnake/guild.py

@@ -3581,6 +3581,34 @@ async def delete_emoji(self, emoji: Snowflake, *, reason: Optional[str] = None)
         """
         await self._state.http.delete_custom_emoji(self.id, emoji.id, reason=reason)
 
+    async def fetch_role(self, role_id: Union[int, Object]) -> Role:
+        """|coro|
+
+        Retrieve a :class:`Role`.
+
+        .. note::
+
+            This method is an API call. For general usage, consider :meth:`get_role` or :attr:`roles` instead.
+
+        .. versionadded:: 2.10
+
+
+        Raises
+        ------
+        HTTPException
+            Retrieving the role failed.
+
+        Returns
+        -------
+        :class:`Role`
+            The retrieved role.
+        """
+        data = await self._state.http.get_role(
+            self.id,
+            role_id=(role_id if isinstance(role_id, int) else role_id.id),
+        )
+        return Role(guild=self, state=self._state, data=data)
+
     async def fetch_roles(self) -> List[Role]:
         """|coro|
 

disnake/http.py

@@ -1922,6 +1922,11 @@ def delete_invite(self, invite_id: str, *, reason: Optional[str] = None) -> Resp
 
     # Role management
 
+    def get_role(self, guild_id: Snowflake, *, role_id: Snowflake) -> Response[role.Role]:
+        return self.request(
+            Route("GET", "/guilds/{guild_id}/roles/{role_id}", guild_id=guild_id, role_id=role_id)
+        )
+
     def get_roles(self, guild_id: Snowflake) -> Response[List[role.Role]]:
         return self.request(Route("GET", "/guilds/{guild_id}/roles", guild_id=guild_id))