Expose microgrid ID and location

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

Author: daniel-zullo-frequenz

src/frequenz/sdk/microgrid/connection_manager.py

@@ -16,7 +16,7 @@
 from ._graph import ComponentGraph, _MicrogridComponentGraph
 from .client import MicrogridApiClient
 from .client._client import MicrogridGrpcClient
-from .metadata import Metadata
+from .metadata import Location, Metadata
 
 # Not public default host and port
 _DEFAULT_MICROGRID_HOST = "[::1]"
@@ -75,6 +75,24 @@ def component_graph(self) -> ComponentGraph:
             component graph
         """
 
+    @property
+    @abstractmethod
+    def microgrid_id(self) -> int | None:
+        """Get the ID of the microgrid.
+
+        Returns:
+            the ID of the microgrid.
+        """
+
+    @property
+    @abstractmethod
+    def location(self) -> Location | None:
+        """Get the location of the microgrid.
+
+        Returns:
+            the location of the microgrid.
+        """
+
     async def _update_api(self, host: str, port: int) -> None:
         self._host = host
         self._port = port
@@ -116,6 +134,24 @@ def api_client(self) -> MicrogridApiClient:
         """
         return self._api
 
+    @property
+    def microgrid_id(self) -> int | None:
+        """Get the microgrid metadata if available.
+
+        Returns:
+            the microgrid metadata if available, None otherwise.
+        """
+        return self._metadata.microgrid_id if self._metadata else None
+
+    @property
+    def location(self) -> Location | None:
+        """Get the microgrid location if available.
+
+        Returns:
+            the microgrid location if available, None otherwise.
+        """
+        return self._metadata.location if self._metadata else None
+
     @property
     def component_graph(self) -> ComponentGraph:
         """Get component graph.