18 个版本

新增 0.4.0 2024年8月12日
0.3.7 2024年7月19日
0.3.1 2024年3月11日
0.2.2 2023年12月28日
0.1.7 2023年5月18日

#2516数据库接口

Download history 144/week @ 2024-04-21 76/week @ 2024-04-28 5/week @ 2024-05-05 8/week @ 2024-05-12 39/week @ 2024-05-19 19/week @ 2024-05-26 40/week @ 2024-06-02 29/week @ 2024-06-09 55/week @ 2024-06-16 11/week @ 2024-06-23 7/week @ 2024-06-30 5/week @ 2024-07-07 279/week @ 2024-07-14 54/week @ 2024-07-21 205/week @ 2024-07-28 12/week @ 2024-08-04

550 每月下载量
2 个Crates中使用(通过 welds

BSD-3-Clause

51KB
1.5K SLoC

使用sqlx和/或Tiberius编写的异步ORM

Welds

Welds是使用sqlx和/或Tiberius编写的异步ORM

特性

  • 全部异步
  • 支持多种SQL数据库(Mssql, MySql, Postgres, Sqlite)
  • 专为开发便捷性而编写。特性不隐藏在特质后面。代码应易于编写和阅读。
  • 当您需要降级到原始SQL时,始终可用的低级别连接。

底层welds使用

  • sqlx用于Postgres, MySql和Sqlite。
  • Tiberius用于MSSQL

兼容性

  • welds的0.4.*系列与sqlx 0.8编译
  • welds的0.3.*系列与sqlx 0.7编译

示例设置

#[derive(Debug, WeldsModel)]
#[welds(schema= "inventory", table = "products")]
#[welds(BelongsTo(seller, super::people::People, "seller_id"))]
pub struct Product {
    #[welds(rename = "product_id")]
    #[welds(primary_key)]
    pub id: i32,
    pub name: String,
    pub seller_id: Option<i32>,
    pub description: Option<String>,
    pub price: Option<f32>,
}

示例用法

基本选择

  let url = "postgres://postgres:password@localhost:5432";
  let client = welds::connections::postgres::connect(url).await.unwrap();

  let products = Product::where_col(|p| p.price.equal(3.50)).run(&client).await?;

跨表基本筛选

  let client = welds::connections::mssql::connect(url).await.unwrap();

  let sellers = Product::where_col(|product| product.price.equal(3.50))
        .map_query(|product| product.seller )
        .where_col(|seller| seller.name.ilike("%Nessie%") )
        .run(&client).await?;

创建和更新

  let client = welds::connections::sqlite::connect(url).await.unwrap();
  
  let mut cookies = Product::new();
  cookies.name = "cookies".to_owned();
  // Creates the product cookie
  cookies.save.await(&client)?; 
  cookies.description = "Yum".to_owned();
  // Updates the Cookies
  cookies.save.await(&client)?; 

其他示例

更多示例,请查看示例仓库

依赖项

~1.5MB
~37K SLoC