Struct ConnPool 

pub struct ConnPool<C: Poolable> { /* private fields */ }

Production-grade connection pool, generic over connection type C.

Hook safety: Lifecycle hooks must not call back into the pool (e.g., calling get() from inside a hook will deadlock). Hooks should be fast and non-blocking.

Implementations

impl<C: Poolable> ConnPool<C>

pub async fn new( config: ConnPoolConfig, hooks: LifecycleHooks<C>, ) -> Result<Arc<Self>, PoolError<C::Error>>

Create a new connection pool and spawn the maintenance task.

pub async fn get(self: &Arc<Self>) -> Result<PoolGuard<C>, PoolError<C::Error>>

Check out a connection from the pool.

pub fn metrics(&self) -> PoolMetrics

Get a snapshot of pool metrics.

Note: metrics are read from atomic counters without a global lock, so values may be slightly inconsistent during high concurrency (e.g., in_use could briefly exceed total). Use saturating_sub for derived values.

pub async fn warm_up(&self, target: usize)

Pre-populate the pool to a target number of idle connections. Useful for warming up on startup to avoid first-request latency.

pub async fn drain(&self)

Initiate graceful drain.

pub fn status(&self) -> String

Current pool status string.

Trait Implementations

impl<C: Poolable> Debug for ConnPool<C>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.