14次发布

0.4.2 2022年4月25日
0.4.1 2021年12月15日
0.3.0 2021年10月20日
0.1.9 2019年5月20日

#2560 in 数据库接口

每月47次下载
用于 2 crates

MIT/Apache

435KB
9K SLoC

Toql - 一个友好且高效的ORM

Tests Current Crates.io Version

入门指南 | 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)的条款下分发。

依赖项

~9–18MB
~243K SLoC