انتقل إلى المحتوى
شعار أوراباسي
aurabase

Rust SDK

صندوق aurabase — عميل غير متزامن مكتوب لـ Tokio/axum/actix.

المرجع8 د قراءةالمستوى مرجعتمت المراجعة في 15‏/04‏/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())
}

هالة ديسيبل توليد --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

للذهاب أبعد من ذلك#