Add mixer.get_driver

Author: ankith26

buildconfig/stubs/pygame/mixer.pyi

@@ -28,6 +28,7 @@ def pre_init(
 ) -> None: ...
 def quit() -> None: ...
 def get_init() -> Tuple[int, int, int]: ...
+def get_driver() -> str: ...
 def stop() -> None: ...
 def pause() -> None: ...
 def unpause() -> None: ...

docs/reST/ref/mixer.rst

@@ -165,6 +165,18 @@ The following file formats are supported
 
    .. ## pygame.mixer.get_init ##
 
+.. function:: get_driver
+
+   | :sl:`get the name of the current audio backend driver`
+   | :sg:`get_driver() -> str`
+
+   Pygame chooses one of many available audio backend drivers when it is
+   initialized. This returns the internal name used for the backend. This
+   function is intended to be used for getting diagnostic/debugging information.
+   This can be controlled with ``SDL_AUDIODRIVER`` environment variable.
+
+   .. versionadded:: 2.5.0
+
 .. function:: stop
 
    | :sl:`stop playback of all sound channels`

src_c/doc/mixer_doc.h

@@ -4,6 +4,7 @@
 #define DOC_MIXER_PREINIT "pre_init(frequency=44100, size=-16, channels=2, buffer=512, devicename=None, allowedchanges=AUDIO_ALLOW_FREQUENCY_CHANGE | AUDIO_ALLOW_CHANNELS_CHANGE) -> None\npreset the mixer init arguments"
 #define DOC_MIXER_QUIT "quit() -> None\nuninitialize the mixer"
 #define DOC_MIXER_GETINIT "get_init() -> (frequency, format, channels)\ntest if the mixer is initialized"
+#define DOC_MIXER_GETDRIVER "get_driver() -> str\nget the name of the current audio backend driver"
 #define DOC_MIXER_STOP "stop() -> None\nstop playback of all sound channels"
 #define DOC_MIXER_PAUSE "pause() -> None\ntemporarily stop playback of all sound channels"
 #define DOC_MIXER_UNPAUSE "unpause() -> None\nresume paused playback of sound channels"

src_c/mixer.c

@@ -582,6 +582,18 @@ pg_mixer_get_init(PyObject *self, PyObject *_null)
     return Py_BuildValue("(iii)", freq, realform, channels);
 }
 
+static PyObject *
+pg_mixer_get_driver(PyObject *self, PyObject *_null)
+{
+    const char *name = NULL;
+    MIXER_INIT_CHECK();
+    name = SDL_GetCurrentAudioDriver();
+    if (!name) {
+        name = "unknown";
+    }
+    return PyUnicode_FromString(name);
+}
+
 static PyObject *
 pre_init(PyObject *self, PyObject *args, PyObject *keywds)
 {
@@ -1941,6 +1953,8 @@ static PyMethodDef _mixer_methods[] = {
     {"quit", (PyCFunction)mixer_quit, METH_NOARGS, DOC_MIXER_QUIT},
     {"get_init", (PyCFunction)pg_mixer_get_init, METH_NOARGS,
      DOC_MIXER_GETINIT},
+    {"get_driver", (PyCFunction)pg_mixer_get_driver, METH_NOARGS,
+     DOC_MIXER_GETDRIVER},
     {"pre_init", (PyCFunction)pre_init, METH_VARARGS | METH_KEYWORDS,
      DOC_MIXER_PREINIT},
     {"get_num_channels", (PyCFunction)get_num_channels, METH_NOARGS,

src_py/_debug.py

@@ -69,7 +69,14 @@ def default_return(linked=True):
         # pylint: disable=unused-argument
         return (-1, -1, -1)
 
-    from pygame.display import get_driver, get_init as display_init
+    from pygame.display import (
+        get_driver as get_display_driver,
+        get_init as display_init,
+    )
+    from pygame.mixer import (
+        get_driver as get_mixer_driver,
+        get_init as mixer_init,
+    )
     from pygame.base import get_sdl_version
 
     debug_str, *mixer = attempt_import(
@@ -118,9 +125,14 @@ def default_return(linked=True):
     )
 
     if display_init():
-        debug_str += f"Driver:\t\t\t{get_driver()}\n\n"
+        debug_str += f"Display Driver:\t\t\t{get_display_driver()}\n\n"
+    else:
+        debug_str += "Display Driver:\t\t\tDisplay Not Initialized\n\n"
+
+    if mixer_init():
+        debug_str += f"Mixer Driver:\t\t\t{get_mixer_driver()}\n\n"
     else:
-        debug_str += "Driver:\t\t\tDisplay Not Initialized\n\n"
+        debug_str += "Mixer Driver:\t\t\tMixer Not Initialized\n\n"
 
     debug_str += f"Python:\t\t\t{platform.python_implementation()}\n"
 

test/mixer_test.py

@@ -48,6 +48,48 @@ def tearDown(self):
         mixer.quit()
         mixer.pre_init(0, 0, 0, 0)
 
+    def test_get_driver(self):
+        mixer.init()
+        drivers = [
+            pygame.NULL_VIDEODRIVER,
+            "pipewire",
+            "pulseaudio",
+            "alsa",
+            "jack",
+            "sndio",
+            "netbsd",
+            "dsp",
+            "qsa",
+            "audio",
+            "arts",
+            "esd",
+            "nacl",
+            "nas",
+            "wasapi",
+            "directsound",
+            "winmm",
+            "paud",
+            "haiku",
+            "coreaudio",
+            "disk",
+            "fusionsound",
+            "AAudio",
+            "openslES",
+            "android",
+            "ps2",
+            "psp",
+            "vita",
+            "n3ds",
+            "emscripten",
+            "DART",
+        ]
+        driver = mixer.get_driver()
+        self.assertIn(driver, drivers)
+
+        mixer.quit()
+        with self.assertRaises(pygame.error):
+            mixer.get_driver()
+
     def test_init__keyword_args(self):
         # note: this test used to loop over all CONFIGS, but it's very slow..
         mixer.init(**CONFIG)