frequenz-gridpool 0.4.0__tar.gz → 0.4.2__tar.gz

{frequenz_gridpool-0.4.0/src/frequenz_gridpool.egg-info → frequenz_gridpool-0.4.2}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: frequenz-gridpool
-Version: 0.4.0
+Version: 0.4.2
 Summary: High-level interface to grid pools for the Frequenz platform.
 Author-email: Frequenz Energy-as-a-Service GmbH <floss@frequenz.com>
-License: MIT
+License-Expression: MIT
 Project-URL: Documentation, https://frequenz-floss.github.io/frequenz-gridpool-python/
 Project-URL: Changelog, https://github.com/frequenz-floss/frequenz-gridpool-python/releases
 Project-URL: Issues, https://github.com/frequenz-floss/frequenz-gridpool-python/issues
@@ -12,7 +12,6 @@ Project-URL: Support, https://github.com/frequenz-floss/frequenz-gridpool-python
 Keywords: frequenz,python,lib,library,gridpool
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Software Development :: Libraries
@@ -30,38 +29,39 @@ 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-docstrings==1.7.0; extra == "dev-flake8"
 Requires-Dist: flake8-pyproject==1.2.4; extra == "dev-flake8"
 Requires-Dist: pydoclint==0.8.3; extra == "dev-flake8"
 Requires-Dist: pydocstyle==6.3.0; extra == "dev-flake8"
 Provides-Extra: dev-formatting
-Requires-Dist: black==25.11.0; extra == "dev-formatting"
-Requires-Dist: isort==7.0.0; extra == "dev-formatting"
+Requires-Dist: black==26.3.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: black==25.11.0; extra == "dev-mkdocs"
-Requires-Dist: mike==2.1.3; extra == "dev-mkdocs"
-Requires-Dist: mkdocs-gen-files==0.5.0; extra == "dev-mkdocs"
-Requires-Dist: mkdocs-literate-nav==0.6.2; extra == "dev-mkdocs"
+Requires-Dist: black==26.3.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.3; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings[python]==1.0.3; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings-python==1.19.0; extra == "dev-mkdocs"
-Requires-Dist: frequenz-repo-config[lib]==0.13.7; 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: mkdocstrings-python==2.0.3; extra == "dev-mkdocs"
+Requires-Dist: frequenz-repo-config[lib]==0.17.0; extra == "dev-mkdocs"
 Provides-Extra: dev-mypy
-Requires-Dist: mypy==1.19.1; extra == "dev-mypy"
+Requires-Dist: mypy==1.20.2; extra == "dev-mypy"
 Requires-Dist: types-networkx>=3.6.1.20251220; extra == "dev-mypy"
-Requires-Dist: types-Markdown==3.10.2.20260211; extra == "dev-mypy"
+Requires-Dist: types-Markdown==3.10.2.20260408; extra == "dev-mypy"
 Requires-Dist: frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-mypy"
 Provides-Extra: dev-noxfile
-Requires-Dist: nox==2025.11.12; extra == "dev-noxfile"
-Requires-Dist: frequenz-repo-config[lib]==0.13.7; extra == "dev-noxfile"
+Requires-Dist: nox==2026.4.10; extra == "dev-noxfile"
+Requires-Dist: frequenz-repo-config[lib]==0.17.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.0.2; extra == "dev-pytest"
+Requires-Dist: pytest==9.0.3; extra == "dev-pytest"
 Requires-Dist: pylint==4.0.5; extra == "dev-pytest"
-Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.13.7; extra == "dev-pytest"
+Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.17.0; extra == "dev-pytest"
 Requires-Dist: pytest-mock==3.15.1; extra == "dev-pytest"
 Requires-Dist: pytest-asyncio==1.3.0; extra == "dev-pytest"
 Requires-Dist: async-solipsism==0.9; extra == "dev-pytest"

frequenz_gridpool-0.4.2/RELEASE_NOTES.md

@@ -0,0 +1,17 @@
+# Frequenz Gridpool Library Release Notes
+
+## Summary
+
+<!-- Here goes a general summary of what this release is about -->
+
+## Upgrading
+
+<!-- Here goes notes on how to upgrade from previous versions, including deprecations and what they should be replaced with -->
+
+## New Features
+
+- If there are unconnected breakers at a site, they are now hidden from the component graph.  If there are breakers with connections to other components, they are still sent to the component graph.  This is a temporary measure until the graph traversal supports breakers.
+
+## Bug Fixes
+
+- Fixed auto-formula population to only fill formulas for component types already present in a microgrid configuration. This prevents creating placeholder entries with `None` formulas for component types that are not configured.

{frequenz_gridpool-0.4.0 → frequenz_gridpool-0.4.2}/pyproject.toml

@@ -3,9 +3,9 @@
 
 [build-system]
 requires = [
-  "setuptools == 80.10.1",
-  "setuptools_scm[toml] == 9.2.2",
-  "frequenz-repo-config[lib] == 0.13.7",
+  "setuptools == 82.0.1",
+  "setuptools_scm[toml] == 10.0.5",
+  "frequenz-repo-config[lib] == 0.17.0",
 ]
 build-backend = "setuptools.build_meta"
 
@@ -13,12 +13,12 @@ build-backend = "setuptools.build_meta"
 name = "frequenz-gridpool"
 description = "High-level interface to grid pools for the Frequenz platform."
 readme = "README.md"
-license = { text = "MIT" }
+license = "MIT"
+license-files = ["LICENSE"]
 keywords = ["frequenz", "python", "lib", "library", "gridpool"]
 classifiers = [
   "Development Status :: 3 - Alpha",
   "Intended Audience :: Developers",
-  "License :: OSI Approved :: MIT License",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3 :: Only",
   "Topic :: Software Development :: Libraries",
@@ -49,34 +49,35 @@ render-graph = [
 
 dev-flake8 = [
   "flake8 == 7.3.0",
+  "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.8.3",
   "pydocstyle == 6.3.0",
 ]
-dev-formatting = ["black == 25.11.0", "isort == 7.0.0"]
+dev-formatting = ["black == 26.3.1", "isort == 8.0.1"]
 dev-mkdocs = [
   "Markdown == 3.10.2",
-  "black == 25.11.0",
-  "mike == 2.1.3",
-  "mkdocs-gen-files == 0.5.0",
-  "mkdocs-literate-nav == 0.6.2",
+  "black == 26.3.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.3",
-  "mkdocstrings[python] == 1.0.3",
-  "mkdocstrings-python == 1.19.0",
-  "frequenz-repo-config[lib] == 0.13.7",
+  "mkdocs-material == 9.7.6",
+  "mkdocstrings[python] == 1.0.4",
+  "mkdocstrings-python == 2.0.3",
+  "frequenz-repo-config[lib] == 0.17.0",
 ]
 dev-mypy = [
-  "mypy == 1.19.1",
+  "mypy == 1.20.2",
   "types-networkx>=3.6.1.20251220",
-  "types-Markdown == 3.10.2.20260211",
+  "types-Markdown == 3.10.2.20260408",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
 dev-noxfile = [
-  "nox == 2025.11.12",
-  "frequenz-repo-config[lib] == 0.13.7",
+  "nox == 2026.4.10",
+  "frequenz-repo-config[lib] == 0.17.0",
 ]
 dev-pylint = [
   # dev-pytest already defines a dependency to pylint because of the examples
@@ -84,9 +85,9 @@ dev-pylint = [
   "frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
 dev-pytest = [
-  "pytest == 9.0.2",
+  "pytest == 9.0.3",
   "pylint == 4.0.5",       # We need this to check for the examples
-  "frequenz-repo-config[extra-lint-examples] == 0.13.7",
+  "frequenz-repo-config[extra-lint-examples] == 0.17.0",
   "pytest-mock == 3.15.1",
   "pytest-asyncio == 1.3.0",
   "async-solipsism == 0.9",

{frequenz_gridpool-0.4.0 → frequenz_gridpool-0.4.2}/src/frequenz/gridpool/_graph_generator.py

@@ -3,8 +3,11 @@
 
 """Formula generation from assets API component/connection configurations."""
 
+import logging
+
 from frequenz.client.assets import AssetsApiClient
 from frequenz.client.assets.electrical_component import (
+    Breaker,
     ComponentConnection,
     ElectricalComponent,
 )
@@ -12,6 +15,8 @@ from frequenz.client.common.microgrid import MicrogridId
 from frequenz.client.common.microgrid.electrical_components import ElectricalComponentId
 from frequenz.microgrid_component_graph import ComponentGraph
 
+_logger = logging.getLogger(__name__)
+
 
 class ComponentGraphGenerator:
     """Generates component graphs for microgrids using the Assets API."""
@@ -57,6 +62,26 @@ class ComponentGraphGenerator:
         if any(c is None for c in connections):
             raise ValueError("Failed to load all electrical component connections.")
 
+        breakers = [c for c in components if isinstance(c, Breaker)]
+        connected_breakers = [
+            b
+            for b in breakers
+            if any(
+                b.id in (c.source, c.destination) for c in connections if c is not None
+            )
+        ]
+
+        if connected_breakers:
+            _logger.warning(
+                "The following breakers are connected to other components, "
+                + "which is not supported by the component graph generator and may "
+                + "lead to graph traversal issues: %s",
+                [b.id for b in connected_breakers],
+            )
+        elif breakers:
+            _logger.debug("Dropping unconnected breakers: %s", [b.id for b in breakers])
+            components = [c for c in components if not isinstance(c, Breaker)]
+
         graph = ComponentGraph[
             ElectricalComponent, ComponentConnection, ElectricalComponentId
         ](components, connections)

{frequenz_gridpool-0.4.0 → frequenz_gridpool-0.4.2}/src/frequenz/gridpool/_microgrid_config.py

@@ -51,19 +51,6 @@ class ComponentTypeConfig:
                 "please use 'AC_POWER_ACTIVE' instead."
             )
 
-        defaults = {
-            "AC_POWER_ACTIVE",
-            "AC_ENERGY_ACTIVE",
-            "AC_ENERGY_ACTIVE_CONSUMED",
-            "AC_ENERGY_ACTIVE_DELIVERED",
-        }
-
-        for metric in defaults:
-            if metric not in self.formula:
-                self.formula[metric] = "+".join(
-                    [f"#{cid}" for cid in self._default_cids()]
-                )
-
     def cids(self, metric: str = "") -> list[int]:
         """Get component IDs for this component.
 
@@ -454,10 +441,13 @@ class MicrogridConfig:
             assets_url, auth_key=assets_auth_key, sign_secret=assets_sign_secret
         ) as assets_client:
             for microgrid_id, config in microgrid_configs.items():
+                relevant_ctypes = set(config.ctype.keys())
+
                 await populate_missing_formulas(
                     microgrid_id=int(microgrid_id),
                     config=config,
                     assets_client=assets_client,
+                    component_types=relevant_ctypes,
                 )
 
         return microgrid_configs
@@ -467,6 +457,7 @@ async def populate_missing_formulas(
     microgrid_id: int,
     config: "MicrogridConfig",
     assets_client: AssetsApiClient,
+    component_types: set[str] | None = None,
 ) -> None:
     """Populate missing component formulas from the assets API graph.
 
@@ -484,6 +475,8 @@ async def populate_missing_formulas(
             Microgrid configuration object to update in place.
         assets_client:
             Assets API client used to fetch the component graph.
+        component_types:
+            Optional set of component types to consider when populating formulas.
 
     Returns:
         None. The configuration is modified in place.
@@ -515,12 +508,15 @@ async def populate_missing_formulas(
         "AC_ENERGY_ACTIVE_DELIVERED",
     )
 
+    # Default: only populate component types already present in the config.
+    allowed_ctypes = component_types or set(config.ctype.keys())
+
     for ctype, formula in auto_formulas.items():
+        if ctype not in allowed_ctypes:
+            continue
+
         cfg = config.ctype.get(ctype)
         if cfg is None:
-            config.ctype[ctype] = ComponentTypeConfig(
-                formula={metric: formula for metric in metrics}
-            )
             continue
 
         if cfg.formula is None:

{frequenz_gridpool-0.4.0 → frequenz_gridpool-0.4.2/src/frequenz_gridpool.egg-info}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: frequenz-gridpool
-Version: 0.4.0
+Version: 0.4.2
 Summary: High-level interface to grid pools for the Frequenz platform.
 Author-email: Frequenz Energy-as-a-Service GmbH <floss@frequenz.com>
-License: MIT
+License-Expression: MIT
 Project-URL: Documentation, https://frequenz-floss.github.io/frequenz-gridpool-python/
 Project-URL: Changelog, https://github.com/frequenz-floss/frequenz-gridpool-python/releases
 Project-URL: Issues, https://github.com/frequenz-floss/frequenz-gridpool-python/issues
@@ -12,7 +12,6 @@ Project-URL: Support, https://github.com/frequenz-floss/frequenz-gridpool-python
 Keywords: frequenz,python,lib,library,gridpool
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Software Development :: Libraries
@@ -30,38 +29,39 @@ 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-docstrings==1.7.0; extra == "dev-flake8"
 Requires-Dist: flake8-pyproject==1.2.4; extra == "dev-flake8"
 Requires-Dist: pydoclint==0.8.3; extra == "dev-flake8"
 Requires-Dist: pydocstyle==6.3.0; extra == "dev-flake8"
 Provides-Extra: dev-formatting
-Requires-Dist: black==25.11.0; extra == "dev-formatting"
-Requires-Dist: isort==7.0.0; extra == "dev-formatting"
+Requires-Dist: black==26.3.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: black==25.11.0; extra == "dev-mkdocs"
-Requires-Dist: mike==2.1.3; extra == "dev-mkdocs"
-Requires-Dist: mkdocs-gen-files==0.5.0; extra == "dev-mkdocs"
-Requires-Dist: mkdocs-literate-nav==0.6.2; extra == "dev-mkdocs"
+Requires-Dist: black==26.3.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.3; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings[python]==1.0.3; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings-python==1.19.0; extra == "dev-mkdocs"
-Requires-Dist: frequenz-repo-config[lib]==0.13.7; 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: mkdocstrings-python==2.0.3; extra == "dev-mkdocs"
+Requires-Dist: frequenz-repo-config[lib]==0.17.0; extra == "dev-mkdocs"
 Provides-Extra: dev-mypy
-Requires-Dist: mypy==1.19.1; extra == "dev-mypy"
+Requires-Dist: mypy==1.20.2; extra == "dev-mypy"
 Requires-Dist: types-networkx>=3.6.1.20251220; extra == "dev-mypy"
-Requires-Dist: types-Markdown==3.10.2.20260211; extra == "dev-mypy"
+Requires-Dist: types-Markdown==3.10.2.20260408; extra == "dev-mypy"
 Requires-Dist: frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-mypy"
 Provides-Extra: dev-noxfile
-Requires-Dist: nox==2025.11.12; extra == "dev-noxfile"
-Requires-Dist: frequenz-repo-config[lib]==0.13.7; extra == "dev-noxfile"
+Requires-Dist: nox==2026.4.10; extra == "dev-noxfile"
+Requires-Dist: frequenz-repo-config[lib]==0.17.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.0.2; extra == "dev-pytest"
+Requires-Dist: pytest==9.0.3; extra == "dev-pytest"
 Requires-Dist: pylint==4.0.5; extra == "dev-pytest"
-Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.13.7; extra == "dev-pytest"
+Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.17.0; extra == "dev-pytest"
 Requires-Dist: pytest-mock==3.15.1; extra == "dev-pytest"
 Requires-Dist: pytest-asyncio==1.3.0; extra == "dev-pytest"
 Requires-Dist: async-solipsism==0.9; extra == "dev-pytest"

{frequenz_gridpool-0.4.0 → frequenz_gridpool-0.4.2}/src/frequenz_gridpool.egg-info/requires.txt

@@ -9,44 +9,45 @@ frequenz-gridpool[dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-
 
 [dev-flake8]
 flake8==7.3.0
+flake8-datetimez==20.10.0
 flake8-docstrings==1.7.0
 flake8-pyproject==1.2.4
 pydoclint==0.8.3
 pydocstyle==6.3.0
 
 [dev-formatting]
-black==25.11.0
-isort==7.0.0
+black==26.3.1
+isort==8.0.1
 
 [dev-mkdocs]
 Markdown==3.10.2
-black==25.11.0
-mike==2.1.3
-mkdocs-gen-files==0.5.0
-mkdocs-literate-nav==0.6.2
+black==26.3.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.3
-mkdocstrings[python]==1.0.3
-mkdocstrings-python==1.19.0
-frequenz-repo-config[lib]==0.13.7
+mkdocs-material==9.7.6
+mkdocstrings[python]==1.0.4
+mkdocstrings-python==2.0.3
+frequenz-repo-config[lib]==0.17.0
 
 [dev-mypy]
-mypy==1.19.1
+mypy==1.20.2
 types-networkx>=3.6.1.20251220
-types-Markdown==3.10.2.20260211
+types-Markdown==3.10.2.20260408
 frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]
 
 [dev-noxfile]
-nox==2025.11.12
-frequenz-repo-config[lib]==0.13.7
+nox==2026.4.10
+frequenz-repo-config[lib]==0.17.0
 
 [dev-pylint]
 frequenz-gridpool[dev-mkdocs,dev-noxfile,dev-pytest]
 
 [dev-pytest]
-pytest==9.0.2
+pytest==9.0.3
 pylint==4.0.5
-frequenz-repo-config[extra-lint-examples]==0.13.7
+frequenz-repo-config[extra-lint-examples]==0.17.0
 pytest-mock==3.15.1
 pytest-asyncio==1.3.0
 async-solipsism==0.9

frequenz_gridpool-0.4.0/RELEASE_NOTES.md

@@ -1,20 +0,0 @@
-# Frequenz Gridpool Library Release Notes
-
-## Summary
-
-This release adds default formulas for AC energy metrics when they are not
-explicitly configured.
-
-## Upgrading
-
-* Update assets client to v0.3.0.
-
-## New Features
-
-* Added default summation formulas for `AC_ENERGY_ACTIVE`,
-  `AC_ENERGY_ACTIVE_CONSUMED`, and `AC_ENERGY_ACTIVE_DELIVERED` when formulas are
-  not provided. The defaults are built from the component IDs configured for the
-  component type.
-
-## Bug Fixes
-