Skip to content

base

etrack.infra.config.base

infra/config/base: pydantic-settings — frozen, typed, layered config, one shape for every cluster.

Every cluster inherits from here, and infra/settings merges them into the one Settings. The layers, lowest first: config file < secrets < .env < environment < kwargs. A field is its environment variable, UPPERCASE, exact: there is no prefix to add and no alias to remember. Credentials are SecretStr, masked everywhere but at the wire.

BaseSettings

Bases: BaseSettings

Subclass and declare typed UPPERCASE fields; the constructor merges every layer in one pass.

Complex values in env or .env are JSON-decoded; enums, paths and timedeltas validate on load, never at runtime. A timedelta reads ISO 8601 (PT7S) or HH:MM:SS from the environment.