Vapour

Vapour is a pluggable remote-storage manager for Python 3.13+. A provider-neutral abstract layer defines the contract — StorageProvider, RemoteEntry, TransferProgress, ProviderConfig, and ProviderOptions — and each backend ships as an independent provider module registered under a short name. The vapour command is a thin adapter over the Python API.

Highlights

• StorageProvider contract covering connection checks, quota, listing, stat, mkdir, file and directory transfers, move, copy, delete, and version.
• Providers register through @register_provider and load lazily: create_provider(name) imports vapour.<name> on first use.
• Bundled terabox backend through the unofficial rclone-extra build; the session cookie lives only in process environment and is never written to a config file.
• Provider-specific settings travel through ProviderConfig.parameters (upload_threads, domain for TeraBox), so new backends need no abstract-layer changes.
• vapour CLI with --provider, --root, --param KEY=VALUE, --json, and --progress.

Installation

python -m pip install .

For development:

python -m pip install -e '.[test]'

Quick start

export TERABOX_COOKIE='<browser ndus cookie>'
vapour providers
vapour quota
vapour ls backups/ --recursive
vapour upload archive.tar backups/archive.tar --progress

from vapour import ProviderConfig, create_provider

provider = create_provider("terabox", config=ProviderConfig())
for entry in provider.ls("backups/"):
    print(entry.path, entry.size)

License

MIT.

Directory contents

Files

• LICENSE — Provide LICENSE project content.
• __init__.py — Vapour public API: pluggable remote storage management.
• __main__.py — Execute Vapour as python -m vapour.
• cli.py — Thin command-line adapter over the Vapour provider layer.
• provider.py — Provider-neutral remote storage abstraction for Vapour.
• pyproject.toml — Provide pyproject toml content.
• terabox.py — TeraBox backend for Vapour using the unofficial rclone-extra build.

Subdirectories

No subdirectories.