[Python-checkins] gh-91217: deprecate ossaudiodev (GH-91641)

[miss-islington]

https://github.com/python/cpython/commit/ceea0715df33ae6dc3931670b4b749432d4e9707
commit: ceea0715df33ae6dc3931670b4b749432d4e9707
branch: main
author: Brett Cannon <brett at python.org>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2022-04-17T15:02:36-07:00
summary:

gh-91217: deprecate ossaudiodev (GH-91641)



Automerge-Triggered-By: GH:brettcannon

files:
A Misc/NEWS.d/next/Library/2022-04-17-11-56-17.gh-issue-91217.McJre3.rst
M Doc/whatsnew/3.11.rst
M Lib/test/test_ossaudiodev.py
M Modules/ossaudiodev.c

diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst
index bedf80a72fab5..27a5a0fc3d687 100644
--- a/Doc/whatsnew/3.11.rst
+++ b/Doc/whatsnew/3.11.rst
@@ -884,6 +884,7 @@ Deprecated
   * :mod:`msilib`
   * :mod:`nis`
   * :mod:`nntplib`
+  * :mod:`ossaudiodev`
 
   (Contributed by Brett Cannon in :issue:`47061`.)
 
diff --git a/Lib/test/test_ossaudiodev.py b/Lib/test/test_ossaudiodev.py
index 37d2d1f5ff441..3275333545882 100644
--- a/Lib/test/test_ossaudiodev.py
+++ b/Lib/test/test_ossaudiodev.py
@@ -1,10 +1,13 @@
 from test import support
 from test.support import import_helper, warnings_helper
+import warnings
 support.requires('audio')
 
 from test.support import findfile
 
-ossaudiodev = import_helper.import_module('ossaudiodev')
+with warnings.catch_warnings():
+    warnings.simplefilter("ignore", DeprecationWarning)
+    ossaudiodev = import_helper.import_module('ossaudiodev')
 audioop = warnings_helper.import_deprecated('audioop')
 
 import errno
diff --git a/Misc/NEWS.d/next/Library/2022-04-17-11-56-17.gh-issue-91217.McJre3.rst b/Misc/NEWS.d/next/Library/2022-04-17-11-56-17.gh-issue-91217.McJre3.rst
new file mode 100644
index 0000000000000..86ad05f963cb9
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2022-04-17-11-56-17.gh-issue-91217.McJre3.rst
@@ -0,0 +1 @@
+Deprecate the ossaudiodev module.
diff --git a/Modules/ossaudiodev.c b/Modules/ossaudiodev.c
index 172a6e4297531..3926831e0c0d9 100644
--- a/Modules/ossaudiodev.c
+++ b/Modules/ossaudiodev.c
@@ -1117,6 +1117,13 @@ PyInit_ossaudiodev(void)
 {
     PyObject *m;
 
+    if (PyErr_WarnEx(PyExc_DeprecationWarning,
+                     "'ossaudiodev' is deprecated and slated for removal in "
+                     "Python 3.13",
+                     7)) {
+        return NULL;
+    }
+
     if (PyType_Ready(&OSSAudioType) < 0)
         return NULL;