Toql - 一款友好且高效的 ORM

入门指南 | API 文档

Toql 是一个针对异步数据库的 ORM，具有以下特性：

• Rust 结构体和数据库表之间的转换。
• 可以加载和修改嵌套结构体。
• 独特的简单查询语言，适合 Web 客户端。
• 表别名从长且易读到短且快速。
• 针对 SQL 注入的准备语句。
• 支持原始 SQL 以充分利用数据库功能。
• 支持基于角色的访问。
• 通过用户定义的参数、查询函数、字段处理器等高度可定制。
• 查询、字段和路径名称的编译时安全性。
• 没有不安全的 Rust 代码。
• 在实际场景中进行测试。

它目前仅支持 MySQL。更多支持即将到来，敬请期待 :)

安装

将以下内容添加到您的 Cargo.toml

[dependencies]
toql = {version = "0.4", features = ["serde"]}
toql_mysql_async = "0.4"

外观和感觉

派生您的结构体

#[derive(Toql)]
#[toql(auto_key)]
struct Todo {
    #[toql(key)]
    id: u64,
    what: String,

    #[toql(join)]
    user: User 
}

并使用它们做事情

let toql = ...
let todo = Todo{ ... };

// Insert todo and update its generated id
toql.insert_one(&mut todo, paths!(top)).await?; 

// Compile time checked queries!
let q = query!(Todo, "*, user_id eq ?", &todo.user.id); 

// Typesafe loading
let todos = toql.load_many(q).await?; 

快速开始

查看 CRUD 示例。

贡献

欢迎评论、错误修复和质量改进。

许可证

Toql 在 MIT 许可证和 Apache 许可证（版本 2.0）的条款下分发。