rust-database-common

rust-database-common provides a simple, reusable abstraction for database connection pooling in my other Rust applications.

Intent

The intent of this crate is to offer a lightweight, common interface for managing database connection pools, so I can focus on my application logic rather than connection management.

Features

• Simple API for creating and managing a database connection pool
• Built on top of deadpool-postgres and tokio-postgres
• Error handling with thiserror
• Asynchronous connection management

Usage

Add this crate to your Cargo.toml:

[dependencies]
rust-database-common = { git = "https://github.com/corybuecker/rust-database-common", tag = "v1.0.0" }

Non-TLS example

use rust_database_common::DatabasePool;

#[tokio::main]
async fn main() {
    let mut db_pool = DatabasePool::new("postgres://user:password@localhost/dbname".to_string());
    db_pool.connect().await.expect("Failed to connect to database");

    let client = db_pool.get_client().await.expect("Failed to get client");
    // Use `client` as a regular tokio_postgres::Client
}

TLS example

use rust_database_common::{DatabasePool, SslMode};

#[tokio::main]
async fn main() {
    let ca_cert_pem = std::fs::read_to_string("./ca.pem").expect("Failed to read CA cert");

    let mut db_pool = DatabasePool::new("postgres://user:password@localhost/dbname".to_string())
        .with_required_ssl_mode(ca_cert_pem);

    db_pool.connect().await.expect("Failed to connect to database");
}

Notes

• This README was written by AI.

License

This project is licensed under the MIT License.