frequenz-gridpool 0.7.1__tar.gz → 0.9.0__tar.gz

{frequenz_gridpool-0.7.1/src/frequenz_gridpool.egg-info → frequenz_gridpool-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frequenz-gridpool
-Version: 0.7.1
+Version: 0.9.0
 Summary: High-level interface to grid pools for the Frequenz platform.
 Author-email: Frequenz Energy-as-a-Service GmbH <floss@frequenz.com>
 License-Expression: MIT
@@ -19,9 +19,10 @@ Classifier: Typing :: Typed
 Requires-Python: <4,>=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: marshmallow<5,>=3.18.0
 Requires-Dist: marshmallow-dataclass<9,>=8.7.1
 Requires-Dist: typing-extensions<5,>=4.14.1
-Requires-Dist: frequenz-microgrid-component-graph<0.6,>=0.5.0
+Requires-Dist: frequenz-microgrid-component-graph<0.7,>=0.6.0
 Requires-Dist: frequenz-client-assets<0.6,>=0.5.0
 Provides-Extra: cli
 Requires-Dist: asyncclick<9,>=8.3.0.4; extra == "cli"
@@ -31,8 +32,8 @@ Requires-Dist: frequenz-gridpool[cli]; extra == "render-graph"
 Requires-Dist: matplotlib<4,>=3.7.0; extra == "render-graph"
 Requires-Dist: networkx<4,>=3.0; extra == "render-graph"
 Provides-Extra: dev-flake8
-Requires-Dist: flake8==7.3.0; extra == "dev-flake8"
-Requires-Dist: flake8-datetimez==20.10.0; extra == "dev-flake8"
+Requires-Dist: flake8==7.4.1; extra == "dev-flake8"
+Requires-Dist: flake8-datetimez==26.8.1; extra == "dev-flake8"
 Requires-Dist: flake8-docstrings==1.7.0; extra == "dev-flake8"
 Requires-Dist: flake8-pyproject==1.2.4; extra == "dev-flake8"
 Requires-Dist: pydoclint==0.9.1; extra == "dev-flake8"
@@ -41,31 +42,31 @@ Provides-Extra: dev-formatting
 Requires-Dist: black==26.5.1; extra == "dev-formatting"
 Requires-Dist: isort==8.0.1; extra == "dev-formatting"
 Provides-Extra: dev-mkdocs
-Requires-Dist: Markdown==3.10.2; extra == "dev-mkdocs"
+Requires-Dist: Markdown==3.11; extra == "dev-mkdocs"
 Requires-Dist: black==26.5.1; extra == "dev-mkdocs"
 Requires-Dist: mike==2.2.0; extra == "dev-mkdocs"
 Requires-Dist: mkdocs-gen-files==0.6.1; extra == "dev-mkdocs"
 Requires-Dist: mkdocs-literate-nav==0.6.3; extra == "dev-mkdocs"
 Requires-Dist: mkdocs-macros-plugin==1.5.0; extra == "dev-mkdocs"
 Requires-Dist: mkdocs-material==9.7.7; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings[python]==1.0.6; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings-python==2.0.5; extra == "dev-mkdocs"
-Requires-Dist: frequenz-repo-config[lib]==0.18.0; extra == "dev-mkdocs"
+Requires-Dist: mkdocstrings[python]==1.0.7; extra == "dev-mkdocs"
+Requires-Dist: mkdocstrings-python==2.0.9; extra == "dev-mkdocs"
+Requires-Dist: frequenz-repo-config[lib]==0.19.0; extra == "dev-mkdocs"
 Provides-Extra: dev-mypy
-Requires-Dist: mypy==2.3.0; extra == "dev-mypy"
+Requires-Dist: mypy==2.3.1; extra == "dev-mypy"
 Requires-Dist: types-networkx>=3.6.1.20251220; extra == "dev-mypy"
 Requires-Dist: types-Markdown==3.10.2.20260712; extra == "dev-mypy"
 Requires-Dist: frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-mypy"
 Provides-Extra: dev-noxfile
-Requires-Dist: nox==2026.7.11; extra == "dev-noxfile"
-Requires-Dist: frequenz-repo-config[lib]==0.18.0; extra == "dev-noxfile"
+Requires-Dist: nox==2026.8.17; extra == "dev-noxfile"
+Requires-Dist: frequenz-repo-config[lib]==0.19.0; extra == "dev-noxfile"
 Provides-Extra: dev-pylint
 Requires-Dist: frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-pylint"
 Provides-Extra: dev-pytest
 Requires-Dist: pytest==9.1.1; extra == "dev-pytest"
-Requires-Dist: pylint==4.0.6; extra == "dev-pytest"
-Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.18.0; extra == "dev-pytest"
-Requires-Dist: pytest-mock==3.15.1; extra == "dev-pytest"
+Requires-Dist: pylint==4.0.9; extra == "dev-pytest"
+Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.19.0; extra == "dev-pytest"
+Requires-Dist: pytest-mock==3.16.0; extra == "dev-pytest"
 Requires-Dist: pytest-asyncio==1.4.0; extra == "dev-pytest"
 Requires-Dist: async-solipsism==0.9; extra == "dev-pytest"
 Requires-Dist: frequenz-gridpool[render-graph]; extra == "dev-pytest"

frequenz_gridpool-0.9.0/RELEASE_NOTES.md

@@ -0,0 +1,20 @@
+# Frequenz Gridpool Library Release Notes
+
+## Summary
+
+<!-- Here goes a general summary of what this release is about -->
+
+## Upgrading
+
+- Requires `frequenz-microgrid-component-graph` 0.6, which stops clamping the consumer
+  and producer formulas. `ComponentGraph.consumer_formula()` and
+  `ComponentGraph.producer_formula()` can now return values previously pinned
+  to zero: a negative consumer total, or a positive producer total.
+
+## New Features
+
+<!-- Here goes the main new features and examples or instructions on how to use them -->
+
+## Bug Fixes
+
+<!-- Here goes notable bug fixes that are worth a special mention or explanation -->

{frequenz_gridpool-0.7.1 → frequenz_gridpool-0.9.0}/pyproject.toml

@@ -3,9 +3,9 @@
 
 [build-system]
 requires = [
-  "setuptools == 83.0.0",
-  "setuptools_scm[toml] == 10.2.1",
-  "frequenz-repo-config[lib] == 0.18.0",
+  "setuptools == 84.0.0",
+  "setuptools_scm[toml] == 10.3.4",
+  "frequenz-repo-config[lib] == 0.19.0",
 ]
 build-backend = "setuptools.build_meta"
 
@@ -26,9 +26,13 @@ classifiers = [
 ]
 requires-python = ">= 3.11, < 4"
 dependencies = [
+  # Used transitively via marshmallow-dataclass (every config schema is a
+  # `marshmallow.Schema`); declared directly so `pytest_min` pins its lower
+  # bound and the minimum-version path is actually tested.
+  "marshmallow >= 3.18.0, < 5",
   "marshmallow-dataclass >= 8.7.1, < 9",
   "typing-extensions >= 4.14.1, < 5",
-  "frequenz-microgrid-component-graph >= 0.5.0, < 0.6",
+  "frequenz-microgrid-component-graph >= 0.6.0, < 0.7",
   "frequenz-client-assets >= 0.5.0, < 0.6",
 ]
 dynamic = ["version"]
@@ -52,8 +56,8 @@ render-graph = [
 ]
 
 dev-flake8 = [
-  "flake8 == 7.3.0",
-  "flake8-datetimez == 20.10.0",
+  "flake8 == 7.4.1",
+  "flake8-datetimez == 26.8.1",
   "flake8-docstrings == 1.7.0",
   "flake8-pyproject == 1.2.4",  # For reading the flake8 config from pyproject.toml
   "pydoclint == 0.9.1",
@@ -61,27 +65,27 @@ dev-flake8 = [
 ]
 dev-formatting = ["black == 26.5.1", "isort == 8.0.1"]
 dev-mkdocs = [
-  "Markdown == 3.10.2",
+  "Markdown == 3.11",
   "black == 26.5.1",
   "mike == 2.2.0",
   "mkdocs-gen-files == 0.6.1",
   "mkdocs-literate-nav == 0.6.3",
   "mkdocs-macros-plugin == 1.5.0",
   "mkdocs-material == 9.7.7",
-  "mkdocstrings[python] == 1.0.6",
-  "mkdocstrings-python == 2.0.5",
-  "frequenz-repo-config[lib] == 0.18.0",
+  "mkdocstrings[python] == 1.0.7",
+  "mkdocstrings-python == 2.0.9",
+  "frequenz-repo-config[lib] == 0.19.0",
 ]
 dev-mypy = [
-  "mypy == 2.3.0",
+  "mypy == 2.3.1",
   "types-networkx>=3.6.1.20251220",
   "types-Markdown == 3.10.2.20260712",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
 dev-noxfile = [
-  "nox == 2026.7.11",
-  "frequenz-repo-config[lib] == 0.18.0",
+  "nox == 2026.8.17",
+  "frequenz-repo-config[lib] == 0.19.0",
 ]
 dev-pylint = [
   # dev-pytest already defines a dependency to pylint because of the examples
@@ -90,9 +94,9 @@ dev-pylint = [
 ]
 dev-pytest = [
   "pytest == 9.1.1",
-  "pylint == 4.0.6",       # We need this to check for the examples
-  "frequenz-repo-config[extra-lint-examples] == 0.18.0",
-  "pytest-mock == 3.15.1",
+  "pylint == 4.0.9",       # We need this to check for the examples
+  "frequenz-repo-config[extra-lint-examples] == 0.19.0",
+  "pytest-mock == 3.16.0",
   "pytest-asyncio == 1.4.0",
   "async-solipsism == 0.9",
   # The tests cover the cli package and the graph renderer.  render-graph
@@ -168,13 +172,15 @@ disable = [
 ]
 
 [tool.pytest.ini_options]
-addopts = "-W=all -Werror -Wdefault::DeprecationWarning -Wdefault::PendingDeprecationWarning -vv"
+addopts = "-W=all -Werror -Wdefault::DeprecationWarning -Wdefault::PendingDeprecationWarning"
 testpaths = ["tests", "src"]
+asyncio_debug = true
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "function"
 required_plugins = ["pytest-asyncio", "pytest-mock"]
 
 [tool.mypy]
+enable_error_code = ["exhaustive-match"]
 explicit_package_bases = true
 namespace_packages = true
 # This option disables mypy cache, and it is sometimes useful to enable it if

{frequenz_gridpool-0.7.1 → frequenz_gridpool-0.9.0}/src/frequenz/gridpool/cli/_dump_config.py

@@ -17,6 +17,7 @@ escaping, key-quoting, list/number/datetime formatting) is delegated to
 fields are done here, since TOML has no null and `tomlkit` rejects it.
 """
 
+from dataclasses import asdict
 from typing import Any
 
 import tomlkit
@@ -86,13 +87,10 @@ def dump_map(configs: dict[int, MicrogridConfig]) -> str:
         The TOML representation as a string, with one blank line between
         microgrids and entries sorted by numeric microgrid ID.
     """
-    schema = MicrogridConfig.Schema()
     doc = tomlkit.document()
     doc.append(tomlkit.key(["assets", "version"]), _CURRENT_VERSION)
     for mid in sorted(configs):
-        dumped = schema.dump(configs[mid])
-        assert isinstance(dumped, dict)
-        leaves = _iter_leaves([*_MICROGRID_PREFIX, str(mid)], dumped)
+        leaves = _iter_leaves([*_MICROGRID_PREFIX, str(mid)], asdict(configs[mid]))
         if not leaves:
             continue
         doc.add(tomlkit.nl())

{frequenz_gridpool-0.7.1 → frequenz_gridpool-0.9.0}/src/frequenz/gridpool/cli/_patch_config.py

@@ -10,6 +10,7 @@ survive. By default it refreshes the managed leaves, overwriting them; with
 """
 
 from collections.abc import Mapping
+from dataclasses import asdict
 from pathlib import Path
 from typing import Any
 
@@ -54,7 +55,6 @@ def patch_text(
     """
     doc = tomlkit.parse(original)
     _reject_legacy_layout(doc)
-    schema = MicrogridConfig.Schema()
 
     # Leaves needing a whole new sub-table can't be inserted via item assignment
     # without tomlkit falling back to bracket-header syntax, so they are spliced
@@ -63,9 +63,7 @@ def patch_text(
 
     for microgrid_id, cfg in configs.items():
         mid = str(microgrid_id)
-        dumped = schema.dump(cfg)
-        assert isinstance(dumped, dict)
-        leaves = _iter_leaves([], dumped)
+        leaves = _iter_leaves([], asdict(cfg))
         if not leaves:
             continue
 

{frequenz_gridpool-0.7.1 → frequenz_gridpool-0.9.0}/src/frequenz/gridpool/config/_assets.py

@@ -443,23 +443,28 @@ class AssetsConfig:
         """Read the raw `assets` table from a TOML file.
 
         The document is migrated to the current format before its `assets`
-        table is returned for merging.
+        table is returned for merging. A file with no `assets` table contributes
+        nothing to the merge, so consumers can pass a mixed list of files and
+        gridpool reads only the `assets`-bearing ones.
 
         Args:
             config_path: The path to the TOML configuration file.
 
         Returns:
-            The raw `assets` table, unvalidated, for merging before it is loaded.
+            The raw `assets` table, unvalidated, for merging before it is loaded,
+            or an empty table if the file has none.
 
         Raises:
-            TypeError: If `assets` is not a table.
+            TypeError: If `assets` is present but not a table.
         """
         with config_path.open("rb") as f:
             data: dict[str, Any] = tomllib.load(f)
 
         data = migrate(data, config_path)
 
-        assets = data["assets"]
+        assets = data.get("assets")
+        if assets is None:
+            return {}
         if not isinstance(assets, dict):
             raise TypeError(
                 f"{config_path}: `assets` must be a table, got {type(assets)}"

frequenz_gridpool-0.9.0/src/frequenz/gridpool/config/_fields.py

@@ -0,0 +1,29 @@
+# License: MIT
+# Copyright © 2026 Frequenz Energy-as-a-Service GmbH
+
+"""Reusable marshmallow fields for config data models."""
+
+from datetime import datetime
+from typing import Any
+
+import marshmallow
+
+
+class TomlAwareDateTime(marshmallow.fields.DateTime):
+    """A `DateTime` that also accepts an already-parsed `datetime`.
+
+    marshmallow 3's `DateTime` deserialises only ISO strings, but `tomllib`
+    yields native `datetime` objects before the value reaches marshmallow, so
+    those inputs must pass through unchanged. marshmallow 4 accepts them itself;
+    this keeps both behaving the same.
+    """
+
+    def _deserialize(self, value: Any, *args: Any, **kwargs: Any) -> datetime:
+        if isinstance(value, datetime):
+            return value
+        return super()._deserialize(value, *args, **kwargs)
+
+
+def toml_datetime_metadata() -> dict[str, Any]:
+    """Field metadata mapping a TOML-sourced `datetime` to `TomlAwareDateTime`."""
+    return {"marshmallow_field": TomlAwareDateTime(allow_none=True)}

{frequenz_gridpool-0.7.1 → frequenz_gridpool-0.9.0}/src/frequenz/gridpool/config/_microgrid.py

@@ -11,6 +11,8 @@ from typing import Any, ClassVar, Literal, Self, Type, cast, get_args
 from marshmallow import Schema
 from marshmallow_dataclass import dataclass
 
+from ._fields import toml_datetime_metadata
+
 ComponentType = Literal["grid", "pv", "battery", "consumption", "chp", "ev"]
 """Valid component types."""
 
@@ -98,10 +100,10 @@ class ComponentTypeConfig:
 class PVConfig:
     """Configuration of a PV system in a microgrid."""
 
-    start_time: datetime | None = None
+    start_time: datetime | None = field(default=None, metadata=toml_datetime_metadata())
     """Start time of the PV system installation."""
 
-    end_time: datetime | None = None
+    end_time: datetime | None = field(default=None, metadata=toml_datetime_metadata())
     """End time of the PV system installation."""
 
     peak_power: float | None = None
@@ -119,10 +121,10 @@ class WindConfig:
     # pylint: disable=too-many-instance-attributes
     """Configuration of a wind turbine in a microgrid."""
 
-    start_time: datetime | None = None
+    start_time: datetime | None = field(default=None, metadata=toml_datetime_metadata())
     """Start time of the wind turbine installation."""
 
-    end_time: datetime | None = None
+    end_time: datetime | None = field(default=None, metadata=toml_datetime_metadata())
     """End time of the wind turbine installation."""
 
     turbine_model: str | None = None
@@ -151,10 +153,10 @@ class WindConfig:
 class BatteryConfig:
     """Configuration of a battery in a microgrid."""
 
-    start_time: datetime | None = None
+    start_time: datetime | None = field(default=None, metadata=toml_datetime_metadata())
     """Start time of the battery installation."""
 
-    end_time: datetime | None = None
+    end_time: datetime | None = field(default=None, metadata=toml_datetime_metadata())
     """End time of the battery installation."""
 
     capacity: float | None = None
@@ -187,10 +189,10 @@ class MicrogridConfig:
     altitude: float | None = None
     """Geographic altitude of the microgrid."""
 
-    start_time: datetime | None = None
+    start_time: datetime | None = field(default=None, metadata=toml_datetime_metadata())
     """Start time of the microgrid operation."""
 
-    end_time: datetime | None = None
+    end_time: datetime | None = field(default=None, metadata=toml_datetime_metadata())
     """End time of the microgrid operation."""
 
     pv: dict[str, PVConfig] | None = None

frequenz_gridpool-0.9.0/src/frequenz/gridpool/config/_migrations.py

@@ -0,0 +1,58 @@
+# License: MIT
+# Copyright © 2026 Frequenz Energy-as-a-Service GmbH
+
+"""Format migrations for raw config documents.
+
+Loading validates `assets.version` and stamps the current version, so a file
+written for a newer reader is rejected rather than silently misread. Each
+migration step rewrites the raw `dict` before it is loaded into the typed
+model; steps are self-detecting and idempotent, so the `version` field does not
+gate whether a step runs. No legacy layouts remain, so `_STEPS` is empty.
+"""
+
+from pathlib import Path
+from typing import Any, Callable
+
+_CURRENT_VERSION = 1
+
+
+def migrate(raw: dict[str, Any], source: Path) -> dict[str, Any]:
+    """Migrate a raw config document to the current format.
+
+    Reads and validates `assets.version` (absent means the oldest, `0`), applies
+    every self-detecting step, and stamps the current version. The version sits
+    inside `assets` so it tracks the assets format alone, not the whole document.
+
+    Args:
+        raw: The raw document as parsed from a file.
+        source: The file it was parsed from, named in error messages.
+
+    Returns:
+        The document in the current format.
+
+    Raises:
+        TypeError: If `assets.version` is not an integer.
+        ValueError: If `assets.version` is outside the supported range.
+    """
+    assets = raw.get("assets")
+    version = assets.get("version", 0) if isinstance(assets, dict) else 0
+    if not isinstance(version, int) or isinstance(version, bool):
+        raise TypeError(f"{source}: `assets.version` must be an integer")
+    if version < 0:
+        raise ValueError(f"{source}: `assets.version` must not be negative")
+    if version > _CURRENT_VERSION:
+        raise ValueError(
+            f"{source}: assets version {version} is newer than supported "
+            f"version {_CURRENT_VERSION}"
+        )
+
+    for _, step in _STEPS:
+        raw = step(raw, source)
+    assets = raw.get("assets")
+    if isinstance(assets, dict):
+        assets["version"] = _CURRENT_VERSION
+    return raw
+
+
+_STEPS: list[tuple[int, Callable[[dict[str, Any], Path], dict[str, Any]]]] = []
+"""Migration steps as `(from_version, step)`, oldest first."""

{frequenz_gridpool-0.7.1 → frequenz_gridpool-0.9.0}/src/frequenz/gridpool/config/_topology.py

@@ -26,6 +26,8 @@ from frequenz.client.assets import (
 from marshmallow import Schema
 from marshmallow_dataclass import dataclass
 
+from ._fields import toml_datetime_metadata
+
 _EIC_ALPHABET = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ-"
 _MARKET_AREA_EU_DE = 101
 
@@ -165,10 +167,10 @@ class ValidityConfig:
     participation: MarketParticipationType | None = None
     """The market use case, unset for a plain validity window."""
 
-    start: datetime | None = None
+    start: datetime | None = field(default=None, metadata=toml_datetime_metadata())
     """Inclusive start of the period."""
 
-    end: datetime | None = None
+    end: datetime | None = field(default=None, metadata=toml_datetime_metadata())
     """Exclusive end of the period."""
 
     Schema: ClassVar[Type[Schema]] = Schema

{frequenz_gridpool-0.7.1 → frequenz_gridpool-0.9.0/src/frequenz_gridpool.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frequenz-gridpool
-Version: 0.7.1
+Version: 0.9.0
 Summary: High-level interface to grid pools for the Frequenz platform.
 Author-email: Frequenz Energy-as-a-Service GmbH <floss@frequenz.com>
 License-Expression: MIT
@@ -19,9 +19,10 @@ Classifier: Typing :: Typed
 Requires-Python: <4,>=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: marshmallow<5,>=3.18.0
 Requires-Dist: marshmallow-dataclass<9,>=8.7.1
 Requires-Dist: typing-extensions<5,>=4.14.1
-Requires-Dist: frequenz-microgrid-component-graph<0.6,>=0.5.0
+Requires-Dist: frequenz-microgrid-component-graph<0.7,>=0.6.0
 Requires-Dist: frequenz-client-assets<0.6,>=0.5.0
 Provides-Extra: cli
 Requires-Dist: asyncclick<9,>=8.3.0.4; extra == "cli"
@@ -31,8 +32,8 @@ Requires-Dist: frequenz-gridpool[cli]; extra == "render-graph"
 Requires-Dist: matplotlib<4,>=3.7.0; extra == "render-graph"
 Requires-Dist: networkx<4,>=3.0; extra == "render-graph"
 Provides-Extra: dev-flake8
-Requires-Dist: flake8==7.3.0; extra == "dev-flake8"
-Requires-Dist: flake8-datetimez==20.10.0; extra == "dev-flake8"
+Requires-Dist: flake8==7.4.1; extra == "dev-flake8"
+Requires-Dist: flake8-datetimez==26.8.1; extra == "dev-flake8"
 Requires-Dist: flake8-docstrings==1.7.0; extra == "dev-flake8"
 Requires-Dist: flake8-pyproject==1.2.4; extra == "dev-flake8"
 Requires-Dist: pydoclint==0.9.1; extra == "dev-flake8"
@@ -41,31 +42,31 @@ Provides-Extra: dev-formatting
 Requires-Dist: black==26.5.1; extra == "dev-formatting"
 Requires-Dist: isort==8.0.1; extra == "dev-formatting"
 Provides-Extra: dev-mkdocs
-Requires-Dist: Markdown==3.10.2; extra == "dev-mkdocs"
+Requires-Dist: Markdown==3.11; extra == "dev-mkdocs"
 Requires-Dist: black==26.5.1; extra == "dev-mkdocs"
 Requires-Dist: mike==2.2.0; extra == "dev-mkdocs"
 Requires-Dist: mkdocs-gen-files==0.6.1; extra == "dev-mkdocs"
 Requires-Dist: mkdocs-literate-nav==0.6.3; extra == "dev-mkdocs"
 Requires-Dist: mkdocs-macros-plugin==1.5.0; extra == "dev-mkdocs"
 Requires-Dist: mkdocs-material==9.7.7; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings[python]==1.0.6; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings-python==2.0.5; extra == "dev-mkdocs"
-Requires-Dist: frequenz-repo-config[lib]==0.18.0; extra == "dev-mkdocs"
+Requires-Dist: mkdocstrings[python]==1.0.7; extra == "dev-mkdocs"
+Requires-Dist: mkdocstrings-python==2.0.9; extra == "dev-mkdocs"
+Requires-Dist: frequenz-repo-config[lib]==0.19.0; extra == "dev-mkdocs"
 Provides-Extra: dev-mypy
-Requires-Dist: mypy==2.3.0; extra == "dev-mypy"
+Requires-Dist: mypy==2.3.1; extra == "dev-mypy"
 Requires-Dist: types-networkx>=3.6.1.20251220; extra == "dev-mypy"
 Requires-Dist: types-Markdown==3.10.2.20260712; extra == "dev-mypy"
 Requires-Dist: frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-mypy"
 Provides-Extra: dev-noxfile
-Requires-Dist: nox==2026.7.11; extra == "dev-noxfile"
-Requires-Dist: frequenz-repo-config[lib]==0.18.0; extra == "dev-noxfile"
+Requires-Dist: nox==2026.8.17; extra == "dev-noxfile"
+Requires-Dist: frequenz-repo-config[lib]==0.19.0; extra == "dev-noxfile"
 Provides-Extra: dev-pylint
 Requires-Dist: frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-pylint"
 Provides-Extra: dev-pytest
 Requires-Dist: pytest==9.1.1; extra == "dev-pytest"
-Requires-Dist: pylint==4.0.6; extra == "dev-pytest"
-Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.18.0; extra == "dev-pytest"
-Requires-Dist: pytest-mock==3.15.1; extra == "dev-pytest"
+Requires-Dist: pylint==4.0.9; extra == "dev-pytest"
+Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.19.0; extra == "dev-pytest"
+Requires-Dist: pytest-mock==3.16.0; extra == "dev-pytest"
 Requires-Dist: pytest-asyncio==1.4.0; extra == "dev-pytest"
 Requires-Dist: async-solipsism==0.9; extra == "dev-pytest"
 Requires-Dist: frequenz-gridpool[render-graph]; extra == "dev-pytest"

{frequenz_gridpool-0.7.1 → frequenz_gridpool-0.9.0}/src/frequenz_gridpool.egg-info/SOURCES.txt

@@ -14,6 +14,7 @@ src/frequenz/gridpool/cli/_patch_config.py
 src/frequenz/gridpool/cli/_render_graph.py
 src/frequenz/gridpool/config/__init__.py
 src/frequenz/gridpool/config/_assets.py
+src/frequenz/gridpool/config/_fields.py
 src/frequenz/gridpool/config/_gridpool.py
 src/frequenz/gridpool/config/_load.py
 src/frequenz/gridpool/config/_microgrid.py

{frequenz_gridpool-0.7.1 → frequenz_gridpool-0.9.0}/src/frequenz_gridpool.egg-info/requires.txt

@@ -1,6 +1,7 @@
+marshmallow<5,>=3.18.0
 marshmallow-dataclass<9,>=8.7.1
 typing-extensions<5,>=4.14.1
-frequenz-microgrid-component-graph<0.6,>=0.5.0
+frequenz-microgrid-component-graph<0.7,>=0.6.0
 frequenz-client-assets<0.6,>=0.5.0
 
 [cli]
@@ -11,8 +12,8 @@ tomlkit<1,>=0.13.0
 frequenz-gridpool[dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-pylint,dev-pytest,render-graph]
 
 [dev-flake8]
-flake8==7.3.0
-flake8-datetimez==20.10.0
+flake8==7.4.1
+flake8-datetimez==26.8.1
 flake8-docstrings==1.7.0
 flake8-pyproject==1.2.4
 pydoclint==0.9.1
@@ -23,35 +24,35 @@ black==26.5.1
 isort==8.0.1
 
 [dev-mkdocs]
-Markdown==3.10.2
+Markdown==3.11
 black==26.5.1
 mike==2.2.0
 mkdocs-gen-files==0.6.1
 mkdocs-literate-nav==0.6.3
 mkdocs-macros-plugin==1.5.0
 mkdocs-material==9.7.7
-mkdocstrings[python]==1.0.6
-mkdocstrings-python==2.0.5
-frequenz-repo-config[lib]==0.18.0
+mkdocstrings[python]==1.0.7
+mkdocstrings-python==2.0.9
+frequenz-repo-config[lib]==0.19.0
 
 [dev-mypy]
-mypy==2.3.0
+mypy==2.3.1
 types-networkx>=3.6.1.20251220
 types-Markdown==3.10.2.20260712
 frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]
 
 [dev-noxfile]
-nox==2026.7.11
-frequenz-repo-config[lib]==0.18.0
+nox==2026.8.17
+frequenz-repo-config[lib]==0.19.0
 
 [dev-pylint]
 frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]
 
 [dev-pytest]
 pytest==9.1.1
-pylint==4.0.6
-frequenz-repo-config[extra-lint-examples]==0.18.0
-pytest-mock==3.15.1
+pylint==4.0.9
+frequenz-repo-config[extra-lint-examples]==0.19.0
+pytest-mock==3.16.0
 pytest-asyncio==1.4.0
 async-solipsism==0.9
 frequenz-gridpool[render-graph]

{frequenz_gridpool-0.7.1 → frequenz_gridpool-0.9.0}/src/frequenz_gridpool.egg-info/scm_file_list.json

@@ -13,7 +13,6 @@
     ".github/workflows/black-migration.yaml",
     ".github/workflows/ci-pr.yaml",
     ".github/workflows/ci.yaml",
-    ".github/workflows/dco-merge-queue.yml",
     ".github/workflows/isort-migration.yaml",
     ".github/workflows/labeler.yml",
     ".github/workflows/release-notes-check.yml",
@@ -45,6 +44,7 @@
     "src/frequenz/gridpool/cli/_render_graph.py",
     "src/frequenz/gridpool/config/__init__.py",
     "src/frequenz/gridpool/config/_assets.py",
+    "src/frequenz/gridpool/config/_fields.py",
     "src/frequenz/gridpool/config/_gridpool.py",
     "src/frequenz/gridpool/config/_load.py",
     "src/frequenz/gridpool/config/_microgrid.py",

frequenz_gridpool-0.9.0/src/frequenz_gridpool.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.9.0",
+  "distance": 0,
+  "node": "g89c4f0c9d5205d548fb84419c3e63e6a4bd9608b",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-10-14"
+}

frequenz_gridpool-0.7.1/RELEASE_NOTES.md

@@ -1,42 +0,0 @@
-# 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-config` now writes the `assets.microgrids` layout 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 --inplace` refuses 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-cli` accepts `FREQUENZ_API_KEY` and `FREQUENZ_API_SECRET` as a
-  fallback pair for `ASSETS_API_AUTH_KEY` and `ASSETS_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.check` enforces 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 --inplace` refreshes managed values while preserving
-  formatting; `--fill-missing` only adds absent values. Generated patches are
-  validated before writing.

frequenz_gridpool-0.7.1/src/frequenz/gridpool/config/_migrations.py

@@ -1,139 +0,0 @@
-# License: MIT
-# Copyright © 2026 Frequenz Energy-as-a-Service GmbH
-
-"""Format migrations for raw config documents.
-
-Each step rewrites the raw `dict` a file parses to, before it is loaded into the
-typed model. Steps are self-detecting and idempotent, so the `version` field
-does not gate whether a step runs; it only records how old a file may be, which
-bounds when a step may be dropped.
-"""
-
-import logging
-from pathlib import Path
-from typing import Any, Callable
-
-_logger = logging.getLogger(__name__)
-
-_CURRENT_VERSION = 1
-
-
-def migrate(raw: dict[str, Any], source: Path) -> dict[str, Any]:
-    """Migrate a raw config document to the current format.
-
-    Reads and validates `assets.version` (absent means the oldest, `0`), applies
-    every self-detecting step, and stamps the current version. The version sits
-    inside `assets` so it tracks the assets format alone, not the whole document.
-
-    Args:
-        raw: The raw document as parsed from a file.
-        source: The file it was parsed from, for warnings and errors.
-
-    Returns:
-        The document in the current format.
-
-    Raises:
-        TypeError: If `assets.version` is not an integer.
-        ValueError: If `assets.version` is outside the supported range.
-    """
-    assets = raw.get("assets")
-    version = assets.get("version", 0) if isinstance(assets, dict) else 0
-    if not isinstance(version, int) or isinstance(version, bool):
-        raise TypeError(f"{source}: `assets.version` must be an integer")
-    if version < 0:
-        raise ValueError(f"{source}: `assets.version` must not be negative")
-    if version > _CURRENT_VERSION:
-        raise ValueError(
-            f"{source}: assets version {version} is newer than supported "
-            f"version {_CURRENT_VERSION}"
-        )
-
-    for _, step in _STEPS:
-        raw = step(raw, source)
-    assets = raw.get("assets")
-    if isinstance(assets, dict):
-        assets["version"] = _CURRENT_VERSION
-    return raw
-
-
-def _nest_top_level_microgrids(raw: dict[str, Any], source: Path) -> dict[str, Any]:
-    """Wrap deprecated top-level microgrid entries under `assets.microgrids`.
-
-    Args:
-        raw: The raw document.
-        source: The file it was parsed from.
-
-    Returns:
-        The document with its entries under `assets`.
-
-    Raises:
-        ValueError: If both layouts are present, a half-migrated file rather
-            than a merge.
-    """
-    if "assets" in raw:
-        stray = sorted(k for k in raw if k != "assets")
-        if stray:
-            raise ValueError(
-                f"{source}: keys {stray} sit outside `assets` while the file "
-                "already has an `assets` table; move them under `assets.microgrids`."
-            )
-        return raw
-
-    _logger.warning(
-        "%s: top-level microgrid IDs are deprecated, "
-        "nest the entries under `assets.microgrids` instead.",
-        source,
-    )
-    return {"assets": {"microgrids": dict(raw)}}
-
-
-def _lift_microgrid_meta(raw: dict[str, Any], source: Path) -> dict[str, Any]:
-    """Merge a deprecated nested `meta` table onto its microgrid entry.
-
-    Earlier files nested a microgrid's fields under `meta`; they now sit
-    directly on the entry.
-
-    Args:
-        raw: The raw document.
-        source: The file it was parsed from.
-
-    Returns:
-        The document with microgrid fields directly on each entry.
-
-    Raises:
-        TypeError: If a `meta` value is not a table.
-        ValueError: If a field is set both under `meta` and on the entry.
-    """
-    assets = raw.get("assets")
-    if not isinstance(assets, dict):
-        return raw
-    microgrids = assets.get("microgrids")
-    if not isinstance(microgrids, dict):
-        return raw
-    for mid, entry in microgrids.items():
-        if not isinstance(entry, dict) or "meta" not in entry:
-            continue
-        meta = entry.pop("meta")
-        if not isinstance(meta, dict):
-            raise TypeError(f"{source}: microgrid {mid} `meta` must be a table")
-        _logger.warning(
-            "%s: microgrid %s nests fields under `meta`; that is deprecated, "
-            "set them directly on the entry instead.",
-            source,
-            mid,
-        )
-        for key, value in meta.items():
-            if key in entry:
-                raise ValueError(
-                    f"{source}: microgrid {mid} sets `{key}` both under `meta` "
-                    "and directly; keep only the direct one"
-                )
-            entry[key] = value
-    return raw
-
-
-_STEPS: list[tuple[int, Callable[[dict[str, Any], Path], dict[str, Any]]]] = [
-    (0, _nest_top_level_microgrids),
-    (0, _lift_microgrid_meta),
-]
-"""Migration steps as `(from_version, step)`, oldest first."""

frequenz_gridpool-0.7.1/src/frequenz_gridpool.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "0.7.1",
-  "distance": 0,
-  "node": "gb1e6ec5ad7f5fe27fd1db03ffd398de766bc012c",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-08-31"
-}