Struct SyncPoolConfig 

pub struct SyncPoolConfig {
    pub endpoint: String,
    pub database: String,
    pub create_mode: CreateMode,
    pub user: Option<String>,
    pub password: Option<String>,
    pub max_size: usize,
    pub recycle: SyncRecycleStrategy,
    pub wait_timeout: Option<Duration>,
    pub max_lifetime: Option<Duration>,
    pub idle_timeout: Option<Duration>,
    pub min_idle: Option<u32>,
}

Configuration and builder for the synchronous ConnectionPool.

Mirrors the async PoolConfig surface. All optional knobs default to None/disabled and recycle defaults to SyncRecycleStrategy::SelectOne, so a config that sets only endpoint/database/max_size opens connections lazily and probes them with SELECT 1 on checkout — the natural baseline.

Timeout support

The sync pool enforces wait_timeout natively (it bounds how long ConnectionPool::get blocks waiting for a slot). create_timeout and recycle_timeout require an async runtime to interrupt a blocking syscall and are therefore async-only (PoolConfig); they are intentionally absent here to avoid pulling Tokio into the sync path.

Fields

endpoint: String

Server endpoint (e.g., “localhost:7483”).

database: String

Database path.

create_mode: CreateMode

Database creation mode (only used for the first connection).

user: Option<String>

Optional username for authentication.

password: Option<String>

Optional password for authentication.

max_size: usize

Maximum number of connections in the pool.

recycle: SyncRecycleStrategy

Per-checkout recycle strategy. Defaults to SyncRecycleStrategy::SelectOne.

wait_timeout: Option<Duration>

Maximum time ConnectionPool::get blocks waiting for a slot. None waits indefinitely (the default).

max_lifetime: Option<Duration>

Maximum lifetime of a physical connection before it is retired at checkout.

idle_timeout: Option<Duration>

Maximum idle time before a connection is retired at checkout (down to min_idle, which is kept warm).

min_idle: Option<u32>

Minimum number of idle connections to keep warm (biases idle eviction).

Implementations

impl SyncPoolConfig

pub fn new(endpoint: impl Into<String>, database: impl Into<String>) -> Self

Creates a new synchronous pool configuration.

pub fn create_mode(self, mode: CreateMode) -> Self

Sets the database creation mode.

pub fn auth(self, user: impl Into<String>, password: impl Into<String>) -> Self

Sets authentication credentials.

pub fn max_size(self, size: usize) -> Self

Sets the maximum pool size.

pub fn recycle(self, strategy: SyncRecycleStrategy) -> Self

Sets the per-checkout recycle strategy.

pub fn wait_timeout(self, timeout: Option<Duration>) -> Self

Sets the maximum time get blocks waiting for a slot.

pub fn max_lifetime(self, lifetime: Option<Duration>) -> Self

Sets the maximum lifetime of a physical connection.

pub fn idle_timeout(self, timeout: Option<Duration>) -> Self

Sets the maximum idle time before a connection is retired at checkout.

pub fn min_idle(self, min_idle: Option<u32>) -> Self

Sets the minimum number of idle connections to keep warm.

pub fn build(self) -> ConnectionPool

Builds the synchronous connection pool. Connections are opened lazily on first ConnectionPool::get.

Trait Implementations

impl Clone for SyncPoolConfig

fn clone(&self) -> SyncPoolConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SyncPoolConfig

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

Formats the value using the given formatter.