Initial upgrade to the API v0.17.x (#94)

This is a major breaking change, as we jump to the API specification
version 0.17.x, which introduces big and fundamental breaking changes.
This also starts using the `v1` namespace in `frequenz-api-common`,
which also introduces major breaking changes. It would be very hard to
detail all the API changes here, please refer to the [Microgrid API
releases](https://github.com/frequenz-floss/frequenz-api-microgrid/releases)
and [Common API
releases](https://github.com/frequenz-floss/frequenz-api-common/releases).

This PR also only focus on migrating the current functionality to
v0.17.x, and it is the starting point, only implementing
`GetMicrogridMetadata`. Other RPCs will be implemented in follow-up PRs.

Also many of the things added here will be moved to other repos. All
protobuf wrappers for `api-common` will be moved to `client-common`, and
the test framework for API clients will be moved to `client-base`.

Part of #55.

Author: llucax

pyproject.toml

@@ -36,12 +36,12 @@ classifiers = [
 ]
 requires-python = ">= 3.11, < 4"
 dependencies = [
-  "frequenz-api-microgrid >= 0.15.5, < 0.16.0",
-  "frequenz-channels >= 1.0.0-rc1, < 2.0.0",
-  "frequenz-client-base >= 0.8.0, < 0.12.0",
+  "frequenz-api-microgrid >= 0.17.2, < 0.18.0",
+  "frequenz-channels >= 1.6.1, < 2.0.0",
+  "frequenz-client-base >= 0.10.0, < 0.12.0",
   "frequenz-client-common >= 0.3.2, < 0.4.0",
-  "grpcio >= 1.63.0, < 2",
-  "protobuf >= 5.26.1, < 7",
+  "grpcio >= 1.72.1, < 2",
+  "protobuf >= 6.31.1, < 7",
   "timezonefinder >= 6.2.0, < 7",
   "typing-extensions >= 4.13.0, < 5",
 ]

src/frequenz/client/microgrid/__init__.py

@@ -7,39 +7,12 @@
 """
 
 
-from ._client import MicrogridApiClient
-from ._component import (
-    Component,
-    ComponentCategory,
-    ComponentMetadata,
-    ComponentMetricId,
-    ComponentType,
-    Fuse,
-    GridMetadata,
-    InverterType,
+from ._client import (
+    DEFAULT_CHANNEL_OPTIONS,
+    DEFAULT_GRPC_CALL_TIMEOUT,
+    MicrogridApiClient,
 )
-from ._component_data import (
-    BatteryData,
-    ComponentData,
-    EVChargerData,
-    InverterData,
-    MeterData,
-)
-from ._component_error import (
-    BatteryError,
-    BatteryErrorCode,
-    ErrorLevel,
-    InverterError,
-    InverterErrorCode,
-)
-from ._component_states import (
-    BatteryComponentState,
-    BatteryRelayState,
-    EVChargerCableState,
-    EVChargerComponentState,
-    InverterComponentState,
-)
-from ._connection import Connection
+from ._delivery_area import DeliveryArea, EnergyMarketCodeType
 from ._exception import (
     ApiClientError,
     ClientNotConnected,
@@ -63,45 +36,27 @@
     UnrecognizedGrpcStatus,
 )
 from ._lifetime import Lifetime
-from ._metadata import Location, Metadata
+from ._location import Location
+from ._microgrid_info import MicrogridInfo, MicrogridStatus
 
 __all__ = [
     "ApiClientError",
-    "BatteryComponentState",
-    "BatteryData",
-    "BatteryError",
-    "BatteryErrorCode",
-    "BatteryRelayState",
     "ClientNotConnected",
-    "Component",
-    "ComponentCategory",
-    "ComponentData",
-    "ComponentMetadata",
-    "ComponentMetricId",
-    "ComponentType",
-    "Connection",
+    "DEFAULT_CHANNEL_OPTIONS",
+    "DEFAULT_GRPC_CALL_TIMEOUT",
     "DataLoss",
-    "EVChargerCableState",
-    "EVChargerComponentState",
-    "EVChargerData",
+    "DeliveryArea",
+    "EnergyMarketCodeType",
     "EntityAlreadyExists",
     "EntityNotFound",
-    "ErrorLevel",
-    "Fuse",
-    "GridMetadata",
     "GrpcError",
     "InternalError",
     "InvalidArgument",
-    "InverterComponentState",
-    "InverterData",
-    "InverterError",
-    "InverterErrorCode",
-    "InverterType",
     "Lifetime",
     "Location",
-    "Metadata",
-    "MeterData",
     "MicrogridApiClient",
+    "MicrogridInfo",
+    "MicrogridStatus",
     "OperationAborted",
     "OperationCancelled",
     "OperationNotImplemented",