Ir para o conteúdo
Aura Logo
aurabase

Rust SDK

aurabase crate — cliente assíncrono digitado para Tokio/axum/actix.

Referência8 min lidoNível referênciaRevisado em 15 de abr. de 2026

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

Carga#

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

As alterações mais recentes são anunciadas no changelog com um período de 30 dias antes do lançamento.

Cliente padrão#

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 (loja de autenticação)
    )
}

Seleção digitada#

O tipo de linha é fornecido para from::<Row>(); order(column, direction) toma a direção como segundo argumento; execute() retorna um AuraResponse cujo data é a lista de linhas. Assim como o JavaScript SDK, um erro HTTP é relatado em AuraResponse.error, não como Err: chame into_result()? para transformá-lo em Err, caso contrário, unwrap_or_default() em data oculta uma chave rejeitada atrás de uma lista vazia.

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()?; // um erro HTTP (chave inválida, RLS, tabela ausente…) torna-se `Err`
    Ok(res.unwrap_or_default())
}

aura db gerar --lang ferrugem#

terminalbash
# Gera estruturas e enums Deserialize/Serialize do esquema do seu projeto
aura db generate --lang rust > src/aurabase_types.rs

API ainda evoluindo#

Essas superfícies ainda estão sujeitas a alterações. Compilação condicional por trás do recurso unstable em Cargo.toml.

  • aura.channel() — cliente WebSocket/SSE
  • aura.functions.invoke() — chamada de função de borda
  • aura.storage.upload_resumable() – pedaços estilo tus

Para ir mais longe#