Rust SDK
caja aurabase: cliente asíncrono escrito para Tokio/axum/actix.
Esta página fue traducida automáticamente. La versión en inglés es autorizada.
Carga#
toml
[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#
rust
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.
rust
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#
bash
# 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/SSEaura.functions.invoke()— llamada a función de bordeaura.storage.upload_resumable()— trozos estilo tus