Aurabase Logo
aurabasedocs
docs›Référence›SDK Rust

SDK Rust

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

8 min de lecture·Niveau référence·Révisé le 15 avr. 2026
#
Installation

Cargo

§ 01
Cargo.toml
TOML
[dependencies]
aurabase = "0.4"
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.
#
Initialisation

Client par défaut

§ 02
src/aurabase.rs
RUST
use aurabase::Client;
use std::env;
pub fn client() -> Client {
    Client::new(
        env::var("AURA_URL").unwrap(),
        env::var("AURA_SERVICE_ROLE_KEY").unwrap(),
    )
}
#
Exemple

Select + insert

§ 03
src/handlers.rs
RUST
use serde::{Deserialize, Serialize};
#[derive(Deserialize, Serialize)]
pub struct Sensor { pub id: uuid::Uuid, pub value: f64 }
pub async fn recent(aura: &Client) -> Result<Vec<Sensor>> {
    aura.from("sensors")
        .select("id,value")
        .order("captured_at.desc")
        .limit(50)
        .execute::<Sensor>()
        .await
}
#
Codegen

aura types gen --lang rust

§ 04
terminal
BASH
aura types gen --lang rust > src/aurabase_types.rs
# Génère : structs Deserialize/Serialize pour chaque table + enums pour les types Postgres custom
#
Stabilité

API encore mouvantes

§ 05

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
Dernière mise à jour · 15 avr. 2026