Struct DatabaseConfig 

pub struct DatabaseConfig {
    pub url: Option<String>,
    pub primary_url: Option<String>,
    pub replica_url: Option<String>,
    pub pool_size: usize,
    pub primary_pool_size: Option<usize>,
    pub replica_pool_size: Option<usize>,
    pub replica_fallback: ReplicaFallback,
    pub connect_timeout_secs: u64,
    pub auto_migrate_in_production: bool,
}

Database connection configuration.

When url is None (the default), the application runs without a database – useful for static-site or API-gateway use cases. Set a Postgres URL to enable the connection pool and the Db extractor.

Defaults

Field	Default
url	None
primary_url	None
replica_url	None
pool_size	10
primary_pool_size	None
replica_pool_size	None
replica_fallback	fail_readiness
connect_timeout_secs	5
auto_migrate_in_production	false

Examples

use autumn_web::config::DatabaseConfig;

let db = DatabaseConfig::default();
assert!(db.url.is_none());
assert_eq!(db.pool_size, 10);

Fields

url: Option<String>

Postgres connection URL. None means no database is configured.

Compatibility alias for the primary/write role. New multi-role deployments should prefer primary_url.

Must start with postgres:// or postgresql:// when present.

primary_url: Option<String>

Postgres URL for the primary/write role.

All writes, transactions, advisory locks, and migrations use this role. When unset, url remains the single-primary fallback.

replica_url: Option<String>

Optional Postgres URL for the read/replica role.

Read-only paths may use this pool when configured. If omitted, read paths use the primary role.

pool_size: usize

Maximum number of connections in the pool. Default: 10.

Compatibility/default pool size used for both roles unless a role-specific size is set.

primary_pool_size: Option<usize>

Optional primary/write role pool size.

replica_pool_size: Option<usize>

Optional read/replica role pool size.

replica_fallback: ReplicaFallback

Deterministic behavior for configured replicas that cannot safely serve reads. Default: fail readiness.

connect_timeout_secs: u64

Seconds to wait while acquiring a pooled connection, including creating a new connection when the pool grows. Default: 5.

auto_migrate_in_production: bool

When true, permits automatic migration application while running with prod/production profile. Default: false.

Keep this disabled for multi-replica production fleets and use an explicit migration job (autumn migrate) instead.

Implementations

impl DatabaseConfig

pub fn effective_primary_url(&self) -> Option<&str>

Resolved primary/write database URL.

pub fn effective_primary_pool_size(&self) -> usize

Resolved primary/write role pool size.

pub fn effective_replica_pool_size(&self) -> usize

Resolved read/replica role pool size.

pub fn validate(&self) -> Result<(), ConfigError>

Validate database configuration.

Errors

Returns a validation error if the URL has an invalid scheme.

Trait Implementations

impl Clone for DatabaseConfig

fn clone(&self) -> DatabaseConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DatabaseConfig

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

Formats the value using the given formatter.

impl Default for DatabaseConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DatabaseConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.