#async #postgres #pool #r2d2 #bb8

bb8

Full-featured async (tokio-based) connection pool (like r2d2)

12 unstable releases (4 breaking)

0.7.0 Dec 27, 2020
0.6.1 Nov 17, 2020
0.5.2 Dec 22, 2020
0.4.2 Apr 21, 2020
0.3.0 Mar 17, 2019

#19 in Asynchronous

Download history 1205/week @ 2020-11-10 1349/week @ 2020-11-17 1590/week @ 2020-11-24 1613/week @ 2020-12-01 1775/week @ 2020-12-08 1772/week @ 2020-12-15 892/week @ 2020-12-22 764/week @ 2020-12-29 1424/week @ 2021-01-05 1836/week @ 2021-01-12 1674/week @ 2021-01-19 1966/week @ 2021-01-26 1823/week @ 2021-02-02 2045/week @ 2021-02-09 2222/week @ 2021-02-16 2022/week @ 2021-02-23

5,657 downloads per month
Used in 22 crates (17 directly)

MIT license

30KB
731 lines

bb8

Documentation Crates.io Build status codecov License: MIT

A full-featured connection pool, designed for asynchronous connections (using tokio). Originally based on r2d2.

Opening a new database connection every time one is needed is both inefficient and can lead to resource exhaustion under high traffic conditions. A connection pool maintains a set of open connections to a database, handing them out for repeated use.

bb8 is agnostic to the connection type it is managing. Implementors of the ManageConnection trait provide the database-specific logic to create and check the health of connections.

A (possibly not exhaustive) list of adapters for different backends:

Backend Adapter Crate
tokio-postgres bb8-postgres (in-tree)
redis bb8-redis (in-tree)
rsmq rsmq_async
bolt-client bb8-bolt
diesel bb8-diesel
tiberius bb8-tiberius
nebula-graph-client bb8-nebula-graph
memcache-async bb8-memcached
lapin bb8-lapin

Example

Using an imaginary "foodb" database.

fn main() {
    let manager = bb8_foodb::FooConnectionManager::new("localhost:1234");
    let pool = bb8::Pool::builder()
        .max_size(15)
        .build(manager)
        .unwrap();

    for _ in 0..20 {
        let pool = pool.clone();
        tokio::spawn(move || {
            let conn = pool.get().await.unwrap();
            // use the connection
            // it will be returned to the pool when it falls out of scope.
        })
    }
}

License

Licensed under the MIT license (LICENSE).

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be licensed as above, without any additional terms or conditions.

Dependencies

~3.5MB
~70K SLoC