Aller au contenu
Logo Aurabase
aurabase

SDK Rust

aurabase crate — client async typé pour Tokio/axum/actix.

Référence8 min de lectureNiveau référenceRévisé le 15 avr. 2026

Cargo#

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

Les breaking changes sont annoncés dans le changelog avec période de 30 jours avant release.

Client par défaut#

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 (auth store)
    )
}

Select + insert#

Le type de ligne est donné à from::<Row>() ; order(column, direction) prend la direction en second argument ; execute() renvoie une AuraResponse dont data est la liste des lignes. Comme le SDK JavaScript, une erreur HTTP est signalée dans AuraResponse.error, et non par Err : appelez into_result()? pour la convertir en Err, sinon unwrap_or_default() sur data masque une clé refusée derrière une liste vide.

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()?; // an HTTP error (invalid key, RLS, missing table…) becomes `Err`
    Ok(res.unwrap_or_default())
}

aura db generate --lang rust#

terminalbash
# Generates Deserialize/Serialize structs and enums from your project schema
aura db generate --lang rust > src/aurabase_types.rs

API encore mouvantes#

Ces surfaces sont encore sujettes à changement. Compilation conditionnelle derrière la feature unstable dans Cargo.toml.

  • aura.channel() — WebSocket/SSE client
  • aura.functions.invoke() — edge function call
  • aura.storage.upload_resumable() — tus-style chunks

Pour aller plus loin#