Arel  

ci ![Latest Version] downloads

Install

rust // Cargo.toml serde = { version = "1.0", features = ["derive"] } // sqlte | mysql | postgres arel = { version = "0.3", features = ["runtime-tokio-native-tls", "sqlite"] }

Demo

```rust use arel::prelude::*;

[arel]

struct User { #[arel(primarykey)] id: i64, name: String, #[arel(rename = "type")] r#type: String, expiredat: Option>, } impl Arel for User {}

// init db from Environment std::env::setvar("DATABASEURL", "sqlite::memory:"); arel::db::visitor::init().await?; // or init db from code arel::db::visitor::getorinit(|| Box::pin(async { arel::db::DatabasePoolOptions::new().max_connections(5).connect("sqlite::memory:").await })).await?;

// total count let count = User::query().selectsql("COUNT(*)").fetchcount().await?; println!("total: {}", count);

// create let mut activeuser = ArelUser { name: Set("n1"), ..Default::default() }; activeuser.save().await?;

// select let user: User = User::query().r#where("id", 1).fetchone().await?; let _activeuser: ArelUser = user.into();

let user: ArelUser = User::query().r#where("id", 1).fetch_one().await?;

let uesrs: Vec = User::query().whererange("id", ..=10).fetchall().await?; let uesrs: Vec = User::query().r#where("id", vec![1, 2, 3]).fetch_all().await?;

// update let user: User = User::query().fetchone().await?; let mut activeuser: ArelUser = user.into(); // activeuser.name.set("n-1"); activeuser.assign(&ArelUser { name: Set("n-1"), ..Default::default() }); active_user.save().await?;

// destroy active_user.destroy().await?; ```


Query

select

rust User::query().select(vec!(["id", "name"])).to_sql();

where

rust let sql = User::query().r#where("name", "n1").r#where("id", 1).to_sql(); // where_not let sql = User::query().where_not(id: vec![1, 2, 3]).to_sql(); // where_range let sql = User::query().where_range("age", 18..25).to_sql();

joins

rust let sql = User::query().join::<Wallet>(arel::JoinConst::InnerJoin).to_sql(); let sql = User::query().join_sql("INNER JOIN wallet on user.id = wallet.user_id").to_sql();

lock

rust // should use in transaction let user: User = User::query().r#where("name", "n1").lock().fetch_one_with_exec(tx);

group & having

rust let sql = User::query().group(vec!["name"]).having("age", 18..).to_sql();

order

rust let sql = User::query().order("created_at", arel::SortConst::Desc).to_sql(); let sql = User::query().order_asc().to_sql(); let sql = User::query().order_desc().to_sql();

limit & offset

rust let sql = User::query().limit(10).to_sql(); let sql = User::query().offset(10)(); let sql = User::query().paginate(1, 10).to_sql();


Insert

transaction

rust User::with_transaction(|tx| { Box::pin(async move { // for entry in 1i32..=100 { // sqlx::query("INSERT INTO user (name) VALUES ($1)") // .bind(format!("name-{}", entry)) // .bind("Admin") // .execute(tx.as_mut()) // .await?; // } let mut active_user = ArelUser { name: Set("n1"), r#type: Set("ADMIN"), ..Default::default() }; active_user.save_with_exec(tx.as_mut()).await?; Ok(None) }) }) .await?;

Update

increment

rust let active_user: ArelUser = User::query().r#where("id", 1).fetch_one().await?; active_user.increment_save("lock_version", 5).await?;