WIP: API: Add support for PEP 519 / file system path protocol

pandas/io/common.py

@@ -40,6 +40,13 @@
     _PY_PATH_INSTALLED = False
 
 
+try:
+    from os import fspath, PathLike
+    _OS_FSPATH_INSTALLED = True
+except:
+    _OS_FSPATH_INSTALLED = False
+
+
 if compat.PY3:
     from urllib.request import urlopen, pathname2url
     _urlopen = urlopen
@@ -183,6 +190,10 @@ def _stringify_path(filepath_or_buffer):
     -------
     str_filepath_or_buffer : a the string version of the input path
     """
+    if _OS_FSPATH_INSTALLED and isinstance(filepath_or_buffer, PathLike):
+        return fspath(filepath_or_buffer)
+    elif hasattr(filepath_or_buffer, "__fspath__"):
+        return filepath_or_buffer.__fspath__()
     if _PATHLIB_INSTALLED and isinstance(filepath_or_buffer, pathlib.Path):
         return text_type(filepath_or_buffer)
     if _PY_PATH_INSTALLED and isinstance(filepath_or_buffer, LocalPath):

pandas/io/pytables.py

@@ -44,7 +44,7 @@
 from pandas.core.index import _ensure_index
 from pandas.tools.merge import concat
 from pandas import compat
-from pandas.compat import u_safe as u, PY3, range, lrange, string_types, filter
+from pandas.compat import u_safe as u, PY3, range, lrange, string_types, text_type, filter
 from pandas.core.config import get_option
 from pandas.computation.pytables import Expr, maybe_expression
 
@@ -487,6 +487,9 @@ def __contains__(self, key):
                 return True
         return False
 
+    def __fspath__(self):
+        return text_type(self._path)
+
     def __len__(self):
         return len(self.groups())