hydromodpy.config.migrations

Payload-level migrations between TOML schema versions.

The current TOML payload format is implicitly versioned: the public contract is the HydroModPyConfig Pydantic model whose JSON Schema companion (config.json) is fingerprinted via schema_sha256.

This module declares the API used by the loader to upgrade older payloads in-place before model validation. Today only the identity migration is registered (v1 -> v1). A breaking schema change will register a real v_from -> v_to step here without touching the loader call-sites.

Functions

migrate_payload(payload, v_from, v_to)

Apply the chain of payload migrations from v_from to v_to.