fw-storage 0.2.0

Unified storage interface.

fw-storage

Unified file storage interface tuned for simple filtering, memory-efficiency and performance to support processing large datasets in Flywheel imports and exports.

Supported storage backends:

• fs:// - Local file-system
• gs:// - Google Cloud Storage (pip install fw-storage[gs])
• s3:// - Amazon S3 (pip install fw-storage[s3])

Installation

Add as a poetry dependency to your project:

poetry add fw-storage

Usage

from fw_storage import get_storage

# instantiate storage with URL
fs = get_storage("fs:///tmp")

# set objects from bytes, filepaths or open files
fs.set("test/file1.dat", b"content")
fs.set("test/file2.dat", "/tmp/test/file1.dat")
fs.set("test/file3.dat", open("/tmp/test/file2.dat"))

# list objects, filtering with expressions
files = list(fs.ls("test", include=["size<1kB"], exclude=["path!~file3"]))
len(files) == 2

# get object info with path, size, created and modified
info = fs.stat("test/file1.dat")
info.size == 7

# read object contents
file = fs.get("test/file1.dat")
file.read() == b"content"

# remove one or more objects
fs.rm("test", recurse=True)

Development

Install the project using poetry and enable pre-commit:

poetry install
pre-commit install

License