Перейти к содержимому
Логотип Аурабаза
аурабаза

Rust SDK

aurabase crate — типизированный асинхронный клиент для Tokio/axum/actix.

Справочник8 мин читатьУровень ссылкаПересмотрено 15 апр. 2026 г.

Эта страница была переведена автоматически. Английская версия является авторитетной.

Груз#

Cargo.tomltoml
[dependencies]
aurabase = "0.1"
tokio = { version = "1", features = ["full"] }
serde = { version = "1", features = ["derive"] }
Внимание

Критические изменения объявляются в журнале изменений за 30 дней до выпуска.

Клиент по умолчанию#

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 (хранилище авторизации)
    )
}

Введенный выбор#

Тип строки присваивается from::<Row>(); order(column, direction) принимает направление в качестве второго аргумента; execute() возвращает AuraResponse, data которого представляет собой список строк. Как и в JavaScript SDK, об ошибке HTTP сообщается в AuraResponse.error, а не в Err: вызовите into_result()?, чтобы превратить его в Err, в противном случае unwrap_or_default() в data скроет отклоненный ключ за пустым списком.

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()?; // ошибка HTTP (неверный ключ, RLS, отсутствующая таблица…) становится `Err`
    Ok(res.unwrap_or_default())
}

aura db генерировать --lang ржавчина#

terminalbash
# Генерирует структуры и перечисления десериализации/сериализации из схемы вашего проекта.
aura db generate --lang rust > src/aurabase_types.rs

API все еще развивается#

Эти поверхности все еще могут быть изменены. Условная компиляция, лежащая в основе функции unstable в Cargo.toml.

  • aura.channel() — клиент WebSocket/SSE
  • aura.functions.invoke() — вызов граничной функции
  • aura.storage.upload_resumable() — чанки в стиле tus

Чтобы пойти дальше#