This release is a pre-release and may not be stable for production use.
Swarmauri File Storage Adapter
Filesystem-based storage adapter for Peagen that stores binary artifacts on the local disk.
Features
- Resolves and prepares the configured
output_diron instantiation so uploads can run without additional filesystem setup. - Supports an optional
prefixto scope all keys inside a nested directory tree while keeping the same adapter instance. uploadwrites files atomically by copying into a temporary file before an atomic rename, ensuring partially written data is never observed.downloadreturns a :class:io.BytesIOhandle positioned at the start of the stored content for immediate consumption by downstream tooling.- Convenience helpers such as
upload_dir,download_dir,iter_prefixandfrom_urimirror the behavior of :class:pathlib.Pathoperations and make it easy to bulk transfer artifacts. root_uriexposes the workspace as afile://URI which is used when constructing the URIs returned byupload.
Installation
Install the package with your preferred Python packaging tool:
pip install swarmauri_storage_file
poetry add swarmauri_storage_file
uv pip install swarmauri_storage_file
Usage
from pathlib import Path
import io
from swarmauri_storage_file import FileStorageAdapter
workspace = Path("./artifacts").resolve()
adapter = FileStorageAdapter(output_dir=workspace)
root_uri = adapter.root_uri
print("Root URI:", root_uri)
uri = adapter.upload("example.txt", io.BytesIO(b"hello world"))
print("Stored at:", uri)
downloaded = adapter.download("example.txt").read().decode("utf-8")
print("Contents:", downloaded)
keys = list(adapter.iter_prefix(""))
print("Keys:", keys)
The snippet above resolves a local workspace, uploads an artifact, reads it
back as text and inspects the stored keys. URIs returned by upload reuse
root_uri (with the relative key appended) so they can be dereferenced by
tools that understand file:// locations.
Additional helpers
upload_dirrecursively walks a source directory and stores each file under an optional destination prefix.download_dirmaterializes a stored prefix into a destination directory, recreating any nested structure.iter_prefixyields keys rooted atoutput_dir(including any configured prefix) which is useful for inventory or cleanup tasks.from_urirebuilds an adapter from afile://URI previously emitted byroot_uriorupload.
Want to help?
If you want to contribute to swarmauri-sdk, read up on our guidelines for contributing that will help you get started.
Metadata
Release files for swarmauri_storage_file 0.11.0.dev1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| swarmauri_storage_file-0.11.0.dev1.tar.gz | 8.3 kB | Without provenance | Details for swarmauri_storage_file-0.11.0.dev1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| swarmauri_storage_file-0.11.0.dev1-py3-none-any.whl | Python 3 | none | any | Details for swarmauri_storage_file-0.11.0.dev1-py3-none-any.whl |
Total release size: 17.6 kB
Release files / swarmauri_storage_file-0.11.0.dev1.tar.gz
| Download URL | swarmauri_storage_file-0.11.0.dev1.tar.gz |
|---|---|
| Size | 8.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b4527b5383e0177ac2f46b742a452cbefa7a89688626ffa2233f5af333b1b3db
|
|
BLAKE2b-256 checksum How to use checksums |
24c74a4a284e1ce765588e39a7ac76488dca620e14173ee67114411a8ffc264d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","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_file-0.11.0.dev1-py3-none-any.whl
| Download URL | swarmauri_storage_file-0.11.0.dev1-py3-none-any.whl |
|---|---|
| Size | 9.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e854bec991769deb67dec758f6b1f58607db79271760f47b672334c4f28bbe89
|
|
BLAKE2b-256 checksum How to use checksums |
c7222cf3fd10086725f938af18f3ca6f912b81bdb3f5cd28a91e9e29dce0e60f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","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_file 0.11.0.dev1
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.