frequenz-client-assets 0.2.0__tar.gz → 0.3.1__tar.gz

{frequenz_client_assets-0.2.0 → frequenz_client_assets-0.3.1}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: frequenz-client-assets
-Version: 0.2.0
+Version: 0.3.1
 Summary: Assets API client for Python
 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-client-assets-python/
 Project-URL: Changelog, https://github.com/frequenz-floss/frequenz-client-assets-python/releases
 Project-URL: Issues, https://github.com/frequenz-floss/frequenz-client-assets-python/issues
@@ -12,7 +12,6 @@ Project-URL: Support, https://github.com/frequenz-floss/frequenz-client-assets-p
 Keywords: frequenz,python,lib,library,frequenz-client-assets,client-assets,client,assets,api
 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
@@ -22,50 +21,51 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: typing-extensions<5,>=4.13.0
 Requires-Dist: frequenz-api-assets<0.2.0,>=0.1.0
-Requires-Dist: frequenz-api-common<1,>=0.8.0
+Requires-Dist: frequenz-api-common<1,>=0.8.2
 Requires-Dist: frequenz-client-base<0.12.0,>=0.11.0
 Requires-Dist: frequenz-client-common<0.4.0,>=0.3.6
 Requires-Dist: grpcio<2,>=1.73.1
 Provides-Extra: cli
-Requires-Dist: asyncclick==8.3.0.4; extra == "cli"
+Requires-Dist: asyncclick==8.3.0.7; extra == "cli"
 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.3; extra == "dev-flake8"
-Requires-Dist: pydoclint==0.7.6; 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.9.0; extra == "dev-formatting"
-Requires-Dist: isort==6.1.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.9; extra == "dev-mkdocs"
-Requires-Dist: black==25.9.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: mkdocs-macros-plugin==1.4.1; extra == "dev-mkdocs"
-Requires-Dist: mkdocs-material==9.6.23; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings[python]==0.30.1; extra == "dev-mkdocs"
-Requires-Dist: mkdocstrings-python==1.18.2; extra == "dev-mkdocs"
-Requires-Dist: frequenz-repo-config[lib]==0.13.6; extra == "dev-mkdocs"
+Requires-Dist: Markdown==3.10.2; extra == "dev-mkdocs"
+Requires-Dist: black==26.3.1; extra == "dev-mkdocs"
+Requires-Dist: mike==2.1.4; 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: mkdocstrings-python==2.0.3; extra == "dev-mkdocs"
+Requires-Dist: frequenz-repo-config[lib]==0.16.0; extra == "dev-mkdocs"
 Provides-Extra: dev-mypy
-Requires-Dist: mypy==1.18.2; extra == "dev-mypy"
+Requires-Dist: mypy==1.20.2; extra == "dev-mypy"
 Requires-Dist: grpc-stubs==1.53.0.6; extra == "dev-mypy"
-Requires-Dist: types-Markdown==3.9.0.20250906; extra == "dev-mypy"
-Requires-Dist: types-protobuf==6.32.1.20250918; extra == "dev-mypy"
+Requires-Dist: types-Markdown==3.10.2.20260211; extra == "dev-mypy"
+Requires-Dist: types-protobuf==6.32.1.20260221; extra == "dev-mypy"
 Requires-Dist: frequenz-client-assets[cli,dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-mypy"
 Provides-Extra: dev-noxfile
-Requires-Dist: nox==2025.5.1; extra == "dev-noxfile"
-Requires-Dist: frequenz-repo-config[lib]==0.13.6; extra == "dev-noxfile"
+Requires-Dist: nox==2026.2.9; extra == "dev-noxfile"
+Requires-Dist: frequenz-repo-config[lib]==0.16.0; extra == "dev-noxfile"
 Provides-Extra: dev-pylint
 Requires-Dist: frequenz-client-assets[cli,dev-mkdocs,dev-noxfile,dev-pytest]; extra == "dev-pylint"
 Provides-Extra: dev-pytest
-Requires-Dist: pytest==8.4.2; extra == "dev-pytest"
-Requires-Dist: pylint==3.3.8; extra == "dev-pytest"
-Requires-Dist: frequenz-repo-config[extra-lint-examples]==0.13.6; 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.16.0; extra == "dev-pytest"
 Requires-Dist: pytest-mock==3.15.1; extra == "dev-pytest"
-Requires-Dist: pytest-asyncio==1.2.0; extra == "dev-pytest"
-Requires-Dist: async-solipsism==0.8; extra == "dev-pytest"
+Requires-Dist: pytest-asyncio==1.3.0; extra == "dev-pytest"
+Requires-Dist: async-solipsism==0.9; extra == "dev-pytest"
 Provides-Extra: dev
 Requires-Dist: frequenz-client-assets[dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-pylint,dev-pytest]; extra == "dev"
 Dynamic: license-file

frequenz_client_assets-0.3.1/RELEASE_NOTES.md

@@ -0,0 +1,5 @@
+# Frequenz Assets API Client Release Notes
+
+## New Features
+
+Added steam boiler component category.

{frequenz_client_assets-0.2.0 → frequenz_client_assets-0.3.1}/pyproject.toml

@@ -3,9 +3,9 @@
 
 [build-system]
 requires = [
-  "setuptools == 80.9.0",
-  "setuptools_scm[toml] == 9.2.2",
-  "frequenz-repo-config[lib] == 0.13.6",
+  "setuptools == 82.0.1",
+  "setuptools_scm[toml] == 10.0.5",
+  "frequenz-repo-config[lib] == 0.16.0",
 ]
 build-backend = "setuptools.build_meta"
 
@@ -13,7 +13,8 @@ build-backend = "setuptools.build_meta"
 name = "frequenz-client-assets"
 description = "Assets API client for Python"
 readme = "README.md"
-license = { text = "MIT" }
+license = "MIT"
+license-files = ["LICENSE"]
 keywords = [
   "frequenz",
   "python",
@@ -28,7 +29,6 @@ keywords = [
 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",
@@ -38,7 +38,7 @@ requires-python = ">= 3.11, < 4"
 dependencies = [
   "typing-extensions >= 4.13.0, < 5",
   "frequenz-api-assets >= 0.1.0, < 0.2.0",
-  "frequenz-api-common >= 0.8.0, < 1",
+  "frequenz-api-common >= 0.8.2, < 1",
   "frequenz-client-base >= 0.11.0, < 0.12.0",
   "frequenz-client-common >= 0.3.6, < 0.4.0",
   "grpcio >= 1.73.1, < 2",
@@ -53,48 +53,49 @@ name = "Frequenz Energy-as-a-Service GmbH"
 email = "floss@frequenz.com"
 
 [project.optional-dependencies]
-cli = ["asyncclick == 8.3.0.4"]
+cli = ["asyncclick == 8.3.0.7"]
 dev-flake8 = [
   "flake8 == 7.3.0",
+  "flake8-datetimez == 20.10.0",
   "flake8-docstrings == 1.7.0",
-  "flake8-pyproject == 1.2.3", # For reading the flake8 config from pyproject.toml
-  "pydoclint == 0.7.6",
+  "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.9.0", "isort == 6.1.0"]
+dev-formatting = ["black == 26.3.1", "isort == 8.0.1"]
 dev-mkdocs = [
-  "Markdown == 3.9",
-  "black == 25.9.0",
-  "mike == 2.1.3",
-  "mkdocs-gen-files == 0.5.0",
-  "mkdocs-literate-nav == 0.6.2",
-  "mkdocs-macros-plugin == 1.4.1",
-  "mkdocs-material == 9.6.23",
-  "mkdocstrings[python] == 0.30.1",
-  "mkdocstrings-python == 1.18.2",
-  "frequenz-repo-config[lib] == 0.13.6",
+  "Markdown == 3.10.2",
+  "black == 26.3.1",
+  "mike == 2.1.4",
+  "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",
+  "mkdocstrings-python == 2.0.3",
+  "frequenz-repo-config[lib] == 0.16.0",
 ]
 dev-mypy = [
-  "mypy == 1.18.2",
+  "mypy == 1.20.2",
   "grpc-stubs == 1.53.0.6",
-  "types-Markdown == 3.9.0.20250906",
-  "types-protobuf == 6.32.1.20250918",
+  "types-Markdown == 3.10.2.20260211",
+  "types-protobuf == 6.32.1.20260221",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-client-assets[dev-mkdocs,dev-noxfile,dev-pytest,cli]",
 ]
-dev-noxfile = ["nox == 2025.5.1", "frequenz-repo-config[lib] == 0.13.6"]
+dev-noxfile = ["nox == 2026.2.9", "frequenz-repo-config[lib] == 0.16.0"]
 dev-pylint = [
   # dev-pytest already defines a dependency to pylint because of the examples
   # For checking the noxfile, docs/ script, and tests
   "frequenz-client-assets[dev-mkdocs,dev-noxfile,dev-pytest,cli]",
 ]
 dev-pytest = [
-  "pytest == 8.4.2",
-  "pylint == 3.3.8", # We need this to check for the examples
-  "frequenz-repo-config[extra-lint-examples] == 0.13.6",
+  "pytest == 9.0.3",
+  "pylint == 4.0.5", # We need this to check for the examples
+  "frequenz-repo-config[extra-lint-examples] == 0.16.0",
   "pytest-mock == 3.15.1",
-  "pytest-asyncio == 1.2.0",
-  "async-solipsism == 0.8",
+  "pytest-asyncio == 1.3.0",
+  "async-solipsism == 0.9",
 ]
 dev = [
   "frequenz-client-assets[dev-mkdocs,dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-pylint,dev-pytest]",

{frequenz_client_assets-0.2.0 → frequenz_client_assets-0.3.1}/src/frequenz/client/assets/_client.py

@@ -18,12 +18,23 @@ from frequenz.client.common.microgrid import MicrogridId
 from frequenz.client.common.microgrid.electrical_components import ElectricalComponentId
 
 from ._microgrid import Microgrid
-from ._microgrid_proto import microgrid_from_proto
+from ._microgrid_proto import microgrid_from_proto, microgrid_from_proto_with_issues
 from .electrical_component._connection import ComponentConnection
-from .electrical_component._connection_proto import component_connection_from_proto
+from .electrical_component._connection_proto import (
+    component_connection_from_proto,
+    component_connection_from_proto_with_issues,
+)
 from .electrical_component._electrical_component import ElectricalComponent
-from .electrical_component._electrical_component_proto import electrical_component_proto
-from .exceptions import ClientNotConnected
+from .electrical_component._electrical_component_proto import (
+    electrical_component_from_proto_with_issues,
+    electrical_component_proto,
+)
+from .exceptions import (
+    ClientNotConnected,
+    InvalidConnectionError,
+    InvalidElectricalComponentError,
+    InvalidMicrogridError,
+)
 
 DEFAULT_GRPC_CALL_TIMEOUT = 60.0
 """The default timeout for gRPC calls made by this client (in seconds)."""
@@ -88,14 +99,21 @@ class AssetsApiClient(
         # use the async stub, so we cast the sync stub to the async stub.
         return self._stub  # type: ignore
 
-    async def get_microgrid(  # noqa: DOC502 (raises ApiClientError indirectly)
-        self, microgrid_id: MicrogridId
+    async def get_microgrid(  # noqa: DOC502,DOC503 (raises indirectly)
+        self,
+        microgrid_id: MicrogridId,
+        *,
+        raise_on_errors: bool = False,
     ) -> Microgrid:
         """
         Get the details of a microgrid.
 
         Args:
             microgrid_id: The ID of the microgrid to get the details of.
+            raise_on_errors: If True, raise an
+                [InvalidMicrogridError][frequenz.client.assets.exceptions.InvalidMicrogridError]
+                when major validation issues are found instead of just
+                logging them.
 
         Returns:
             The details of the microgrid.
@@ -103,6 +121,8 @@ class AssetsApiClient(
         Raises:
             ApiClientError: If there are any errors communicating with the Assets API,
                 most likely a subclass of [GrpcError][frequenz.client.base.exception.GrpcError].
+            InvalidMicrogridError: If `raise_on_errors` is True and major
+                validation issues are found.
         """
         response = await call_stub_method(
             self,
@@ -113,19 +133,48 @@ class AssetsApiClient(
             method_name="GetMicrogrid",
         )
 
+        if raise_on_errors:
+            major_issues: list[str] = []
+            minor_issues: list[str] = []
+            microgrid = microgrid_from_proto_with_issues(
+                response.microgrid,
+                major_issues=major_issues,
+                minor_issues=minor_issues,
+            )
+            if major_issues:
+                raise InvalidMicrogridError(
+                    microgrid=microgrid,
+                    major_issues=major_issues,
+                    minor_issues=minor_issues,
+                    raw_message=response.microgrid,
+                )
+            return microgrid
+
         return microgrid_from_proto(response.microgrid)
 
     async def list_microgrid_electrical_components(
-        self, microgrid_id: MicrogridId
+        self,
+        microgrid_id: MicrogridId,
+        *,
+        raise_on_errors: bool = False,
     ) -> list[ElectricalComponent]:
         """
         Get the electrical components of a microgrid.
 
         Args:
             microgrid_id: The ID of the microgrid to get the electrical components of.
+            raise_on_errors: If True, raise an
+                `ExceptionGroup[InvalidElectricalComponentError]`
+                when major validation issues are found in any component instead
+                of just logging them.
 
         Returns:
             The electrical components of the microgrid.
+
+        Raises:
+            ExceptionGroup: If `raise_on_errors` is True and major validation
+                issues are found. All exceptions in the group are
+                [InvalidElectricalComponentError][frequenz.client.assets.exceptions.InvalidElectricalComponentError].
         """
         response = await call_stub_method(
             self,
@@ -138,6 +187,35 @@ class AssetsApiClient(
             method_name="ListMicrogridElectricalComponents",
         )
 
+        if raise_on_errors:
+            components: list[ElectricalComponent] = []
+            exceptions: list[InvalidElectricalComponentError] = []
+            for component_pb in response.components:
+                major_issues: list[str] = []
+                minor_issues: list[str] = []
+                component = electrical_component_from_proto_with_issues(
+                    component_pb,
+                    major_issues=major_issues,
+                    minor_issues=minor_issues,
+                )
+                if major_issues:
+                    exceptions.append(
+                        InvalidElectricalComponentError(
+                            component=component,
+                            major_issues=major_issues,
+                            minor_issues=minor_issues,
+                            raw_message=component_pb,
+                        )
+                    )
+                else:
+                    components.append(component)
+            if exceptions:
+                raise ExceptionGroup(
+                    f"{len(exceptions)} electrical component(s) failed validation",
+                    exceptions,
+                )
+            return components
+
         return [
             electrical_component_proto(component) for component in response.components
         ]
@@ -147,7 +225,9 @@ class AssetsApiClient(
         microgrid_id: MicrogridId,
         source_component_ids: Iterable[ElectricalComponentId] = (),
         destination_component_ids: Iterable[ElectricalComponentId] = (),
-    ) -> list[ComponentConnection | None]:
+        *,
+        raise_on_errors: bool = False,
+    ) -> list[ComponentConnection]:
         """
         Get the electrical component connections of a microgrid.
 
@@ -158,9 +238,18 @@ class AssetsApiClient(
                 these component IDs. If None or empty, no filtering is applied.
             destination_component_ids: Only return connections that terminate at
                 these component IDs. If None or empty, no filtering is applied.
+            raise_on_errors: If True, raise an
+                `ExceptionGroup[InvalidConnectionError]`
+                when major validation issues are found in any connection instead
+                of just logging them.
 
         Returns:
             The electrical component connections of the microgrid.
+
+        Raises:
+            ExceptionGroup: If `raise_on_errors` is True and major validation
+                issues are found. All exceptions in the group are
+                [InvalidConnectionError][frequenz.client.assets.exceptions.InvalidConnectionError].
         """
         request = assets_pb2.ListMicrogridElectricalComponentConnectionsRequest(
             microgrid_id=int(microgrid_id),
@@ -177,9 +266,34 @@ class AssetsApiClient(
             method_name="ListMicrogridElectricalComponentConnections",
         )
 
-        return list(
-            map(
-                component_connection_from_proto,
-                filter(bool, response.connections),
-            )
-        )
+        if raise_on_errors:
+            valid_connections: list[ComponentConnection] = []
+            exceptions: list[InvalidConnectionError] = []
+            for conn_pb in filter(bool, response.connections):
+                major_issues: list[str] = []
+                connection = component_connection_from_proto_with_issues(
+                    conn_pb, major_issues=major_issues
+                )
+                if major_issues:
+                    exceptions.append(
+                        InvalidConnectionError(
+                            connection=connection,
+                            major_issues=major_issues,
+                            minor_issues=[],
+                            raw_message=conn_pb,
+                        )
+                    )
+                elif connection is not None:
+                    valid_connections.append(connection)
+            if exceptions:
+                raise ExceptionGroup(
+                    f"{len(exceptions)} connection(s) failed validation",
+                    exceptions,
+                )
+            return valid_connections
+
+        return [
+            c
+            for c in map(component_connection_from_proto, response.connections)
+            if c is not None
+        ]

{frequenz_client_assets-0.2.0 → frequenz_client_assets-0.3.1}/src/frequenz/client/assets/_lifetime.py

@@ -3,7 +3,6 @@
 
 """Lifetime of a microgrid asset."""
 
-
 from dataclasses import dataclass
 from datetime import datetime, timezone
 

{frequenz_client_assets-0.2.0 → frequenz_client_assets-0.3.1}/src/frequenz/client/assets/_location.py

@@ -3,7 +3,6 @@
 
 """Location information for a microgrid."""
 
-
 from dataclasses import dataclass
 
 

{frequenz_client_assets-0.2.0 → frequenz_client_assets-0.3.1}/src/frequenz/client/assets/_microgrid_proto.py

@@ -3,7 +3,6 @@
 
 """Loading of MicrogridInfo objects from protobuf messages."""
 
-
 import logging
 
 from frequenz.api.common.v1alpha8.microgrid import microgrid_pb2
@@ -32,6 +31,46 @@ def microgrid_from_proto(message: microgrid_pb2.Microgrid) -> Microgrid:
     major_issues: list[str] = []
     minor_issues: list[str] = []
 
+    microgrid = microgrid_from_proto_with_issues(
+        message, major_issues=major_issues, minor_issues=minor_issues
+    )
+
+    if major_issues:
+        _logger.warning(
+            "Found issues in microgrid: %s | Protobuf message:\n%s",
+            ", ".join(major_issues),
+            message,
+        )
+
+    if minor_issues:
+        _logger.debug(
+            "Found minor issues in microgrid: %s | Protobuf message:\n%s",
+            ", ".join(minor_issues),
+            message,
+        )
+
+    return microgrid
+
+
+def microgrid_from_proto_with_issues(
+    message: microgrid_pb2.Microgrid,
+    *,
+    major_issues: list[str],
+    minor_issues: list[str],
+) -> Microgrid:
+    """Convert a protobuf microgrid message to a microgrid object, collecting issues.
+
+    This function is useful when you want to collect issues during parsing
+    rather than logging them immediately.
+
+    Args:
+        message: The protobuf message to convert.
+        major_issues: A list to collect major issues found during validation.
+        minor_issues: A list to collect minor issues found during validation.
+
+    Returns:
+        The resulting microgrid object.
+    """
     delivery_area: DeliveryArea | None = None
     if message.HasField("delivery_area"):
         delivery_area = delivery_area_from_proto(message.delivery_area)
@@ -54,20 +93,6 @@ def microgrid_from_proto(message: microgrid_pb2.Microgrid) -> Microgrid:
     elif isinstance(status, int):
         major_issues.append("status is unrecognized")
 
-    if major_issues:
-        _logger.warning(
-            "Found issues in microgrid: %s | Protobuf message:\n%s",
-            ", ".join(major_issues),
-            message,
-        )
-
-    if minor_issues:
-        _logger.debug(
-            "Found minor issues in microgrid: %s | Protobuf message:\n%s",
-            ", ".join(minor_issues),
-            message,
-        )
-
     return Microgrid(
         id=MicrogridId(message.id),
         enterprise_id=EnterpriseId(message.enterprise_id),

{frequenz_client_assets-0.2.0 → frequenz_client_assets-0.3.1}/src/frequenz/client/assets/electrical_component/__init__.py

@@ -50,6 +50,7 @@ from ._problematic import (
     UnspecifiedComponent,
 )
 from ._static_transfer_switch import StaticTransferSwitch
+from ._steam_boiler import SteamBoiler
 from ._uninterruptible_power_supply import UninterruptiblePowerSupply
 from ._wind_turbine import WindTurbine
 
@@ -91,6 +92,7 @@ __all__ = [
     "MismatchedCategoryComponent",
     "UnrecognizedComponent",
     "UnspecifiedComponent",
+    "SteamBoiler",
     "StaticTransferSwitch",
     "UninterruptiblePowerSupply",
     "WindTurbine",

{frequenz_client_assets-0.2.0 → frequenz_client_assets-0.3.1}/src/frequenz/client/assets/electrical_component/_category.py

@@ -86,3 +86,6 @@ class ElectricalComponentCategory(enum.Enum):
 
     WIND_TURBINE = electrical_components_pb2.ELECTRICAL_COMPONENT_CATEGORY_WIND_TURBINE
     """A wind turbine."""
+
+    STEAM_BOILER = electrical_components_pb2.ELECTRICAL_COMPONENT_CATEGORY_STEAM_BOILER
+    """A steam boiler."""

{frequenz_client_assets-0.2.0 → frequenz_client_assets-0.3.1}/src/frequenz/client/assets/electrical_component/_electrical_component_proto.py

@@ -57,6 +57,7 @@ from ._power_transformer import PowerTransformer
 from ._precharger import Precharger
 from ._problematic import UnrecognizedComponent, UnspecifiedComponent
 from ._static_transfer_switch import StaticTransferSwitch
+from ._steam_boiler import SteamBoiler
 from ._types import ElectricalComponentType
 from ._uninterruptible_power_supply import UninterruptiblePowerSupply
 from ._wind_turbine import WindTurbine
@@ -172,6 +173,10 @@ def component_base_from_proto_with_issues(
     )
 
 
+# This function is just a big match statement to dispatch to the right component
+# class based on the category and subcategory, so it's fine to have many branches
+# here.
+# pylint: disable-next=too-many-branches
 def electrical_component_from_proto_with_issues(
     message: electrical_components_pb2.ElectricalComponent,
     *,
@@ -215,6 +220,7 @@ def electrical_component_from_proto_with_issues(
             | ElectricalComponentCategory.PRECHARGER
             | ElectricalComponentCategory.BREAKER
             | ElectricalComponentCategory.PLC
+            | ElectricalComponentCategory.STEAM_BOILER
             | ElectricalComponentCategory.STATIC_TRANSFER_SWITCH
             | ElectricalComponentCategory.UNINTERRUPTIBLE_POWER_SUPPLY
             | ElectricalComponentCategory.CAPACITOR_BANK
@@ -412,6 +418,7 @@ def _trivial_category_to_class(
     | Precharger
     | Breaker
     | Plc
+    | SteamBoiler
     | StaticTransferSwitch
     | UninterruptiblePowerSupply
     | CapacitorBank
@@ -429,6 +436,7 @@ def _trivial_category_to_class(
         ElectricalComponentCategory.PRECHARGER: Precharger,
         ElectricalComponentCategory.BREAKER: Breaker,
         ElectricalComponentCategory.PLC: Plc,
+        ElectricalComponentCategory.STEAM_BOILER: SteamBoiler,
         ElectricalComponentCategory.STATIC_TRANSFER_SWITCH: StaticTransferSwitch,
         ElectricalComponentCategory.UNINTERRUPTIBLE_POWER_SUPPLY: UninterruptiblePowerSupply,
         ElectricalComponentCategory.CAPACITOR_BANK: CapacitorBank,

frequenz_client_assets-0.3.1/src/frequenz/client/assets/electrical_component/_steam_boiler.py

@@ -0,0 +1,20 @@
+# License: MIT
+# Copyright © 2026 Frequenz Energy-as-a-Service GmbH
+
+"""Steam boiler component."""
+
+import dataclasses
+from typing import Literal
+
+from ._category import ElectricalComponentCategory
+from ._electrical_component import ElectricalComponent
+
+
+@dataclasses.dataclass(frozen=True, kw_only=True)
+class SteamBoiler(ElectricalComponent):
+    """A steam boiler."""
+
+    category: Literal[ElectricalComponentCategory.STEAM_BOILER] = (
+        ElectricalComponentCategory.STEAM_BOILER
+    )
+    """The category of this component."""

{frequenz_client_assets-0.2.0 → frequenz_client_assets-0.3.1}/src/frequenz/client/assets/electrical_component/_types.py

@@ -26,6 +26,7 @@ from ._problematic import (
     UnspecifiedComponent,
 )
 from ._static_transfer_switch import StaticTransferSwitch
+from ._steam_boiler import SteamBoiler
 from ._uninterruptible_power_supply import UninterruptiblePowerSupply
 from ._wind_turbine import WindTurbine
 
@@ -60,6 +61,7 @@ ElectricalComponentType: TypeAlias = (
     | Precharger
     | Breaker
     | Plc
+    | SteamBoiler
     | StaticTransferSwitch
     | UninterruptiblePowerSupply
     | CapacitorBank