#toql #query #orm #macro #field #database #friendly

toql_query_macro

包含Toql查询宏的库

2个不稳定版本

0.4.0 2021年12月4日
0.3.0 2021年10月20日

#10 in #toql


3 个crate中使用了 (通过 toql)

MIT/Apache

31KB
625

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

依赖关系

~7–16MB
~205K SLoC