store

KvStore trait + memory / file / sql / redis backends for Sova · crate sova-store 0.1.0 · id store

cargo add sova --features store,store-crypto,store-file,store-redis,store-sql

Feature	What you get
store	KvStore + Cache (sova_store).
store-crypto	XChaCha20-Poly1305 wrapper for KvStore.
store-file	File-backed KvStore.
store-redis	Redis KvStore on RedisPool.
store-sql	SQL KvStore on DbPool.

Byte-oriented key-value store for Sova plugins (sessions, cache, CSRF, rate-limit).

Trait is stable (memory + file + sql + redis backends). Enable feature unstable-store for backwards-compatible feature flags. Not in sova-core — wire with app.state(store.namespace("sess")).

Usage

Shared KvStore for rate-limit, cache, etc. Install beside a preset. In-memory:

use sova::prelude::*;
use sova::{Parser, ServerArgs, SharedStore};

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

    let mut app = App::web()
        .site("App")
        .public_url("https://example.com");
    app.install(SharedStore::memory());
    app.run().await
}

SQL on the same DbPool (cabinet-style):

use std::sync::Arc;
use sova::prelude::*;
use sova::{Db, DbPool, Parser, ServerArgs, SharedStore};

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

    let mut app = App::web()
        .site("App")
        .public_url("https://example.com")
        .into_app();

    app.install(Db::from_env());
    let pool = app.try_state::<DbPool>().expect("db").as_ref().clone();
    let kv = Arc::new(sova::store::Sql::from_db_pool(&pool)) as Arc<dyn sova::KvStore>;
    app.install(SharedStore::new(Arc::clone(&kv)));

    app.run().await
}

Features: store-sql, store-redis, store-file, store-crypto.