v0.7.1
Frequenz Gridpool Library Release Notes
Summary
This release rounds out gridpool-cli for the assets config layout and adds
gridpool enterprise ownership to the config model. The CLI can now generate,
validate, patch, and query merged config files.
Upgrading
-
generate-confignow writes theassets.microgridslayout and stamps
assets.version, instead of the legacy layout. Regenerate configs to get the
current format; generated files then load back without a migration. -
generate-config --inplacerefuses legacy-layout files (top-level or
meta-nested), which it would duplicate rather than edit. Rebuild those from
scratch.
New Features
-
gridpool-cli validate <files>checks config files offline and exits
non-zero on the first error, to gate config-repo CI. Each file must be valid
on its own, so a record names its own key and required fields; the files are
then checked merged, for the cross-record checks. -
gridpool-cliacceptsFREQUENZ_API_KEYandFREQUENZ_API_SECRETas a
fallback pair forASSETS_API_AUTH_KEYandASSETS_API_SIGN_SECRET. -
Gridpools are described under
assets.gridpools, each entry naming the
enterprise that owns the gridpool.AssetsConfig.find_enterprise(gridpool_id)
returns the configured owner.
gridpool-cli find-enterprise <gridpool_id> <files>prints it from the config.
AssetsConfig.checkenforces the one-enterprise-per-gridpool invariant: a
gridpool's microgrids may not disagree on it, and a declared enterprise must
match the inferred one. -
A config derived from the Assets API now carries each microgrid's
enterprise_id. -
generate-config --inplacerefreshes managed values while preserving
formatting;--fill-missingonly adds absent values. Generated patches are
validated before writing.
What's Changed
- feat(config,cli): add assets-layout tooling and gridpool enterprise ownership by @cwasicki in #130
- Update release notes by @cwasicki in #131
Full Changelog: v0.7.0...v0.7.1