Implement app_permissions and fix stuff

discord/commands/context.py

@@ -43,6 +43,7 @@
     from ..member import Member
     from ..message import Message
     from ..user import User
+    from ..permissions import Permissions
     from ..client import ClientUser
     from discord.webhook.async_ import Webhook
 
@@ -158,6 +159,10 @@ def locale(self) -> Optional[str]:
     def guild_locale(self) -> Optional[str]:
         return self.interaction.guild_locale
 
+    @cached_property
+    def app_permissions(self) -> Permissions:
+        return self.interaction.app_permissions
+
     @cached_property
     def me(self) -> Optional[Union[Member, ClientUser]]:
         return self.interaction.guild.me if self.interaction.guild is not None else self.bot.user

discord/ext/commands/converter.py

@@ -62,6 +62,7 @@
     "MessageConverter",
     "PartialMessageConverter",
     "TextChannelConverter",
+    "ForumChannelConverter",
     "InviteConverter",
     "GuildConverter",
     "RoleConverter",

discord/interactions.py

@@ -54,7 +54,6 @@
 
     from .channel import (
         CategoryChannel,
-        PartialMessageable,
         StageChannel,
         TextChannel,
         VoiceChannel,
@@ -137,6 +136,7 @@ class Interaction:
         "custom_id",
         "_message_data",
         "_permissions",
+        "_app_permissions",
         "_state",
         "_session",
         "_original_message",
@@ -163,6 +163,7 @@ def _from_data(self, data: InteractionPayload):
         self.locale: Optional[str] = data.get("locale")
         self.guild_locale: Optional[str] = data.get("guild_locale")
         self.custom_id: Optional[str] = self.data.get("custom_id") if self.data is not None else None
+        self._app_permissions: int = int(data.get("app_permissions"))
 
         self.message: Optional[Message] = None
 
@@ -233,6 +234,11 @@ def permissions(self) -> Permissions:
         """
         return Permissions(self._permissions)
 
+    @property
+    def app_permissions(self) -> Permissions:
+        """:class:`Permissions`: The resolved permissions of the application in the channel, including overwrites."""
+        return Permissions(self._app_permissions)
+
     @utils.cached_slot_property("_cs_response")
     def response(self) -> InteractionResponse:
         """:class:`InteractionResponse`: Returns an object responsible for handling responding to the interaction.
@@ -493,13 +499,17 @@ def is_done(self) -> bool:
 
     async def defer(self, *, ephemeral: bool = False, invisible: bool = True) -> None:
         """|coro|
+
         Defers the interaction response.
+
         This is typically used when the interaction is acknowledged
         and a secondary action will be done later.
-        This is can only be used with the following interaction types
+
+        This is can only be used with the following interaction types:
         - :attr:`InteractionType.application_command`
         - :attr:`InteractionType.component`
         - :attr:`InteractionType.modal_submit`
+
         Parameters
         -----------
         ephemeral: :class:`bool`
@@ -511,6 +521,7 @@ async def defer(self, *, ephemeral: bool = False, invisible: bool = True) -> Non
             In the Discord UI, this is represented as the bot thinking of a response. You must
             eventually send a followup message via :attr:`Interaction.followup` to make this thinking state go away.
             This parameter does not apply to interactions of type :attr:`InteractionType.application_command`.
+
         Raises
         -------
         HTTPException

discord/types/interactions.py

@@ -35,6 +35,7 @@
 from .role import Role
 from .snowflake import Snowflake
 from .user import User
+from ..permissions import Permissions
 
 if TYPE_CHECKING:
     from .message import AllowedMentions, Message
@@ -202,6 +203,7 @@ class _InteractionOptional(TypedDict, total=False):
     message: Message
     locale: str
     guild_locale: str
+    app_permissions: Permissions
 
 
 class Interaction(_InteractionOptional):

docs/faq.rst

@@ -53,8 +53,8 @@ instead. Similar to this example: ::
     # good
     await asyncio.sleep(10)
 
-Another common source of blocking for too long is using HTTP requests with the famous module :doc:`req:index`.
-While :doc:`req:index` is an amazing module for non-asynchronous programming, it is not a good choice for
+Another common source of blocking for too long is using HTTP requests with the famous module :doc:`requests:index`.
+While :doc:`requests:index` is an amazing module for non-asynchronous programming, it is not a good choice for
 :mod:`asyncio` because certain requests can block the event loop too long. Instead, use the :doc:`aiohttp <aio:index>` library which
 is installed on the side with this library.