# rbdc
[](https://crates.io/crates/rbdc)
[](https://docs.rs/rbdc)
[](LICENSE)
Database driver abstraction layer for Rust, providing a unified interface for [rbatis](https://github.com/rbatis/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
| MySQL | [rbdc-mysql](https://crates.io/crates/rbdc-mysql) |
| PostgreSQL | [rbdc-pg](https://crates.io/crates/rbdc-pg) |
| SQLite | [rbdc-sqlite](https://crates.io/crates/rbdc-sqlite) |
| MSSQL | [rbdc-mssql](https://crates.io/crates/rbdc-mssql) |
## Quick Start
```rust
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:
```rust
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](./examples) for more.
## License
MIT