İçeriğe geç
Aurabase Logosu
aura tabanı

Rust SDK'sı

aurabase sandığı — Tokio/axum/actix için yazılan eşzamansız istemci.

Referans8 dk. okuSeviye referans15 Nis 2026 tarihinde revize edildi

Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

Kargo#

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

Son dakika değişiklikleri, yayınlanmadan 30 gün önce değişiklik günlüğünde duyurulur.

Varsayılan istemci#

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 (yetkilendirme mağazası)
    )
}

Yazılan seç#

Satır türü from::<Row>()'ye verilir; order(column, direction) yönü ikinci argüman olarak alır; execute(), data satır listesi olan bir AuraResponse döndürür. JavaScript SDK'sında olduğu gibi, bir HTTP hatası AuraResponse.error olarak değil, Err olarak bildirilir: onu bir Err'ye dönüştürmek için into_result()? çağrısı yapın, aksi takdirde data üzerindeki unwrap_or_default() reddedilen anahtarı boş bir listenin arkasına gizler.

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()?; // bir HTTP hatası (geçersiz anahtar, RLS, eksik tablo…) 'Err' olur
    Ok(res.unwrap_or_default())
}

aura db --lang pas üretir#

terminalbash
# Proje şemanızdan yapıları ve numaralandırmaları seri durumdan çıkarma/serileştirme oluşturur
aura db generate --lang rust > src/aurabase_types.rs

API hâlâ gelişiyor#

Bu yüzeyler hâlâ değişebilir. Cargo.toml'deki unstable özelliğinin arkasındaki koşullu derleme.

  • aura.channel() — WebSocket/SSE istemcisi
  • aura.functions.invoke() — kenar işlev çağrısı
  • aura.storage.upload_resumable() — tus tarzı parçalar

Daha ileri gitmek için#