feat(commands): add Context.app_permissions and permissions as a shortcut to permissions_for self and author (#1429)

Signed-off-by: Zenith <[email protected]>
Co-authored-by: vi <[email protected]>

Author: onerandomusername

changelog/1429.feature.rst

@@ -0,0 +1 @@
+|commands| Add :attr:`.Context.app_permissions` and :attr:`.Context.permissions` as a shorthands similar to :attr:`.Interaction.app_permissions` and :attr:`.Interaction.permissions`.

disnake/ext/commands/context.py

@@ -10,6 +10,7 @@
 import disnake.utils
 from disnake import ApplicationCommandInteraction
 from disnake.message import Message
+from disnake.permissions import Permissions
 
 if TYPE_CHECKING:
     from typing_extensions import ParamSpec
@@ -284,6 +285,25 @@ def me(self) -> Union[Member, ClientUser]:
         # bot.user will never be None at this point.
         return self.guild.me if self.guild is not None else self.bot.user
 
+    @disnake.utils.cached_property
+    def app_permissions(self) -> Permissions:
+        """:class:`.Permissions`: Returns the permissions the bot has in the context's channel.
+
+        .. versionadded: |vnext|
+        """
+        # This probably won't ever error.
+        # `permissions_for` exists on all except PartialMessageable, which we shouldn't get here
+        # For other channel types, permissions_for exists on all of them.
+        return self.channel.permissions_for(self.me)  # pyright: ignore[reportArgumentType]
+
+    @disnake.utils.cached_property
+    def permissions(self) -> Permissions:
+        """:class:`.Permissions`: Returns the permissions the author has in the context's channel.
+
+        .. versionadded: |vnext|
+        """
+        return self.channel.permissions_for(self.author)  # pyright: ignore[reportArgumentType]
+
     @property
     def voice_client(self) -> Optional[VoiceProtocol]:
         r""":class:`.VoiceProtocol` | :data:`None`: A shortcut to :attr:`.Guild.voice_client`\, if applicable."""