pythongh-105096: Deprecate wave getmarkers() method

Deprecate the getmark(), setmark() and getmarkers() methods of the
Wave_read and Wave_write classes of the wave module.

Doc/library/wave.rst

@@ -127,11 +127,19 @@ module, and don't do anything interesting.
 
    Returns ``None``.
 
+   .. deprecated-removed:: 3.11 3.13
+      The method only existed for compatibility with the :mod:`!aifc` module
+      which has been removed in Python 3.13.
+
 
 .. method:: Wave_read.getmark(id)
 
    Raise an error.
 
+   .. deprecated-removed:: 3.11 3.13
+      The method only existed for compatibility with the :mod:`!aifc` module
+      which has been removed in Python 3.13.
+
 The following two methods define a term "position" which is compatible between
 them, and is otherwise implementation dependent.
 

Doc/whatsnew/3.13.rst

@@ -103,6 +103,9 @@ Optimizations
 Deprecated
 ==========
 
+* :mod:`wave`: Deprecate the ``getmark()``, ``setmark()`` and ``getmarkers()``
+  methods of the :class:`wave.Wave_read` and :class:`wave.Wave_write` classes.
+  (Contributed by Victor Stinner in :gh:`105096`.)
 
 
 Removed

Lib/wave.py

@@ -343,9 +343,13 @@ def getparams(self):
                        self.getcomptype(), self.getcompname())
 
     def getmarkers(self):
+        import warnings
+        warnings._deprecated("Wave_read.getmarkers", remove=(3, 15))
         return None
 
     def getmark(self, id):
+        import warnings
+        warnings._deprecated("Wave_read.getmark", remove=(3, 15))
         raise Error('no marks')
 
     def setpos(self, pos):
@@ -548,12 +552,18 @@ def getparams(self):
               self._nframes, self._comptype, self._compname)
 
     def setmark(self, id, pos, name):
+        import warnings
+        warnings._deprecated("Wave_write.setmark", remove=(3, 15))
         raise Error('setmark() not supported')
 
     def getmark(self, id):
+        import warnings
+        warnings._deprecated("Wave_write.getmark", remove=(3, 15))
         raise Error('no marks')
 
     def getmarkers(self):
+        import warnings
+        warnings._deprecated("Wave_write.getmarkers", remove=(3, 15))
         return None
 
     def tell(self):

Misc/NEWS.d/next/Library/2023-05-30-17-39-03.gh-issue-105096.pw00FW.rst

@@ -0,0 +1,3 @@
+:mod:`wave`: Deprecate the ``getmark()``, ``setmark()`` and ``getmarkers()``
+methods of the :class:`wave.Wave_read` and :class:`wave.Wave_write` classes.
+Patch by Victor Stinner.