Naar de inhoud springen
Aurabase-logo
aurabasis

Rust SDK

aurabase krat - getypte asynchrone client voor Tokio/axum/actix.

Referentie8 min lezenNiveau referentieHerzien op 15 apr 2026

Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.

Lading#

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

Belangrijke wijzigingen worden aangekondigd in de changelog met een periode van 30 dagen vóór release.

Standaardklant#

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

Getypt selecteren#

Het rijtype wordt gegeven aan from::<Row>(); order(column, direction) neemt de richting als tweede argument; execute() retourneert een AuraResponse waarvan data de lijst met rijen is. Net als de JavaScript SDK wordt een HTTP-fout gerapporteerd in AuraResponse.error, niet als Err: roep into_result()? aan om er een Err van te maken, anders verbergt unwrap_or_default() op data een afgewezen sleutel achter een lege lijst.

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()?; // een HTTP-fout (ongeldige sleutel, RLS, ontbrekende tabel…) wordt `Err`
    Ok(res.unwrap_or_default())
}

aura db genereert --lang roest#

terminalbash
# Genereert Deserialize/Serialize-structuren en enums op basis van uw projectschema
aura db generate --lang rust > src/aurabase_types.rs

API evolueert nog steeds#

Deze oppervlakken zijn nog steeds aan verandering onderhevig. Voorwaardelijke compilatie achter de unstable-functie in Cargo.toml.

  • aura.channel() — WebSocket/SSE-client
  • aura.functions.invoke() — edge-functieaanroep
  • aura.storage.upload_resumable() — brokken in tus-stijl

Om verder te gaan#