feat: add send_voice_messages permission (#1006)

Signed-off-by: arl <me@arielle.codes>
Co-authored-by: shiftinv <8530778+shiftinv@users.noreply.github.com>

changelog/1006.feature.rst

@@ -0,0 +1,6 @@
+Add new permission fields.
+- :attr:`Permissions.manage_guild_expressions` (which :attr:`~Permissions.manage_emojis` and :attr:`~Permissions.manage_emojis_and_stickers` are now aliased to)
+- :attr:`Permissions.view_creator_monetization_analytics`
+- :attr:`Permissions.use_soundboard`
+- :attr:`Permissions.send_voice_messages`
+- :attr:`Permissions.use_external_sounds`

changelog/989.feature.rst

@@ -2,4 +2,5 @@ Add new permission fields.
 - :attr:`Permissions.manage_guild_expressions` (which :attr:`~Permissions.manage_emojis` and :attr:`~Permissions.manage_emojis_and_stickers` are now aliased to)
 - :attr:`Permissions.view_creator_monetization_analytics`
 - :attr:`Permissions.use_soundboard`
+- :attr:`Permissions.send_voice_messages`
 - :attr:`Permissions.use_external_sounds`

changelog/997.feature.rst

@@ -2,4 +2,5 @@ Add new permission fields.
 - :attr:`Permissions.manage_guild_expressions` (which :attr:`~Permissions.manage_emojis` and :attr:`~Permissions.manage_emojis_and_stickers` are now aliased to)
 - :attr:`Permissions.view_creator_monetization_analytics`
 - :attr:`Permissions.use_soundboard`
+- :attr:`Permissions.send_voice_messages`
 - :attr:`Permissions.use_external_sounds`

disnake/abc.py

@@ -769,6 +769,7 @@ def permissions_for(
         # permissions as well
         if not base.send_messages:
             base.send_tts_messages = False
+            base.send_voice_messages = False
             base.mention_everyone = False
             base.embed_links = False
             base.attach_files = False
@@ -864,6 +865,7 @@ async def set_permissions(
         send_messages: Optional[bool] = ...,
         send_messages_in_threads: Optional[bool] = ...,
         send_tts_messages: Optional[bool] = ...,
+        send_voice_messages: Optional[bool] = ...,
         speak: Optional[bool] = ...,
         start_embedded_activities: Optional[bool] = ...,
         stream: Optional[bool] = ...,

disnake/ext/commands/base_core.py

@@ -668,6 +668,7 @@ def default_member_permissions(
     send_messages: bool = ...,
     send_messages_in_threads: bool = ...,
     send_tts_messages: bool = ...,
+    send_voice_messages: bool = ...,
     speak: bool = ...,
     start_embedded_activities: bool = ...,
     stream: bool = ...,

disnake/ext/commands/core.py

@@ -2044,6 +2044,7 @@ def has_permissions(
     send_messages: bool = ...,
     send_messages_in_threads: bool = ...,
     send_tts_messages: bool = ...,
+    send_voice_messages: bool = ...,
     speak: bool = ...,
     start_embedded_activities: bool = ...,
     stream: bool = ...,
@@ -2165,6 +2166,7 @@ def bot_has_permissions(
     send_messages: bool = ...,
     send_messages_in_threads: bool = ...,
     send_tts_messages: bool = ...,
+    send_voice_messages: bool = ...,
     speak: bool = ...,
     start_embedded_activities: bool = ...,
     stream: bool = ...,
@@ -2264,6 +2266,7 @@ def has_guild_permissions(
     send_messages: bool = ...,
     send_messages_in_threads: bool = ...,
     send_tts_messages: bool = ...,
+    send_voice_messages: bool = ...,
     speak: bool = ...,
     start_embedded_activities: bool = ...,
     stream: bool = ...,
@@ -2360,6 +2363,7 @@ def bot_has_guild_permissions(
     send_messages: bool = ...,
     send_messages_in_threads: bool = ...,
     send_tts_messages: bool = ...,
+    send_voice_messages: bool = ...,
     speak: bool = ...,
     start_embedded_activities: bool = ...,
     stream: bool = ...,

disnake/permissions.py

@@ -196,6 +196,7 @@ def __init__(
         send_messages: bool = ...,
         send_messages_in_threads: bool = ...,
         send_tts_messages: bool = ...,
+        send_voice_messages: bool = ...,
         speak: bool = ...,
         start_embedded_activities: bool = ...,
         stream: bool = ...,
@@ -314,7 +315,7 @@ def all_channel(cls) -> Self:
             Added :attr:`use_embedded_activities` permission.
 
         .. versionchanged:: 2.9
-            Added :attr:`use_soundboard` permission.
+            Added :attr:`use_soundboard` and :attr:`send_voice_messages` permissions.
         """
         instance = cls.all()
         instance.update(
@@ -392,6 +393,9 @@ def text(cls) -> Self:
         .. versionchanged:: 2.0
            Added :attr:`create_public_threads`, :attr:`create_private_threads`, :attr:`manage_threads`,
            :attr:`send_messages_in_threads` and :attr:`use_external_stickers` permissions.
+
+        .. versionchanged:: 2.9
+            Added :attr:`send_voice_messages` permission.
         """
         return cls(
             send_messages=True,
@@ -409,6 +413,7 @@ def text(cls) -> Self:
             read_message_history=True,
             send_tts_messages=True,
             use_slash_commands=True,
+            send_voice_messages=True,
         )
 
     @classmethod
@@ -559,6 +564,7 @@ def update(
         send_messages: bool = ...,
         send_messages_in_threads: bool = ...,
         send_tts_messages: bool = ...,
+        send_voice_messages: bool = ...,
         speak: bool = ...,
         start_embedded_activities: bool = ...,
         stream: bool = ...,
@@ -980,6 +986,14 @@ def use_external_sounds(self) -> int:
         """
         return 1 << 45
 
+    @flag_value
+    def send_voice_messages(self) -> int:
+        """:class:`bool`: Returns ``True`` if a user can send voice messages.
+
+        .. versionadded:: 2.9
+        """
+        return 1 << 46
+
 
 def _augment_from_permissions(cls):
     cls.VALID_NAMES = set(Permissions.VALID_FLAGS)
@@ -1084,6 +1098,7 @@ class PermissionOverwrite:
         send_messages: Optional[bool]
         send_messages_in_threads: Optional[bool]
         send_tts_messages: Optional[bool]
+        send_voice_messages: Optional[bool]
         speak: Optional[bool]
         start_embedded_activities: Optional[bool]
         stream: Optional[bool]
@@ -1147,6 +1162,7 @@ def __init__(
         send_messages: Optional[bool] = ...,
         send_messages_in_threads: Optional[bool] = ...,
         send_tts_messages: Optional[bool] = ...,
+        send_voice_messages: Optional[bool] = ...,
         speak: Optional[bool] = ...,
         start_embedded_activities: Optional[bool] = ...,
         stream: Optional[bool] = ...,
@@ -1277,6 +1293,7 @@ def update(
         send_messages: Optional[bool] = ...,
         send_messages_in_threads: Optional[bool] = ...,
         send_tts_messages: Optional[bool] = ...,
+        send_voice_messages: Optional[bool] = ...,
         speak: Optional[bool] = ...,
         start_embedded_activities: Optional[bool] = ...,
         stream: Optional[bool] = ...,