Zum Inhalt springen
Aurabase-Logo
Aurabasis

Rust SDK

aurabase crate – typisierter asynchroner Client für Tokio/axum/actix.

Referenz8 Min. gelesenEbene ReferenzÜberarbeitet am 15.04.2026

Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.

Fracht#

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

Breaking Changes werden im Changelog mit einer Frist von 30 Tagen vor der Veröffentlichung bekannt gegeben.

Standard-Client#

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 (Authentifizierungsspeicher)
    )
}

„Auswählen“ eingegeben#

Der Zeilentyp wird an from::<Row>() übergeben; order(column, direction) übernimmt die Richtung als zweites Argument; execute() gibt einen AuraResponse zurück, dessen data die Liste der Zeilen ist. Wie beim JavaScript SDK wird ein HTTP-Fehler in AuraResponse.error gemeldet, nicht als Err: Rufen Sie into_result()? auf, um ihn in Err umzuwandeln, andernfalls verbirgt unwrap_or_default() auf data einen abgelehnten Schlüssel hinter einer leeren Liste.

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()?; // Ein HTTP-Fehler (ungültiger Schlüssel, RLS, fehlende Tabelle…) wird zu „Err“.
    Ok(res.unwrap_or_default())
}

Aura DB generiert --lang Rust#

terminalbash
# Erzeugt Deserialize/Serialize-Strukturen und Enumerationen aus Ihrem Projektschema
aura db generate --lang rust > src/aurabase_types.rs

API entwickelt sich weiter#

Diese Oberflächen können sich noch ändern. Bedingte Kompilierung hinter der Funktion unstable in Cargo.toml.

  • aura.channel() – WebSocket/SSE-Client
  • aura.functions.invoke() – Kantenfunktionsaufruf
  • aura.storage.upload_resumable() – Stücke im Tus-Stil

Um weiter zu gehen#