Metadata-Version: 2.4
Name: rclone-filesystem
Version: 0.1.0
Summary: A Python package for integrating rclone with fsspec
Project-URL: Repository, https://github.com/zincware/rclone-filesystem
Project-URL: Releases, https://github.com/zincware/rclone-filesystem/releases
Project-URL: Discord, https://discord.gg/7ncfwhsnm4
Author-email: Fabian Zills <fzills@icp.uni-stuttgart.de>
License-Expression: Apache-2.0
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: fsspec>=2025.5.1
Requires-Dist: rclone-python>=0.1.21
Description-Content-Type: text/markdown

# RCloneFileSystem: fsspec-Compatible Filesystem via rclone

This package provides a fsspec compliant filesystem interface for rclone.

Given an rclone remove `rclone config create myremote s3 ...` you can use the `RCloneFileSystem` as follows:

```py
from rclone_filesystem import RCloneFileSystem

fs = RCloneFileSystem(remote="myremote")

fs.ls("data") # path, e.g. bucket name for S3

with fs_a.open("data/test-file.txt", "wb") as f:
    f.write(b"Hello, World!")

with fs_b.open("data/test-file.txt", "rb") as f:
    content = f.read()
    assert content == b"Hello, World!"
```
