[Python-checkins] gh-91217: deprecate sunau (GH-91866)

[brettcannon]

https://github.com/python/cpython/commit/d174ebe91ebc9f7388a22cc81cdc5f7be8bb8c9b
commit: d174ebe91ebc9f7388a22cc81cdc5f7be8bb8c9b
branch: main
author: Brett Cannon <brett at python.org>
committer: brettcannon <brett at python.org>
date: 2022-04-25T16:26:43-07:00
summary:

gh-91217: deprecate sunau (GH-91866)

files:
A Misc/NEWS.d/next/Library/2022-04-17-12-38-31.gh-issue-91217.55714p.rst
M Doc/whatsnew/3.11.rst
M Lib/sunau.py
M Lib/test/test_ossaudiodev.py
M Lib/test/test_sunau.py

diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst
index ebaa1e993e276..8f0d3c7c7099a 100644
--- a/Doc/whatsnew/3.11.rst
+++ b/Doc/whatsnew/3.11.rst
@@ -1068,6 +1068,7 @@ Deprecated
   * :mod:`pipes`
   * :mod:`sndhdr`
   * :mod:`spwd`
+  * :mod:`sunau`
 
   (Contributed by Brett Cannon in :issue:`47061`.)
 
diff --git a/Lib/sunau.py b/Lib/sunau.py
index 9b3533d930676..94c42f1582c02 100644
--- a/Lib/sunau.py
+++ b/Lib/sunau.py
@@ -106,6 +106,8 @@
 from collections import namedtuple
 import warnings
 
+warnings._deprecated(__name__, remove=(3, 13))
+
 
 _sunau_params = namedtuple('_sunau_params',
                            'nchannels sampwidth framerate nframes comptype compname')
diff --git a/Lib/test/test_ossaudiodev.py b/Lib/test/test_ossaudiodev.py
index 3275333545882..2cc641a49b63a 100644
--- a/Lib/test/test_ossaudiodev.py
+++ b/Lib/test/test_ossaudiodev.py
@@ -9,10 +9,10 @@
     warnings.simplefilter("ignore", DeprecationWarning)
     ossaudiodev = import_helper.import_module('ossaudiodev')
 audioop = warnings_helper.import_deprecated('audioop')
+sunau = warnings_helper.import_deprecated('sunau')
 
 import errno
 import sys
-import sunau
 import time
 import unittest
 
diff --git a/Lib/test/test_sunau.py b/Lib/test/test_sunau.py
index e65742b69f2e9..40408b01eda9a 100644
--- a/Lib/test/test_sunau.py
+++ b/Lib/test/test_sunau.py
@@ -3,9 +3,9 @@
 import io
 import struct
 import sys
-import sunau
 from test.support import warnings_helper
 
+sunau = warnings_helper.import_deprecated("sunau")
 audioop = warnings_helper.import_deprecated("audioop")
 
 
diff --git a/Misc/NEWS.d/next/Library/2022-04-17-12-38-31.gh-issue-91217.55714p.rst b/Misc/NEWS.d/next/Library/2022-04-17-12-38-31.gh-issue-91217.55714p.rst
new file mode 100644
index 0000000000000..4cebfc4222d4c
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2022-04-17-12-38-31.gh-issue-91217.55714p.rst
@@ -0,0 +1 @@
+Deprecate the sunau module.