fix: Add MissingVoiceDependencies

Author: Paillat-dev

discord/errors.py

@@ -64,6 +64,7 @@
     "ApplicationCommandError",
     "CheckFailure",
     "ApplicationCommandInvokeError",
+    "MissingVoiceDependencies",
 )
 
 
@@ -411,3 +412,15 @@ def __init__(self, e: Exception) -> None:
         super().__init__(
             f"Application Command raised an exception: {e.__class__.__name__}: {e}"
         )
+
+
+class MissingVoiceDependencies(RuntimeError):
+    """Raised when required voice dependencies are not installed."""
+
+    def __init__(self, missing: tuple[str, ...]) -> None:
+        self.missing = missing
+        deps = ", ".join(missing)
+        super().__init__(
+            f"{deps} {'is' if len(missing) == 1 else 'are'} required for voice support. "
+            'Install them with "pip install py-cord[voice]".'
+        )

discord/voice/__init__.py

@@ -8,6 +8,12 @@
 :license: MIT, see LICENSE for more details.
 """
 
+from ..errors import MissingVoiceDependencies
+from .utils.dependencies import get_missing_voice_dependencies
+
+if missing := get_missing_voice_dependencies():
+    raise MissingVoiceDependencies(missing=missing)
+
 from ._types import *
 from .client import *
 from .packets import *

tests/voice/test_dependency_behavior.py

@@ -51,11 +51,17 @@ def test_client_warns_once_when_voice_dependencies_are_missing(caplog):
         assert dependency in warnings[0]
 
 
-def test_voice_modules_remain_importable_without_voice_dependencies():
+def test_voice_modules_imports_without_voice_dependencies():
     if not voice_dependencies.get_missing_voice_dependencies():
         pytest.skip("requires an environment without the voice extra")
 
     __import__("discord")
-    __import__("discord.voice")
-    __import__("discord.voice.gateway")
-    __import__("discord.voice.receive.reader")
+
+    with pytes.raises(MissingVoiceDependencies):
+        __import__("discord.voice")
+
+    with pytes.raises(MissingVoiceDependencies):
+        __import__("discord.voice.gateway")
+
+    with pytes.raises(MissingVoiceDependencies):
+        __import__("discord.voice.receive.reader")