frequenz-gridpool 0.6.2__tar.gz → 0.6.4__tar.gz

{frequenz_gridpool-0.6.2/src/frequenz_gridpool.egg-info → frequenz_gridpool-0.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frequenz-gridpool
-Version: 0.6.2
+Version: 0.6.4
 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
@@ -22,7 +22,7 @@ License-File: LICENSE
 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-client-assets<0.4,>=0.3.1
+Requires-Dist: frequenz-client-assets<0.6,>=0.5.0
 Provides-Extra: cli
 Requires-Dist: asyncclick<9,>=8.3.0.4; extra == "cli"
 Requires-Dist: tomlkit<1,>=0.13.0; extra == "cli"
@@ -35,7 +35,7 @@ Requires-Dist: flake8==7.3.0; extra == "dev-flake8"
 Requires-Dist: flake8-datetimez==20.10.0; 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.0; extra == "dev-flake8"
+Requires-Dist: pydoclint==0.9.1; extra == "dev-flake8"
 Requires-Dist: pydocstyle==6.3.0; extra == "dev-flake8"
 Provides-Extra: dev-formatting
 Requires-Dist: black==26.5.1; extra == "dev-formatting"
@@ -47,17 +47,17 @@ 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.6; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings[python]==1.0.4; 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"
 Provides-Extra: dev-mypy
-Requires-Dist: mypy==2.1.0; extra == "dev-mypy"
+Requires-Dist: mypy==2.3.0; extra == "dev-mypy"
 Requires-Dist: types-networkx>=3.6.1.20251220; extra == "dev-mypy"
-Requires-Dist: types-Markdown==3.10.2.20260518; 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.4.10; extra == "dev-noxfile"
+Requires-Dist: nox==2026.7.11; extra == "dev-noxfile"
 Requires-Dist: frequenz-repo-config[lib]==0.18.0; extra == "dev-noxfile"
 Provides-Extra: dev-pylint
 Requires-Dist: frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-pylint"

frequenz_gridpool-0.6.4/RELEASE_NOTES.md

@@ -0,0 +1,28 @@
+# Frequenz Gridpool Library Release Notes
+
+## Summary
+
+<!-- Here goes a general summary of what this release is about -->
+
+## Upgrading
+
+- Microgrid config files should nest their entries under `assets.microgrids`:
+
+  ```toml
+  assets.microgrids.23.meta.name = "..."
+  ```
+
+  Bare microgrid IDs at the top level still load but log a deprecation warning,
+  and support for them will be removed. The namespace keeps generated inventory
+  data apart from operator settings under `app.*`, so a config file can carry
+  both without its keys colliding.
+
+  A file mixing both layouts is rejected.
+
+## 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.6.2 → frequenz_gridpool-0.6.4}/pyproject.toml

@@ -3,8 +3,8 @@
 
 [build-system]
 requires = [
-  "setuptools == 82.0.1",
-  "setuptools_scm[toml] == 10.2.0",
+  "setuptools == 83.0.0",
+  "setuptools_scm[toml] == 10.2.1",
   "frequenz-repo-config[lib] == 0.18.0",
 ]
 build-backend = "setuptools.build_meta"
@@ -29,7 +29,7 @@ dependencies = [
   "marshmallow-dataclass >= 8.7.1, < 9",
   "typing-extensions >= 4.14.1, < 5",
   "frequenz-microgrid-component-graph >= 0.5.0, < 0.6",
-  "frequenz-client-assets >= 0.3.1, < 0.4",
+  "frequenz-client-assets >= 0.5.0, < 0.6",
 ]
 dynamic = ["version"]
 
@@ -56,7 +56,7 @@ dev-flake8 = [
   "flake8-datetimez == 20.10.0",
   "flake8-docstrings == 1.7.0",
   "flake8-pyproject == 1.2.4",  # For reading the flake8 config from pyproject.toml
-  "pydoclint == 0.9.0",
+  "pydoclint == 0.9.1",
   "pydocstyle == 6.3.0",
 ]
 dev-formatting = ["black == 26.5.1", "isort == 8.0.1"]
@@ -67,20 +67,20 @@ dev-mkdocs = [
   "mkdocs-gen-files == 0.6.1",
   "mkdocs-literate-nav == 0.6.3",
   "mkdocs-macros-plugin == 1.5.0",
-  "mkdocs-material == 9.7.6",
-  "mkdocstrings[python] == 1.0.4",
+  "mkdocs-material == 9.7.7",
+  "mkdocstrings[python] == 1.0.6",
   "mkdocstrings-python == 2.0.5",
   "frequenz-repo-config[lib] == 0.18.0",
 ]
 dev-mypy = [
-  "mypy == 2.1.0",
+  "mypy == 2.3.0",
   "types-networkx>=3.6.1.20251220",
-  "types-Markdown == 3.10.2.20260518",
+  "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.4.10",
+  "nox == 2026.7.11",
   "frequenz-repo-config[lib] == 0.18.0",
 ]
 dev-pylint = [

{frequenz_gridpool-0.6.2 → frequenz_gridpool-0.6.4}/src/frequenz/gridpool/config/microgrid.py

@@ -301,18 +301,18 @@ class MicrogridConfig:
         """Load microgrid configurations from table entries.
 
         Args:
-            data: The loaded TOML data.
+            data: The table mapping microgrid IDs to their entries.
 
         Returns:
             A dict mapping microgrid IDs to MicrogridConfig instances.
 
         Raises:
-            ValueError: If top-level keys are not numeric microgrid IDs
+            ValueError: If the keys are not numeric microgrid IDs
                 or if there is a microgrid ID mismatch.
             TypeError: If microgrid data is not a dict.
         """
         if not all(str(k).isdigit() for k in data.keys()):
-            raise ValueError("All top-level keys must be numeric microgrid IDs.")
+            raise ValueError("All microgrid keys must be numeric microgrid IDs.")
 
         mgrids = {}
         for mid, entry in data.items():
@@ -337,6 +337,51 @@ class MicrogridConfig:
 
         return mgrids
 
+    @classmethod
+    def _microgrid_table(cls, data: dict[str, Any], source: str) -> dict[str, Any]:
+        """Pick the microgrid entries out of a parsed config document.
+
+        Entries live under `assets.microgrids`. A document without an `assets`
+        table is read in the deprecated layout, where the entries sit at the
+        top level.
+
+        Args:
+            data: The parsed TOML document.
+            source: Name of the document, used in messages.
+
+        Returns:
+            The table mapping microgrid IDs to their entries.
+
+        Raises:
+            TypeError: If `assets` is not a table.
+            ValueError: If both layouts are present, which means a
+                half-migrated file rather than a merge.
+        """
+        if "assets" not in data:
+            _logger.warning(
+                "%s: top-level microgrid IDs are deprecated, "
+                "nest the entries under `assets.microgrids` instead.",
+                source,
+            )
+            return data
+
+        assets = data["assets"]
+        if not isinstance(assets, dict):
+            raise TypeError(f"{source}: `assets` must be a table, got {type(assets)}")
+
+        if unprefixed := sorted(k for k in data if k != "assets"):
+            raise ValueError(
+                f"{source}: keys {unprefixed} sit outside `assets` while the file "
+                "already has an `assets` table; move them under `assets.microgrids`."
+            )
+
+        microgrids = assets.get("microgrids", {})
+        if not isinstance(microgrids, dict):
+            raise TypeError(
+                f"{source}: `assets.microgrids` must be a table, got {type(microgrids)}"
+            )
+        return microgrids
+
     @classmethod
     def load_from_file(cls, config_path: Path) -> dict[str, Self]:
         """
@@ -353,7 +398,7 @@ class MicrogridConfig:
 
         assert isinstance(data, dict)
 
-        return cls._load_table_entries(data)
+        return cls._load_table_entries(cls._microgrid_table(data, str(config_path)))
 
 
 def merge_microgrid_configs(

{frequenz_gridpool-0.6.2 → frequenz_gridpool-0.6.4/src/frequenz_gridpool.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frequenz-gridpool
-Version: 0.6.2
+Version: 0.6.4
 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
@@ -22,7 +22,7 @@ License-File: LICENSE
 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-client-assets<0.4,>=0.3.1
+Requires-Dist: frequenz-client-assets<0.6,>=0.5.0
 Provides-Extra: cli
 Requires-Dist: asyncclick<9,>=8.3.0.4; extra == "cli"
 Requires-Dist: tomlkit<1,>=0.13.0; extra == "cli"
@@ -35,7 +35,7 @@ Requires-Dist: flake8==7.3.0; extra == "dev-flake8"
 Requires-Dist: flake8-datetimez==20.10.0; 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.0; extra == "dev-flake8"
+Requires-Dist: pydoclint==0.9.1; extra == "dev-flake8"
 Requires-Dist: pydocstyle==6.3.0; extra == "dev-flake8"
 Provides-Extra: dev-formatting
 Requires-Dist: black==26.5.1; extra == "dev-formatting"
@@ -47,17 +47,17 @@ 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.6; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings[python]==1.0.4; 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"
 Provides-Extra: dev-mypy
-Requires-Dist: mypy==2.1.0; extra == "dev-mypy"
+Requires-Dist: mypy==2.3.0; extra == "dev-mypy"
 Requires-Dist: types-networkx>=3.6.1.20251220; extra == "dev-mypy"
-Requires-Dist: types-Markdown==3.10.2.20260518; 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.4.10; extra == "dev-noxfile"
+Requires-Dist: nox==2026.7.11; extra == "dev-noxfile"
 Requires-Dist: frequenz-repo-config[lib]==0.18.0; extra == "dev-noxfile"
 Provides-Extra: dev-pylint
 Requires-Dist: frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-pylint"

{frequenz_gridpool-0.6.2 → frequenz_gridpool-0.6.4}/src/frequenz_gridpool.egg-info/requires.txt

@@ -1,7 +1,7 @@
 marshmallow-dataclass<9,>=8.7.1
 typing-extensions<5,>=4.14.1
 frequenz-microgrid-component-graph<0.6,>=0.5.0
-frequenz-client-assets<0.4,>=0.3.1
+frequenz-client-assets<0.6,>=0.5.0
 
 [cli]
 asyncclick<9,>=8.3.0.4
@@ -15,7 +15,7 @@ flake8==7.3.0
 flake8-datetimez==20.10.0
 flake8-docstrings==1.7.0
 flake8-pyproject==1.2.4
-pydoclint==0.9.0
+pydoclint==0.9.1
 pydocstyle==6.3.0
 
 [dev-formatting]
@@ -29,19 +29,19 @@ 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.6
-mkdocstrings[python]==1.0.4
+mkdocs-material==9.7.7
+mkdocstrings[python]==1.0.6
 mkdocstrings-python==2.0.5
 frequenz-repo-config[lib]==0.18.0
 
 [dev-mypy]
-mypy==2.1.0
+mypy==2.3.0
 types-networkx>=3.6.1.20251220
-types-Markdown==3.10.2.20260518
+types-Markdown==3.10.2.20260712
 frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]
 
 [dev-noxfile]
-nox==2026.4.10
+nox==2026.7.11
 frequenz-repo-config[lib]==0.18.0
 
 [dev-pylint]

{frequenz_gridpool-0.6.2 → frequenz_gridpool-0.6.4}/src/frequenz_gridpool.egg-info/scm_file_list.json

@@ -1,60 +1,60 @@
 {
   "files": [
+    ".cookiecutter-replay.json",
+    ".editorconfig",
+    ".github/ISSUE_TEMPLATE/bug.yml",
+    ".github/ISSUE_TEMPLATE/config.yml",
+    ".github/ISSUE_TEMPLATE/feature.yml",
+    ".github/RELEASE_NOTES.template.md",
+    ".github/dependabot.yml",
+    ".github/keylabeler.yml",
+    ".github/labeler.yml",
+    ".github/workflows/auto-dependabot.yaml",
+    ".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",
+    ".github/workflows/repo-config-migration.yaml",
     ".gitignore",
-    "README.md",
+    "CODEOWNERS",
     "CONTRIBUTING.md",
-    ".editorconfig",
-    ".cookiecutter-replay.json",
-    "pyproject.toml",
+    "LICENSE",
     "MANIFEST.in",
+    "README.md",
     "RELEASE_NOTES.md",
-    "LICENSE",
+    "docs/CONTRIBUTING.md",
+    "docs/SUMMARY.md",
+    "docs/_css/mkdocstrings.css",
+    "docs/_css/style.css",
+    "docs/_img/logo.png",
+    "docs/_overrides/main.html",
+    "docs/_scripts/mkdocstrings_autoapi.py",
+    "docs/index.md",
     "mkdocs.yml",
-    "CODEOWNERS",
     "noxfile.py",
-    "src/frequenz/gridpool/conftest.py",
-    "src/frequenz/gridpool/_graph_generator.py",
-    "src/frequenz/gridpool/py.typed",
+    "pyproject.toml",
     "src/frequenz/gridpool/__init__.py",
-    "src/frequenz/gridpool/config/microgrid.py",
-    "src/frequenz/gridpool/config/load.py",
-    "src/frequenz/gridpool/config/__init__.py",
-    "src/frequenz/gridpool/cli/_dump_config.py",
+    "src/frequenz/gridpool/_graph_generator.py",
+    "src/frequenz/gridpool/cli/__init__.py",
     "src/frequenz/gridpool/cli/__main__.py",
+    "src/frequenz/gridpool/cli/_dump_config.py",
     "src/frequenz/gridpool/cli/_patch_config.py",
     "src/frequenz/gridpool/cli/_render_graph.py",
-    "src/frequenz/gridpool/cli/__init__.py",
-    ".github/labeler.yml",
-    ".github/dependabot.yml",
-    ".github/keylabeler.yml",
-    ".github/RELEASE_NOTES.template.md",
-    ".github/workflows/isort-migration.yaml",
-    ".github/workflows/labeler.yml",
-    ".github/workflows/repo-config-migration.yaml",
-    ".github/workflows/ci-pr.yaml",
-    ".github/workflows/ci.yaml",
-    ".github/workflows/black-migration.yaml",
-    ".github/workflows/dco-merge-queue.yml",
-    ".github/workflows/release-notes-check.yml",
-    ".github/workflows/auto-dependabot.yaml",
-    ".github/ISSUE_TEMPLATE/config.yml",
-    ".github/ISSUE_TEMPLATE/feature.yml",
-    ".github/ISSUE_TEMPLATE/bug.yml",
-    "tests/test_merge_config.py",
-    "tests/test_load.py",
+    "src/frequenz/gridpool/config/__init__.py",
+    "src/frequenz/gridpool/config/load.py",
+    "src/frequenz/gridpool/config/microgrid.py",
+    "src/frequenz/gridpool/conftest.py",
+    "src/frequenz/gridpool/py.typed",
+    "tests/test_cli.py",
+    "tests/test_config.py",
     "tests/test_dump_config.py",
-    "tests/test_patch_config.py",
     "tests/test_graph_generator.py",
-    "tests/test_render_graph.py",
-    "tests/test_config.py",
-    "tests/test_cli.py",
-    "docs/SUMMARY.md",
-    "docs/CONTRIBUTING.md",
-    "docs/index.md",
-    "docs/_img/logo.png",
-    "docs/_css/mkdocstrings.css",
-    "docs/_css/style.css",
-    "docs/_scripts/mkdocstrings_autoapi.py",
-    "docs/_overrides/main.html"
+    "tests/test_load.py",
+    "tests/test_merge_config.py",
+    "tests/test_patch_config.py",
+    "tests/test_render_graph.py"
   ]
 }

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

@@ -0,0 +1,8 @@
+{
+  "tag": "0.6.4",
+  "distance": 0,
+  "node": "g0b2bd42b6dee08d4d96a5ebf4c3626d8c277d769",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-08-18"
+}

frequenz_gridpool-0.6.2/RELEASE_NOTES.md

@@ -1,20 +0,0 @@
-# Frequenz Gridpool Library Release Notes
-
-## Summary
-
-This release updates the microgrid component graph library to v0.5.0 and adds a way to configure how the component graph is built.
-
-## Upgrading
-
-* The per-category formulas (`pv`, `battery`, `chp`, `ev`) now read the component first and use the meter as the fallback. This is the opposite of the old order, and it changes the generated config. Regenerate stored configs with this release and review the diff.
-* To keep the old order, pass `ComponentGraphConfig(prefer_meters_in_component_formulas=True)` to `load_configs`, `load_configs_from_api` or `ComponentGraphGenerator`, or use the new `--prefer-meters-in-component-formulas` flag of the CLI.
-* The update brings more changes, for example to the `consumption` formula and to the graph validation error messages. See the [v0.5.0 release notes](https://github.com/frequenz-floss/frequenz-microgrid-component-graph-python/releases/tag/v0.5.0) of the component graph library for the full list.
-
-## New Features
-
-* `load_configs` and `load_configs_from_api` take a `component_graph_config` argument, and `ComponentGraphGenerator` takes it as `config`. It controls how the component graph is built and how its formulas are generated. `ComponentGraphConfig` and `FormulaOverrides` are re-exported from `frequenz.gridpool` and `frequenz.gridpool.config`.
-* The `generate-config` and `print-formulas` CLI commands take a `--prefer-meters-in-component-formulas` flag, which reads the meter before the component in the per-category formulas.
-
-## Bug Fixes
-
-<!-- Here goes notable bug fixes that are worth a special mention or explanation -->

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

@@ -1,8 +0,0 @@
-{
-  "tag": "0.6.2",
-  "distance": 0,
-  "node": "g0a1ee9abfb5df460d8bdb8d71728a093d89217f1",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-07-20"
-}