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, об ошибке HTTP сообщается в AuraResponse.error, а не в Err: вызовите into_result()?, чтобы превратить его в Err, в противном случае unwrap_or_default() в data скроет отклоненный ключ за пустым списком.
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 ржавчина#
bash
# Генерирует структуры и перечисления десериализации/сериализации из схемы вашего проекта.
aura db generate --lang rust > src/aurabase_types.rs
API все еще развивается#
Эти поверхности все еще могут быть изменены. Условная компиляция, лежащая в основе функции unstable в Cargo.toml.
aura.channel()— клиент WebSocket/SSEaura.functions.invoke()— вызов граничной функцииaura.storage.upload_resumable()— чанки в стиле tus