hydromodpy.core.toml_io#

TOML I/O and path-resolution helpers shared by every config layer.

Hosts the round-trip TOML loader/writer pair, the commented template generator driven by Pydantic introspection, and the path-resolution primitives used by config-aware modules.

Layer rule: this sub-package may import only the standard library, tomllib / tomli_w / tomlkit / pydantic, and hydromodpy.core.*.

Modules

descriptions

Description lookup for commented TOML mapping exports.

dynamic_examples_protocol

Protocol decoupling the TOML generator from physics/spatial.

error_locator

Map Pydantic ValidationError paths back to TOML source lines.

generator

Auto-generate commented TOML templates from Pydantic models.

io

Round-trip TOML helpers powered by tomlkit.

loader

TOML loading helpers with optional hierarchical base_config support.

merge

TOML payload merge helpers.

paths

Helpers to resolve config-declared paths and traverse TOML payloads.

writer

TOML writing helpers backed by tomli-w.