gh-75593: Allow opening of path-like files with wave.open

Doc/library/wave.rst

@@ -25,8 +25,9 @@ The :mod:`wave` module defines the following function and exception:
 
 .. function:: open(file, mode=None)
 
- If *file* is a string, open the file by that name, otherwise treat it as a
- file-like object. *mode* can be:
+ If *file* is a string, a :term:`path-like object` or a
+ :term:`bytes-like object` open the file by that name, otherwise treat it as
+ a file-like object. *mode* can be:
 
  ``'rb'``
  Read only mode.
@@ -52,6 +53,10 @@ The :mod:`wave` module defines the following function and exception:
  .. versionchanged:: 3.4
  Added support for unseekable files.
 
+ .. versionchanged:: 3.15
+ Added support for :term:`path-like objects <path-like object>`
+ and :term:`bytes-like objects <bytes-like object>`.
+
 .. exception:: Error
 
  An error raised when something is impossible because it violates the WAV

Lib/test/test_wave.py

@@ -1,9 +1,11 @@
 import unittest
 from test import audiotests
 from test import support
+from test.support.os_helper import FakePath
 import io
 import os
 import struct
+import tempfile
 import sys
 import wave
 
@@ -206,5 +208,25 @@ def test_open_in_write_raises(self):
  self.assertIsNone(cm.unraisable)
 
 
+class WaveOpen(unittest.TestCase):
+ def test_open_pathlike(self):
+ """It is possible to use `wave.read` and `wave.write` with a path-like object"""
+ with tempfile.NamedTemporaryFile(delete_on_close=False) as fp:
+ cases = (
+ FakePath(fp.name),
+ FakePath(os.fsencode(fp.name)),
+ os.fsencode(fp.name),
+ )
+ for fake_path in cases:
+ with self.subTest(fake_path):
+ with wave.open(fake_path, 'wb') as f:
+ f.setnchannels(1)
+ f.setsampwidth(2)
+ f.setframerate(44100)
+
+ with wave.open(fake_path, 'rb') as f:
+ pass
+
+
 if __name__ == '__main__':
  unittest.main()

Lib/wave.py

@@ -69,6 +69,7 @@
 
 from collections import namedtuple
 import builtins
+import os
 import struct
 import sys
 
@@ -274,7 +275,7 @@ def initfp(self, file):
 
  def __init__(self, f):
  self._i_opened_the_file = None
- if isinstance(f, str):
+ if isinstance(f, (bytes, str, os.PathLike)):
  f = builtins.open(f, 'rb')
  self._i_opened_the_file = f
  # else, assume it is an open file object already
@@ -431,7 +432,7 @@ class Wave_write:
 
  def __init__(self, f):
  self._i_opened_the_file = None
- if isinstance(f, str):
+ if isinstance(f, (bytes, str, os.PathLike)):
  f = builtins.open(f, 'wb')
  self._i_opened_the_file = f
  try:

Misc/NEWS.d/next/Library/2025-11-04-12-16-13.gh-issue-75593.EFVhKR.rst

@@ -0,0 +1 @@
+Add support of :term:`path-like objects <path-like object>` and :term:`bytes-like objects <bytes-like object>` in :func:`wave.open`.