Merge pull request #37 from sandovalrr/feat/use-v1-alpha8

feat(v1alpha8): Update proto imports to v1alpha8 for microgrid components in assets.proto

Author: sandovalrr

RELEASE_NOTES.md

@@ -2,14 +2,11 @@
 
 ## Summary
 
-Adjusted the RPC names to align with the new naming convention, and updated the `frequenz-api-common` dependency.
-
 
 ## Upgrading
 
-- Update the `frequenz-api-common` dependency
+- Update the `frequenz-api-common` dependency 
 
 ## New Features
 
-- Renamed `ListMicrogridComponents` to `ListMicrogridElectricalComponents` and `ListMicrogridComponentConnections` to `ListMicrogridElectricalComponentConnections`.
 

proto/frequenz/api/assets/v1/assets.proto

@@ -14,8 +14,9 @@ syntax = "proto3";
 
 package frequenz.api.assets.v1;
 
-import "frequenz/api/common/v1/microgrid/electrical_components/electrical_components.proto";
-import "frequenz/api/common/v1/microgrid/microgrid.proto";
+import "frequenz/api/common/v1alpha8/microgrid/electrical_components/electrical_components.proto";
+import "frequenz/api/common/v1alpha8/microgrid/microgrid.proto";
+
 
 // Service providing access to manage and retrieve information
 // related to gridpools and microgrids, and other platform assets.
@@ -45,7 +46,7 @@ message GetMicrogridRequest {
 // given a specific microgrid.
 message GetMicrogridResponse {
   // Details of the requested microgrid.
-  frequenz.api.common.v1.microgrid.Microgrid microgrid = 1;
+  frequenz.api.common.v1alpha8.microgrid.Microgrid microgrid = 1;
 }
 
 // Request parameters for the RPC `ListMicrogridElectricalComponents`.
@@ -58,7 +59,7 @@ message ListMicrogridElectricalComponentsRequest {
   repeated uint64 component_ids = 2;
 
   // Return components that have the specified categories only.
-  repeated frequenz.api.common.v1.microgrid.electrical_components.ElectricalComponentCategory categories = 3;
+  repeated frequenz.api.common.v1alpha8.microgrid.electrical_components.ElectricalComponentCategory categories = 3;
 }
 
 // A message containing a list of electrical components.
@@ -67,7 +68,7 @@ message ListMicrogridElectricalComponentsResponse {
   uint64 microgrid_id = 1;
 
   // List of electrical components matching the filter criteria.
-  repeated frequenz.api.common.v1.microgrid.electrical_components.ElectricalComponent components = 2;
+  repeated frequenz.api.common.v1alpha8.microgrid.electrical_components.ElectricalComponent components = 2;
 }
 
 // ListMicrogridElectricalComponentConnectionsRequest is used for filtering and listing
@@ -115,5 +116,5 @@ message ListMicrogridElectricalComponentConnectionsResponse {
   uint64 microgrid_id = 1;
 
   // Contains the list of connections that match the filtering criteria.
-  repeated frequenz.api.common.v1.microgrid.electrical_components.ElectricalComponentConnection connections =2;
+  repeated frequenz.api.common.v1alpha8.microgrid.electrical_components.ElectricalComponentConnection connections =2;
 }

pyproject.toml

@@ -3,16 +3,16 @@
 
 [build-system]
 requires = [
-  "setuptools == 75.8.0",
+  "setuptools == 80.9.0",
   "setuptools_scm[toml] == 8.3.1",
-  "frequenz-repo-config[api] == 0.13.3",
+  "frequenz-repo-config[api] == 0.13.5",
   # We need to pin the protobuf, grpcio and  grpcio-tools dependencies to make
   # sure the code is generated using the minimum supported versions, as older
   # versions can't work with code that was generated with newer versions.
   # https://protobuf.dev/support/cross-version-runtime-guarantee/#backwards
-  "protobuf == 5.29.3",
-  "grpcio-tools == 1.70.0",
-  "grpcio == 1.70.0",
+  "protobuf == 6.31.1",
+  "grpcio-tools == 1.73.1",
+  "grpcio == 1.73.1",
 ]
 build-backend = "setuptools.build_meta"
 
@@ -45,15 +45,15 @@ classifiers = [
 ]
 requires-python = ">= 3.11, < 4"
 dependencies = [
-  "frequenz-api-common @ git+https://github.com/frequenz-floss/frequenz-api-common.git@0e45c6d7fe92b708f1e7ca7a6f13e4513bfe7cf4",
+  "frequenz-api-common >= 0.8.0, < 0.9",
   # We can't widen beyond the current value unless we bump the minimum
   # requirements too because of protobuf cross-version runtime guarantees:
   # https://protobuf.dev/support/cross-version-runtime-guarantee/#major
   "protobuf >= 6.31.1, < 8", # Do not widen beyond 8!
   # We couldn't find any document with a spec about the cross-version runtime
   # guarantee for grpcio, so unless we find one in the future, we'll assume
   # major version jumps are not compatible
-  "grpcio >= 1.72.1, < 2", # Do not widen beyond 2!
+  "grpcio >= 1.73.1, < 2", # Do not widen beyond 2!
 ]
 dynamic = ["version"]
 
@@ -63,42 +63,42 @@ email = "floss@frequenz.com"
 
 [project.optional-dependencies]
 dev-flake8 = [
-  "flake8 == 7.2.0",
+  "flake8 == 7.3.0",
   "flake8-docstrings == 1.7.0",
-  "flake8-pyproject == 1.2.3", # For reading the flake8 config from pyproject.toml
+  "flake8-pyproject == 1.2.3",  # For reading the flake8 config from pyproject.toml
   "pydoclint == 0.6.6",
   "pydocstyle == 6.3.0",
 ]
 dev-formatting = ["black == 25.1.0", "isort == 6.0.1"]
 dev-mkdocs = [
-  "Markdown == 3.8",
+  "Markdown == 3.8.2",
   "black == 25.1.0",
   "mike == 2.1.3",
   "mkdocs-gen-files == 0.5.0",
   "mkdocs-literate-nav == 0.6.2",
   "mkdocs-macros-plugin == 1.3.7",
-  "mkdocs-material == 9.6.12",
-  "mkdocstrings[python] == 0.29.1",
-  "mkdocstrings-python == 1.16.10",
-  "frequenz-repo-config[api] == 0.13.3",
+  "mkdocs-material == 9.6.16",
+  "mkdocstrings[python] == 0.30.0",
+  "mkdocstrings-python == 1.16.12",
+  "frequenz-repo-config[api] == 0.13.5",
 ]
 dev-mypy = [
-  "mypy == 1.15.0",
-  "grpc-stubs == 1.53.0.5",
-  "types-Markdown == 3.8.0.20250415",
+  "mypy == 1.17.1",
+  "grpc-stubs == 1.53.0.6",
+  "types-Markdown == 3.8.0.20250708",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-api-assets[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
-dev-noxfile = ["nox == 2024.10.9", "frequenz-repo-config[api] == 0.13.3"]
+dev-noxfile = ["nox == 2025.5.1", "frequenz-repo-config[api] == 0.13.5"]
 dev-pylint = [
   # dev-pytest already defines a dependency to pylint because of the examples
   # For checking the noxfile, docs/ script, and tests
   "frequenz-api-assets[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
 dev-pytest = [
-  "pytest == 8.3.5",
-  "pylint == 3.3.6", # We need this to check for the examples
-  "frequenz-repo-config[extra-lint-examples] == 0.13.3",
+  "pytest == 8.4.1",
+  "pylint == 3.3.7",  
+  "frequenz-repo-config[extra-lint-examples] == 0.13.5",
 ]
 dev = [
   "frequenz-api-assets[dev-mkdocs,dev-flake8,dev-formatting,dev-mkdocs,dev-mypy,dev-noxfile,dev-pylint,dev-pytest]",