3RNN/Lib/site-packages/h5py/_hl/compat.py

43 lines
1.3 KiB
Python
Raw Normal View History

2024-05-26 19:49:15 +02:00
"""
Compatibility module for high-level h5py
"""
import sys
from os import fspath, fsencode, fsdecode
from ..version import hdf5_built_version_tuple
WINDOWS_ENCODING = "utf-8" if hdf5_built_version_tuple >= (1, 10, 6) else "mbcs"
def filename_encode(filename):
"""
Encode filename for use in the HDF5 library.
Due to how HDF5 handles filenames on different systems, this should be
called on any filenames passed to the HDF5 library. See the documentation on
filenames in h5py for more information.
"""
filename = fspath(filename)
if sys.platform == "win32":
if isinstance(filename, str):
return filename.encode(WINDOWS_ENCODING, "strict")
return filename
return fsencode(filename)
def filename_decode(filename):
"""
Decode filename used by HDF5 library.
Due to how HDF5 handles filenames on different systems, this should be
called on any filenames passed from the HDF5 library. See the documentation
on filenames in h5py for more information.
"""
if sys.platform == "win32":
if isinstance(filename, bytes):
return filename.decode(WINDOWS_ENCODING, "strict")
elif isinstance(filename, str):
return filename
else:
raise TypeError("expect bytes or str, not %s" % type(filename).__name__)
return fsdecode(filename)