Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Swarmauri Logo

PyPI - Downloads Hits Supported Python Versions License Release Version Discord

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.

Metadata

Release files for swarmauri_storage_s3_over_sftp 0.11.0.dev6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for swarmauri_storage_s3_over_sftp 0.11.0.dev6
File Size Uploaded Provenance Actions
swarmauri_storage_s3_over_sftp-0.11.0.dev6.tar.gz 6.0 kB Without provenance Details for swarmauri_storage_s3_over_sftp-0.11.0.dev6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for swarmauri_storage_s3_over_sftp 0.11.0.dev6
File Interpreter ABI Platform Actions
swarmauri_storage_s3_over_sftp-0.11.0.dev6-py3-none-any.whl Python 3 none any Details for swarmauri_storage_s3_over_sftp-0.11.0.dev6-py3-none-any.whl

Total release size: 12.9 kB

Release files / swarmauri_storage_s3_over_sftp-0.11.0.dev6.tar.gz

Download URL swarmauri_storage_s3_over_sftp-0.11.0.dev6.tar.gz
Size 6.0 kB
Tags Source
SHA-256 checksum
How to use checksums
03ea58c3a1e22239e9304ec5c667144e0dc87bc53fffc3ae28d6e56445d4996f
BLAKE2b-256 checksum
How to use checksums
cad6c3c47c559955dc5bd1fa646e84f27e11f5e25eab39775015be26af790505
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / swarmauri_storage_s3_over_sftp-0.11.0.dev6-py3-none-any.whl

Download URL swarmauri_storage_s3_over_sftp-0.11.0.dev6-py3-none-any.whl
Size 6.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fcdb5bea0de3bf1970d6ecaa930dbdb4d2ded4bfe513cc305c00aa081fe74c57
BLAKE2b-256 checksum
How to use checksums
ed0e403d61bd3ab2b61611511b3d87dee7cd86fbae80cf29e4db803cda205835
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for swarmauri_storage_s3_over_sftp 0.11.0.dev6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page