httpfs-sync is an implementation of a filesystem interface for the Python fsspec
library that uses synchronous requests based on urllib3. This serves as an alternative
to the default asynchronous (based on aiohttp) filesystem implementation provided by
fsspec. This project is ideal for environments where asynchronous operations are not
feasible or desired, allowing users to interact with HTTP-based filesystems using a
synchronous API.
If you're dealing with deadlocks potentially involving the default HTTP 'filesystem' in
fsspec, the implementation here may help with verification of behavior: just use the classes
provided here as a drop-in replacement for HTTPFileSystem and compare behaviors.
- Synchronous HTTP requests for file system operations.
- Fully compatible with the
fsspecAPI, making it easy to drop in as a replacement. - Uses
urllib3for robust, production-ready HTTP communications.
To install httpfs-sync, you can use pip:
pip install httpfs-syncHere's a simple example of how to use httpfs-sync to read a file from an HTTP server:
import fsspec
from httpfs_sync.core import SyncHTTPFileSystem
# enable use of SyncHTTPFileSystem and associated files for both http and https
SyncHTTPFileSystem.overwrite_async_registration()
# Use the registered file system to access a remote file
with fsspec.open('http://example.com/data.txt', 'r') as f:
data = f.read()
print(data)httpfs-sync is distributed under the MIT License, allowing the code to be used in commercial applications as well as open-source projects.