adds support for file system path protocol (PEP 519)

Author: bastibe

soundfile.py

@@ -614,6 +614,9 @@ def __init__(self, file, mode='r', samplerate=None, channels=None,
         >>> assert myfile.closed
 
         """
+        # resolve PathLike objects (see PEP519 for details):
+        # can be replaced with _os.fspath(file) for Python >= 3.6
+        file = file.__fspath__() if hasattr(file, '__fspath__') else file
         self._name = file
         if mode is None:
             mode = getattr(file, 'mode', None)

tests/test_pysoundfile.py

@@ -21,8 +21,11 @@
 filename_new = 'tests/delme.please'
 
 
-open_variants = 'name', 'fd', 'obj'
-
+if sys.version_info >= (3, 6):
+    import pathlib
+    open_variants = 'name', 'fd', 'obj', 'pathlib'
+else:
+    open_variants = 'name', 'fd', 'obj'
 
 xfail_from_buffer = pytest.mark.xfail(cffi.__version_info__ < (0, 9),
                                       reason="from_buffer() since CFFI 0.9")
@@ -31,6 +34,8 @@
 def _file_existing(request, filename, fdarg, objarg=None):
     if request.param == 'name':
         return filename
+    if request.param == 'pathlib':
+        return pathlib.Path(filename)
     elif request.param == 'fd':
         fd = os.open(filename, fdarg)
 
@@ -660,7 +665,8 @@ def test_seek_in_rplus_mode(sf_stereo_rplus):
 
 @pytest.mark.parametrize("use_default", [True, False])
 def test_truncate(file_stereo_rplus, use_default):
-    if isinstance(file_stereo_rplus, (str, int)):
+    if (isinstance(file_stereo_rplus, (str, int))
+            or hasattr(file_stereo_rplus, '__fspath__')):
         with sf.SoundFile(file_stereo_rplus, 'r+', closefd=False) as f:
             if use_default:
                 f.seek(2)