Rust SDK
aurabase crate — Tokio/axum/actix 的类型化异步客户端。
该页面已自动翻译。英文版具有权威性。
货物#
toml
[dependencies]
aurabase = "0.1"
tokio = { version = "1", features = ["full"] }
serde = { version = "1", features = ["derive"] }
注意
重大变更会在发布前 30 天的变更日志中公布。
默认客户端#
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(授权存储)
)
}
键入选择#
行类型被赋予 from::<Row>(); order(column, direction) 将方向作为第二个参数; execute() 返回一个 AuraResponse,其 data 是行列表。与 JavaScript SDK 一样,在 AuraResponse.error中报告 HTTP 错误,而不是在 Err中报告:调用 into_result()? 将其转换为 Err,否则 data 上的 unwrap_or_default() 将拒绝的键隐藏在空列表后面。
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()?; // HTTP 错误(无效密钥、RLS、缺少表...)变为 `Err`
Ok(res.unwrap_or_default())
}
aura db 生成 --lang rust#
bash
# 从项目模式生成反序列化/序列化结构和枚举
aura db generate --lang rust > src/aurabase_types.rs
API 仍在不断发展#
这些表面仍然可能发生变化。 Cargo.toml 中 unstable 功能背后的条件编译。
aura.channel()— WebSocket/SSE 客户端aura.functions.invoke()— 边缘函数调用aura.storage.upload_resumable()— tus 风格的块