Swarmauri Storage S3 Over SFTP

S3-style object storage adapter that persists bucket-prefixed objects through SFTP.

Features

• Exposes Swarmauri storage adapter methods with S3-like bucket/key addressing over an SFTP directory tree.
• Supports password, key-file, and injected Paramiko transport or SFTP clients for managed connection lifecycles.
• Provides upload, download, recursive push and pull, byte-range reads, deletion, and bucket directory creation.
• Uses Swarmauri storage-key normalization helpers to reject unsafe keys before resolving remote or local paths.
• Provides discoverable swarmauri.storage_adapters and peagen.plugins.storage_adapters entry points.

Installation

Install this package with uv or pip.

uv add swarmauri_storage_s3_over_sftp

pip install swarmauri_storage_s3_over_sftp

Usage

Use this adapter when a workflow expects object-storage semantics but the backing system is reachable only through SFTP.

from swarmauri_storage_s3_over_sftp import S3OverSftpStorageAdapter

adapter = S3OverSftpStorageAdapter.from_uri(
    "s3+sftp://deploy@example.com/artifacts/runs?root_dir=/srv/object-store"
)

uri = adapter.put_blob("latest/result.json", b'{"status":"ok"}')
payload = adapter.get_blob("latest/result.json")

print(uri)
print(payload)

The URI path is interpreted as /<bucket>/<prefix>. The optional root_dir query value points at the remote SFTP directory under which bucket directories are stored.

License: Apache-2.0. See LICENSE.