rbdc

Database driver abstraction layer for Rust, providing a unified interface for rbatis.

Features

• Safe: #![forbid(unsafe_code)] - 100% safe Rust
• Async: Native async support based on Tokio
• Extensible: Simple trait definitions for easy driver implementation

Supported Databases

Quick Start

use rbdc_sqlite::SqliteDriver;
use rbdc::pool::ConnManager;
use rbdc_pool_fast::FastPool;

#[tokio::main]
async fn main() -> Result<(), rbdc::Error> {
    let pool = FastPool::new(ConnManager::new(
        SqliteDriver {},
        "sqlite://target/test.db"
    )?)?;
    let mut conn = pool.get().await?;

    let v = conn.get_values("SELECT * FROM sqlite_master", vec![]).await?;
    println!("{}", rbs::Value::Array(v));
    Ok(())
}

Implement Custom Driver

Implement these 6 traits:

use rbdc::db::{Driver, MetaData, Row, Connection, ConnectOptions, Placeholder};

impl Driver for YourDriver {}
impl MetaData for YourMetaData {}
impl Row for YourRow {}
impl Connection for YourConnection {}
impl ConnectOptions for YourConnectOptions {}
impl Placeholder for YourPlaceholder {}

//TODO ....

For databases with blocking APIs, refer to rbdc-sqlite which uses the flume channel library.

See examples for more.

License

MIT