Sova

Appearance

storage ​

Object storage (local / memory / S3 / GCS / Azure)

Cratesova-storage 0.1.4
Plugin idstorage
CategoryStorage

Install ​

bash
cargo add sova --features storage

Features ​

FeatureWhat you get
storageObject storage (req.storage() — local / cloud).
storage-azureAzure Blob backend.
storage-gcsGoogle Cloud Storage backend.
storage-memoryIn-memory blob store (tests).
storage-s3S3 / R2 / MinIO backend.

Overview ​

When: object storage (local disk, memory, S3, GCS, Azure).

Does:

  • Storage::from_env()? → req.storage()
  • put / get / delete (+ upload helper)
  • Driver via features + env

Example ​

rust
app.install(Storage::from_env()?);
req.storage().put("avatars/1.png", bytes, PutOpts::default()).await?;

Config ​

toml
[storage]
driver = "local"          # local | memory | s3 | gcs | azure
path = "./storage"        # local
public_url = "https://cdn.example.com"
bucket = "my-bucket"      # s3/gcs/azure
region = "auto"
endpoint = "https://…"    # MinIO / R2
root = "uploads/"
force_path_style = true

Env (wins / fills): SOVA_STORAGE, SOVA_STORAGE_PATH, SOVA_STORAGE_PUBLIC_URL, SOVA_STORAGE_BUCKET (+ AWS_BUCKET), SOVA_STORAGE_REGION (+ AWS_REGION), SOVA_STORAGE_ENDPOINT, SOVA_STORAGE_ROOT, SOVA_STORAGE_FORCE_PATH_STYLE, AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY, GCS/Azure vars as in crate docs.

Quick start ​

Object storage for uploads. Add on the web preset (multipart feature for files):

rust
use sova::prelude::*;
use sova::{Parser, Redirect, Request, ServerArgs, Storage, UploadRules};

#[tokio::main]
async fn main() -> Result<()> {
    let args = ServerArgs::parse();
    args.init_tracing();

    let mut app = App::web()
        .site("Uploads")
        .public_url("http://127.0.0.1:3000")
        .into_app();

    app.install(Storage::local("public/uploads"));

    app.post("/avatar", avatar);
    app.run().await
}

async fn avatar(mut req: Request) -> Result<Redirect> {
    let data = req.input().await?;
    let file = data
        .file("avatar")
        .cloned()
        .ok_or_else(|| Error::bad_request("avatar required"))?;
    file.validate(
        &UploadRules::new()
            .max_bytes(2_000_000)
            .extensions(["png", "jpg", "webp"]),
    )?;
    let _stored = req.storage().store(&file, "avatars").await?;
    Ok(Redirect::see_other("/"))
}
bash
cargo run -p upload
cargo run -p storage_demo

Or from env/toml (Storage::from_env()?):

toml
[storage]
driver = "local"
path = "public/uploads"
public_url = "/uploads"
bash
SOVA_STORAGE=local
SOVA_STORAGE_PATH=./storage
# s3: SOVA_STORAGE=s3 SOVA_STORAGE_BUCKET=… AWS_ACCESS_KEY_ID=… AWS_SECRET_ACCESS_KEY=…

Examples ​

static · fs