Skip to main content

A Python library for cloud and remote file Systems.

Project description

Tests codecov PyPI

airfs: A Python library for cloud and remote file Systems

airfs brings standard Python I/O to various storages (like cloud objects storage, remote file-systems, ...) by providing:

  • Abstract classes of Cloud objects with the complete io.RawIOBase and io.BufferedIOBase standard interfaces.
  • Features equivalent to the standard library (io, os, os.path, shutil) for seamlessly managing storage objects and local files.

These functions are source agnostic and always provide the same interface for all files from storage or local file systems.

Buffered storage objects also support the following features:

  • Buffered asynchronous writing of any object size.
  • Buffered asynchronous preloading in reading mode.
  • Write or read lock depending on memory usage limitation.
  • Maximization of bandwidth using parallels connections.

For more information, refer to the documentation.

Supported storage

airfs is compatible with the following storage services:

  • Alibaba Cloud OSS
  • AWS S3 / MinIO
  • GitHub (Read Only)
  • Microsoft Azure Blobs Storage
  • Microsoft Azure Files Storage
  • OpenStack Swift Object Store

airfs can also access any publicly accessible file via HTTP/HTTPS (Read only).


"airfs" is a fork of the unmaintained "Pycosio" project by its main developer.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

airfs-1.5.2.tar.gz (61.4 kB view hashes)

Uploaded Source

Built Distribution

airfs-1.5.2-py3-none-any.whl (90.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page