Vai al contenuto
Logo Aurabase
aurabase

Rust SDK

aurabase crate — client asincrono digitato per Tokio/axum/actix.

Riferimento8 min lettoLivello riferimentoRevisionato il 15 apr 2026

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

Carico#

Cargo.tomltoml
[dependencies]
aurabase = "0.1"
tokio = { version = "1", features = ["full"] }
serde = { version = "1", features = ["derive"] }
Attenzione

Le modifiche importanti vengono annunciate nel registro delle modifiche con un periodo di 30 giorni prima del rilascio.

Cliente predefinito#

src/aurabase.rsrust
use aurabase::AuraClient;
use std::env;

pub fn client() -> AuraClient {
    AuraClient::new(
        &env::var("NEXT_PUBLIC_AURABASE_URL").expect("NEXT_PUBLIC_AURABASE_URL"),
        &env::var("AURABASE_SERVICE_ROLE_KEY").expect("AURABASE_SERVICE_ROLE_KEY"),
        None, // AuraClientOptions (archivio di autenticazione)
    )
}

Seleziona digitato#

Il tipo di riga è dato a from::<Row>(); order(column, direction) accetta la direzione come secondo argomento; execute() restituisce un AuraResponse il cui data è l'elenco delle righe. Come l'SDK JavaScript, un errore HTTP viene segnalato in AuraResponse.error, non come Err: chiama into_result()? per trasformarlo in un Err, altrimenti unwrap_or_default() su data nasconde una chiave rifiutata dietro un elenco vuoto.

src/handlers.rsrust
use aurabase::{AuraClient, AuraError};
use serde::{Deserialize, Serialize};

#[derive(Debug, Deserialize, Serialize)]
pub struct Todo {
    pub id: i64,
    pub title: String,
    pub done: bool,
}

pub async fn recent(aura: &AuraClient) -> Result<Vec<Todo>, AuraError> {
    let res = aura
        .from::<Todo>("todos")
        .select("id,title,done")
        .order("created_at", "desc")
        .limit(5)
        .execute()
        .await?
        .into_result()?; // un errore HTTP (chiave non valida, RLS, tabella mancante...) diventa "Err".
    Ok(res.unwrap_or_default())
}

aura db genera --lang ruggine#

terminalbash
# Genera strutture ed enumerazioni di deserializzazione/serializzazione dallo schema del progetto
aura db generate --lang rust > src/aurabase_types.rs

API ancora in evoluzione#

Queste superfici sono ancora soggette a modifiche. Compilazione condizionale dietro la funzionalità unstable in Cargo.toml.

  • aura.channel(): client WebSocket/SSE
  • aura.functions.invoke() — chiamata della funzione edge
  • aura.storage.upload_resumable() — pezzi in stile tus

Per andare oltre#