#database-driver #rethink-db #driver #async #reql

unreql

Well documented and easy to use RethinkDB Rust Driver

6 releases

0.1.8 Apr 27, 2024
0.1.7 Apr 6, 2024
0.1.6 Mar 20, 2024
0.1.3 Jan 21, 2024

#2181 in Database interfaces


Used in unreql_deadpool

MIT license

375KB
3.5K SLoC

Unofficial RethinkDB Driver for Rust

Well documented and easy to use

github crates.io docs.rs

Motivation

The official driver is difficult to support, awkward to use, and has little to no documentation or examples. Therefore, an attempt was made by me to remedy these shortcomings

Install

$ cargo add unreql

or

[dependencies]
unreql = "0.1.8"

Import

use unreql::r;

Connect

let conn = r.connect(()).await?;

Get data

Get by ID

let user: User = r.table("users").get(1).exec(&conn).await?;

Get all data

let users: Vec<User> = r.table("users").exec_to_vec(&conn).await?;

or

let mut cur = r.table("users").run(&conn);
let mut users: Vec<User> = vec![];
while let Ok(Some(user)) = cur.try_next().await? {
    users.push(user);
}

Update data

Use a nested reql query

r.table("users")
  .get(1)
  .update(rjson!({
    "name": "John",
    "upd_count": r.row().g("upd_count").add(1),
  }))
  .run(&conn);

Use connection pool

Implemented session manager for async deadpool

use unreql::{r, cmd::connect};
use unreql_deadpool::{IntoPoolWrapper, SessionManager};
use deadpool::managed::Pool;

// config to connect to rethinkdb
let config = connect::Options::default();
// new session manager
let manager = SessionManager::new(config);
// create a pool that is wrapped for ease of use (to be able to be passed to `.run(&pool)`)
let pool = Pool::builder(manager).max_size(20).build().unwrap().wrapper();

// now you can to pass `pool` to `.run()` and `.exec()`
let user: User = r.table("users").get(1).exec(&pool).await?;

Dependencies

~14–27MB
~506K SLoC