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）的条款分发。