Skip to content

Configuration objects

load_config parses TOML into these frozen dataclasses, validating every key and raising ConfigError with the offending key named. The narrative reference for what each setting does is Configuration.

TOML configuration loaded into frozen dataclasses with explicit validation.

The config carries everything location-specific (DB paths, coordinates, station column/unit mappings) so the codebase itself stays station-agnostic.

ConfigError

Bases: ValueError

The TOML file is missing required keys or has ill-typed values.

ProviderQcConfig dataclass

Plausibility QC applied to provider (forecast) values before grounding.

EnsemblesConfig dataclass

Open-Meteo Ensemble API ingestion (spread features, not sources).

TruthQcConfig dataclass

Neighbor-station cross-checks (keyless NWS METAR; Synoptic opt-in).

PromotionConfig dataclass

How slice winners are promoted to serving releases.

load_config

load_config(path: Path) -> Config

Load and validate a config file; raises :class:ConfigError on problems.