Move Fuse to timeseries module

The Grid class is the only class that uses `Fuse` as it is used
to represent the fuse of a grid. It is not a microgrid-specific class.
Therefore, it is moved to the timeseries module.

Signed-off-by: Daniel Zullo <[email protected]>

Author: daniel-zullo-frequenz

RELEASE_NOTES.md

@@ -8,6 +8,8 @@
 
 - The `BatteryPool.power_status` method now streams objects of type `BatteryPoolReport`.  They're identical to the previous `Report` objects, except for the name of the class.
 
+- The `Fuse` class has been moved to the `frequenz.sdk.timeseries` module.
+
 ## New Features
 
 <!-- Here goes the main new features and examples or instructions on how to use them -->

src/frequenz/sdk/microgrid/__init__.py

@@ -124,7 +124,7 @@
 
 from ..actor import ResamplerConfig
 from ..timeseries.grid import initialize as initialize_grid
-from . import _data_pipeline, client, component, connection_manager, fuse, metadata
+from . import _data_pipeline, client, component, connection_manager, metadata
 from ._data_pipeline import (
     battery_pool,
     ev_charger_pool,
@@ -157,7 +157,6 @@ async def initialize(host: str, port: int, resampler_config: ResamplerConfig) ->
     "component",
     "battery_pool",
     "ev_charger_pool",
-    "fuse",
     "grid",
     "frequency",
     "logical_meter",

src/frequenz/sdk/microgrid/component/_component.py

@@ -10,8 +10,7 @@
 import frequenz.api.microgrid.grid_pb2 as grid_pb
 import frequenz.api.microgrid.inverter_pb2 as inverter_pb
 
-from ...timeseries import Current
-from ..fuse import Fuse
+from ...timeseries import Current, Fuse
 
 
 class ComponentType(Enum):

src/frequenz/sdk/timeseries/__init__.py

@@ -37,6 +37,7 @@
 
 from .._internal._channels import ReceiverFetcher
 from ._base_types import UNIX_EPOCH, Bounds, Sample, Sample3Phase
+from ._fuse import Fuse
 from ._moving_window import MovingWindow
 from ._periodic_feature_extractor import PeriodicFeatureExtractor
 from ._quantities import (
@@ -53,6 +54,7 @@
 
 __all__ = [
     "Bounds",
+    "Fuse",
     "MovingWindow",
     "PeriodicFeatureExtractor",
     "ResamplerConfig",

src/frequenz/sdk/microgrid/fuse.py src/frequenz/sdk/timeseries/_fuse.pysrc/frequenz/sdk/microgrid/fuse.py renamed to src/frequenz/sdk/timeseries/_fuse.py

@@ -2,10 +2,14 @@
 # Copyright © 2023 Frequenz Energy-as-a-Service GmbH
 
 """Fuse data class."""
+from __future__ import annotations
 
 from dataclasses import dataclass
+from typing import TYPE_CHECKING
 
-from ..timeseries import Current
+if TYPE_CHECKING:
+    # Break circular import by enclosing these type hints in a `TYPE_CHECKING` block.
+    from . import Current
 
 
 @dataclass(frozen=True)

src/frequenz/sdk/timeseries/grid.py

@@ -13,7 +13,7 @@
 
 from ..microgrid.component import Component
 from ..microgrid.component._component import ComponentCategory
-from ..microgrid.fuse import Fuse
+from . import Fuse
 
 _logger = logging.getLogger(__name__)
 

tests/microgrid/test_client.py

@@ -26,8 +26,7 @@
     InverterType,
     MeterData,
 )
-from frequenz.sdk.microgrid.fuse import Fuse
-from frequenz.sdk.timeseries import Current
+from frequenz.sdk.timeseries import Current, Fuse
 
 from . import mock_api
 

tests/microgrid/test_graph.py

@@ -21,8 +21,7 @@
     GridMetadata,
     InverterType,
 )
-from frequenz.sdk.microgrid.fuse import Fuse
-from frequenz.sdk.timeseries import Current
+from frequenz.sdk.timeseries import Current, Fuse
 
 from .mock_api import MockGrpcServer, MockMicrogridServicer
 

tests/microgrid/test_grid.py

@@ -4,8 +4,7 @@
 """Tests for the `Grid` module."""
 
 from frequenz.sdk.microgrid.component import Component, ComponentCategory, GridMetadata
-from frequenz.sdk.microgrid.fuse import Fuse
-from frequenz.sdk.timeseries import Current
+from frequenz.sdk.timeseries import Current, Fuse
 from frequenz.sdk.timeseries import grid as _grid