Struct PgDriverBuilder 

pub struct PgDriverBuilder { /* private fields */ }

Builder for creating PgDriver connections with named parameters.

Example

let driver = PgDriver::builder()
    .host("localhost")
    .port(5432)
    .user("admin")
    .database("mydb")
    .password("secret")
    .connect()
    .await?;

Implementations

impl PgDriverBuilder

pub fn new() -> Self

Create a new builder with default values.

pub fn host(self, host: impl Into<String>) -> Self

Set the host (default: “127.0.0.1”).

pub fn port(self, port: u16) -> Self

Set the port (default: 5432).

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

Set the username (required).

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

Set the database name (required).

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

Set the password (optional, for cleartext/MD5/SCRAM-SHA-256 auth).

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

Set connection timeout (optional).

pub fn tls_mode(self, mode: TlsMode) -> Self

Set TLS policy (disable, prefer, require).

pub fn gss_enc_mode(self, mode: GssEncMode) -> Self

Set GSSAPI session encryption mode (disable, prefer, require).

pub fn tls_ca_cert_pem(self, ca_pem: Vec<u8>) -> Self

Set custom CA bundle PEM for TLS validation.

pub fn mtls(self, config: TlsConfig) -> Self

Enable mTLS using client certificate/key config.

pub fn auth_settings(self, settings: AuthSettings) -> Self

Override password-auth policy.

pub fn channel_binding_mode(self, mode: ScramChannelBindingMode) -> Self

Set SCRAM channel-binding mode.

pub fn gss_token_provider(self, provider: GssTokenProvider) -> Self

Set Kerberos/GSS/SSPI token provider callback.

pub fn gss_token_provider_ex(self, provider: GssTokenProviderEx) -> Self

Set a stateful Kerberos/GSS/SSPI token provider.

pub fn startup_param( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Add a custom StartupMessage parameter.

Example: .startup_param("application_name", "qail-replica")

pub fn logical_replication(self) -> Self

Enable logical replication startup mode (replication=database).

This is required before issuing commands like IDENTIFY_SYSTEM or CREATE_REPLICATION_SLOT on a replication connection.

pub async fn connect(self) -> PgResult<PgDriver>

Connect to PostgreSQL using the configured parameters.

Trait Implementations

impl Default for PgDriverBuilder

fn default() -> PgDriverBuilder

Returns the “default value” for a type.