Saltar al contenido
Logotipo de Aurabase
aurabase

Rust SDK

caja aurabase: cliente asíncrono escrito para Tokio/axum/actix.

Referencia8 min leerNivel referenciaRevisado el 15 abr 2026

Esta página fue traducida automáticamente. La versión en inglés es autorizada.

Carga#

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

Los cambios importantes se anuncian en el registro de cambios con un período de 30 días antes del lanzamiento.

Cliente predeterminado#

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 (almacén de autenticación)
    )
}

Selección escrita#

El tipo de fila se proporciona a from::<Row>(); order(column, direction) toma la dirección como segundo argumento; execute() devuelve un AuraResponse cuyo data es la lista de filas. Al igual que el SDK de JavaScript, se informa un error HTTP en AuraResponse.error, no como Err: llame a into_result()? para convertirlo en Err; de lo contrario, unwrap_or_default() en data oculta una clave rechazada detrás de una lista vacía.

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()?; // un error HTTP (clave no válida, RLS, tabla faltante…) se convierte en `Err`
    Ok(res.unwrap_or_default())
}

aura db generar --lang óxido#

terminalbash
# Genera Deserializar/Serializar estructuras y enumeraciones a partir del esquema de su proyecto.
aura db generate --lang rust > src/aurabase_types.rs

API sigue evolucionando#

Estas superficies todavía están sujetas a cambios. Compilación condicional detrás de la función unstable en Cargo.toml.

  • aura.channel() — Cliente WebSocket/SSE
  • aura.functions.invoke() — llamada a función de borde
  • aura.storage.upload_resumable() — trozos estilo tus

para ir más lejos#