Przejdź do treści
Logo Aurabase
aurabaza

Rust SDK

aurabase crate — klient asynchroniczny z typem dla Tokio/axum/actix.

Referencja8 min przeczytanePoziom odniesienieZmieniono 15 kwi 2026

Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

Ładunek#

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

Najważniejsze zmiany ogłaszane są w dzienniku zmian na 30 dni przed publikacją.

Domyślny klient#

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 (sklep uwierzytelniający)
    )
}

Wpisano wybierz#

Typ wiersza przypisywany jest from::<Row>(); order(column, direction) przyjmuje kierunek jako drugi argument; execute() zwraca AuraResponse, którego data jest listą wierszy. Podobnie jak JavaScript SDK, błąd HTTP jest zgłaszany w AuraResponse.error, a nie jako Err: wywołaj into_result()?, aby zamienić go w Err, w przeciwnym razie unwrap_or_default() na data ukrywa odrzucony klucz za pustą listą.

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()?; // błąd HTTP (nieprawidłowy klucz, RLS, brakująca tabela...) zmienia się na `Err`
    Ok(res.unwrap_or_default())
}

aura db generuje --lang rdza#

terminalbash
# Generuje struktury i wyliczenia deserializacji/serializacji ze schematu projektu
aura db generate --lang rust > src/aurabase_types.rs

API wciąż się rozwija#

Powierzchnie te nadal podlegają zmianom. Kompilacja warunkowa funkcji unstable w Cargo.toml.

  • aura.channel() — klient WebSocket/SSE
  • aura.functions.invoke() — wywołanie funkcji brzegowej
  • aura.storage.upload_resumable() — kawałki w stylu tus

Aby pójść dalej#