Rust

作者 appwriteab3c90b37c95无许可证10 个星标收录于 2026年10月8日更新于 2026年10月8日仓库7周前更新

Appwrite Rust SDK skill. Use when building server-side Rust applications with Appwrite. Covers async client setup with API keys, user management, TablesDB database/table/row operations, file storage, function executions, permissions, queries, and error handling. Uses the crates.io `appwrite` package and Tokio.

仅含说明Software Development
AI 生成的概览

指导使用 Appwrite SDK 进行服务端 Rust 开发，涵盖客户端设置、用户、TablesDB、存储、函数与错误处理。

功能
该技能提供使用 Appwrite SDK 构建服务端 Rust 应用的参考说明和代码示例。内容涵盖使用 API 密钥和 Tokio 的异步客户端设置、用户管理、TablesDB 的数据库、表、列和行操作、查询、文件存储、函数执行、权限以及错误处理。它产出的是指导和代码片段，而不是脚本或生成的文件。
适用场景
在编写或审查集成 Appwrite 的服务端 Rust 代码时使用。它适用于在 Rust 后端中处理 Appwrite 用户、数据库、存储桶、函数执行或权限的任务。
运行要求
需要 crates.io 的 appwrite 包、启用 full 特性的 Tokio 以及 serde_json。服务端身份验证需要 Appwrite 端点、项目 ID 和 API 密钥，并需要访问 Appwrite 服务的网络连接。不附带脚本，仅为说明文档。

Appwrite Rust SDK

Installation

bash
cargo add appwritecargo add tokio --features fullcargo add serde_json

Or add dependencies manually:

toml
[dependencies]appwrite = "0.3.0"tokio = { version = "1", features = ["full"] }serde_json = "1"

Setting Up the Client

The Rust SDK is async. Use it from a Tokio runtime and authenticate server-side with an API key.

rust
use appwrite::Client;use std::env;
let client = Client::new()    .set_endpoint("https://<REGION>.cloud.appwrite.io/v1")    .set_project(env::var("APPWRITE_PROJECT_ID")?)    .set_key(env::var("APPWRITE_API_KEY")?);

Complete server skeleton

rust
use appwrite::query::Query;use appwrite::services::Users;use appwrite::Client;use std::env;
#[tokio::main]async fn main() -> Result<(), Box<dyn std::error::Error>> {    let client = Client::new()        .set_endpoint("https://<REGION>.cloud.appwrite.io/v1")        .set_project(env::var("APPWRITE_PROJECT_ID")?)        .set_key(env::var("APPWRITE_API_KEY")?);
    let users = Users::new(&client);    let _list = users        .list(Some(vec![Query::limit(25).to_string()]), None, Some(true))        .await?;
    Ok(())}

Code Examples

User Management

rust
use appwrite::id::ID;use appwrite::query::Query;use appwrite::services::Users;
let users = Users::new(&client);
// Create userlet _user = users    .create(        ID::unique(),        Some("[email protected]"),        None,        Some("password123"),        Some("User Name"),    )    .await?;
// List userslet _list = users    .list(Some(vec![Query::limit(25).to_string()]), None, Some(true))    .await?;
// Get userlet _fetched = users.get("[USER_ID]").await?;
// Delete userusers.delete("[USER_ID]").await?;

Database Operations

Note: Use TablesDB for new code. Only use Databases if the existing project explicitly depends on the legacy Databases API.

Rust SDK calling convention: Methods are async, use positional parameters, and represent optional API parameters as Option<T>. Pass None for optional values you are not setting.

rust
use appwrite::id::ID;use appwrite::permission::Permission;use appwrite::query::Query;use appwrite::role::Role;use appwrite::services::TablesDB;use serde_json::json;
let tables_db = TablesDB::new(&client);
// Create databaselet _database = tables_db    .create(ID::unique(), "My Database", Some(true))    .await?;
// Create tablelet _table = tables_db    .create_table(        "[DATABASE_ID]",        ID::unique(),        "articles",        Some(vec![            Permission::read(Role::any()).to_string(),            Permission::create(Role::users(None)).to_string(),        ]),        Some(true),        Some(true),        None,        None,    )    .await?;
// Create rowlet _row = tables_db    .create_row(        "[DATABASE_ID]",        "[TABLE_ID]",        ID::unique(),        json!({            "title": "Hello World",            "done": false        }),        None,        None,    )    .await?;
// Query rowslet _rows = tables_db    .list_rows(        "[DATABASE_ID]",        "[TABLE_ID]",        Some(vec![            Query::equal("done", false).to_string(),            Query::limit(10).to_string(),        ]),        None,        Some(true),        None,    )    .await?;
// Get rowlet _row = tables_db    .get_row("[DATABASE_ID]", "[TABLE_ID]", "[ROW_ID]", None, None)    .await?;
// Update rowlet _updated = tables_db    .update_row(        "[DATABASE_ID]",        "[TABLE_ID]",        "[ROW_ID]",        Some(json!({ "done": true })),        None,        None,    )    .await?;
// Delete rowtables_db    .delete_row("[DATABASE_ID]", "[TABLE_ID]", "[ROW_ID]", None)    .await?;
String Column Types

Note: The legacy string column type is deprecated. Use explicit string column types for new tables.

TypeMax charactersIndexingStorage
varchar16,383Full index (if size <= 768)Inline in row
text16,383Prefix onlyOff-page
mediumtext4,194,303Prefix onlyOff-page
longtext1,073,741,823Prefix onlyOff-page
  • varchar is stored inline and counts toward the 64 KB row size limit. Prefer it for short, indexed fields like names, slugs, and identifiers.
  • text, mediumtext, and longtext are stored off-page, so they do not consume the row size budget. size is not required for these types.
rust
use appwrite::enums::{OrderBy, TablesDBIndexType};
// Short, indexed stringlet _title = tables_db    .create_varchar_column(        "[DATABASE_ID]",        "[TABLE_ID]",        "title",        255,        true,        None,        None,        None,    )    .await?;
// Off-page longer textlet _summary = tables_db    .create_text_column("[DATABASE_ID]", "[TABLE_ID]", "summary", false, None, None, None)    .await?;
let _body = tables_db    .create_mediumtext_column("[DATABASE_ID]", "[TABLE_ID]", "body", false, None, None, None)    .await?;
let _raw_data = tables_db    .create_longtext_column("[DATABASE_ID]", "[TABLE_ID]", "raw_data", false, None, None, None)    .await?;
// Index only the varchar column fully.let _index = tables_db    .create_index(        "[DATABASE_ID]",        "[TABLE_ID]",        "title_idx",        TablesDBIndexType::Key,        vec!["title"],        Some(vec![OrderBy::Asc]),        Some(vec![255]),    )    .await?;

Query Methods

TablesDB methods accept Option<Vec<String>> for queries. Convert each Query to a string.

rust
use appwrite::query::Query;use serde_json::Value;
let queries = vec![    Query::equal("status", "published").to_string(),    Query::not_equal("archived", true).to_string(),    Query::greater_than("views", 100).to_string(),    Query::less_than_equal("priority", 5).to_string(),    Query::between("score", 1, 100).to_string(),    Query::is_not_null("publishedAt").to_string(),    Query::search("title", "rust appwrite").to_string(),    Query::contains("tags", "rust").to_string(),    Query::order_desc("$createdAt").to_string(),    Query::limit(25).to_string(),    Query::offset(50).to_string(),];
let multi_value = Query::equal(    "status",    Value::Array(vec![        Value::String("draft".to_string()),        Value::String("published".to_string()),    ]),).to_string();

File Storage

rust
use appwrite::id::ID;use appwrite::input_file::InputFile;use appwrite::permission::Permission;use appwrite::query::Query;use appwrite::role::Role;use appwrite::services::Storage;
let storage = Storage::new(&client);
// Create bucketlet _bucket = storage    .create_bucket(        ID::unique(),        "Uploads",        Some(vec![            Permission::read(Role::any()).to_string(),            Permission::create(Role::users(None)).to_string(),        ]),        Some(true),        Some(true),        Some(30_000_000),        Some(vec!["jpg".to_string(), "png".to_string(), "pdf".to_string()]),        None,        Some(true),        Some(true),        Some(true),    )    .await?;
// Upload from disklet input = InputFile::from_path("avatar.png", Some("image/png")).await?;let _file = storage    .create_file(        "[BUCKET_ID]",        ID::unique(),        input,        Some(vec![Permission::read(Role::any()).to_string()]),    )    .await?;
// Upload from byteslet input = InputFile::from_bytes(b"hello".to_vec(), "hello.txt", Some("text/plain"));let _file = storage.create_file("[BUCKET_ID]", ID::unique(), input, None).await?;
// List fileslet _files = storage    .list_files("[BUCKET_ID]", Some(vec![Query::limit(10).to_string()]), None, Some(true))    .await?;
// Download file byteslet _content = storage    .get_file_download("[BUCKET_ID]", "[FILE_ID]", None)    .await?;
// Delete filestorage.delete_file("[BUCKET_ID]", "[FILE_ID]").await?;

Functions

rust
use appwrite::enums::ExecutionMethod;use appwrite::query::Query;use appwrite::services::Functions;use serde_json::json;
let functions = Functions::new(&client);
// List functionslet _functions = functions    .list(Some(vec![Query::limit(25).to_string()]), None, Some(true))    .await?;
// Execute functionlet _execution = functions    .create_execution(        "[FUNCTION_ID]",        Some(r#"{"hello":"world"}"#),        Some(false),        Some("/jobs/sync"),        Some(ExecutionMethod::POST),        Some(json!({ "content-type": "application/json" })),        None,    )    .await?;
// Get executionlet _execution = functions    .get_execution("[FUNCTION_ID]", "[EXECUTION_ID]")    .await?;

Permissions

rust
use appwrite::permission::Permission;use appwrite::role::Role;
let permissions = vec![    Permission::read(Role::any()).to_string(),    Permission::create(Role::users(None)).to_string(),    Permission::update(Role::user("[USER_ID]", None)).to_string(),    Permission::delete(Role::team("[TEAM_ID]", Some("owner"))).to_string(),];

Error Handling

rust
match users.get("[USER_ID]").await {    Ok(user) => {        let _user = user;    }    Err(error) if error.status_code() == 404 => {        eprintln!("User not found: {}", error.get_message());    }    Err(error) => {        eprintln!("Appwrite error {}: {}", error.status_code(), error.get_message());        return Err(Box::new(error) as Box<dyn std::error::Error>);    }}

Common Pitfalls

  • The Rust SDK is currently a server-side SDK. Prefer TypeScript/Web, Flutter, Apple, Android, or React Native SDKs for browser/mobile client auth flows.
  • Always await service calls.
  • Pass None for optional parameters you are not using.
  • Use TablesDB, not legacy Databases, for new database code.
  • Convert queries with .to_string() before passing them to APIs that expect Option<Vec<String>>.
  • Use serde_json::json!({...}) for row data and JSON bodies.
  • Use InputFile::from_path(...).await? or InputFile::from_bytes(...) for uploads.

来源与署名

来源：appwrite/claude-plugin位于skills/rust提交ab3c90b

许可证： 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

更多来自 appwrite/claude-plugin 的技能

Swift

appwrite

在 Apple 平台和服务器端 Swift 应用中使用 Appwrite Swift SDK 的参考指南。

Software Development107周前更新

Ruby

appwrite

指导使用 Appwrite SDK 构建服务端 Ruby 应用，涵盖用户、数据库、存储、团队、函数与 SSR 认证。

Software Development107周前更新

Dotnet

appwrite

使用 Appwrite SDK 构建服务端 C#/.NET 应用的参考，涵盖用户、数据表、存储、团队、函数与 SSR 认证。

Software Development107周前更新

Dart

appwrite

用于在 Dart 和 Flutter 中构建 Appwrite 应用的参考指南，涵盖认证、数据库、存储、实时订阅和函数。

Software Development107周前更新

更多Software Development技能

Writing Plans

obra

Use when you have a spec or requirements for a multi-step task, before touching code

Software Development296K今天更新

Verification Before Completion

obra

要求在声称工作已完成、已修复或已通过之前，先运行最新的验证命令并确认输出。

Software Development296K今天更新

Using Git Worktrees

obra

为功能开发搭建隔离的 git worktree 工作区，并执行项目初始化与基线测试。

Software Development296K今天更新

Requesting Code Review

obra

派发代码审查子代理，并为其准备精确上下文，在问题扩散前发现它们。

Software Development296K今天更新

Receiving Code Review

obra

指导智能体接收代码评审反馈：核实建议、澄清不明项、以技术理由反驳，并逐项实施修复。

Software Development296K今天更新

Finishing A Development Branch

obra

引导智能体收尾已完成的开发分支：验证测试、选择合并、提 PR 或保留，然后清理工作区。

Software Development296K今天更新