storage

Object storage (local / memory / S3 / GCS / Azure) · crate sova-storage 0.1.0 · id storage

cargo add sova --features storage,storage-azure,storage-gcs,storage-memory,storage-s3

Feature	What you get
storage	Object storage (sova_storage).
storage-azure	Azure Blob backend.
storage-gcs	Google Cloud Storage backend.
storage-memory	In-memory blob store (tests).
storage-s3	S3 / R2 / MinIO backend.

Object storage for Sova — local disk, memory, S3/R2/MinIO, GCS, Azure.

Upload pipeline:

 file.validate(&UploadRules::new().max_bytes(2_000_000).extensions(["png", "jpg"]))?;
 let stored = req.storage().store(&file, "avatars").await?;
 // stored.key / stored.url

Usage

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

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("/"))
}

cargo run -p upload
cargo run -p storage_demo