Skip to content

Conversation

@tiyash-basu-frequenz
Copy link
Contributor

@tiyash-basu-frequenz tiyash-basu-frequenz commented Jun 13, 2025

closes #349

Copilot AI review requested due to automatic review settings June 13, 2025 16:20
@tiyash-basu-frequenz tiyash-basu-frequenz requested a review from a team as a code owner June 13, 2025 16:20
@tiyash-basu-frequenz tiyash-basu-frequenz marked this pull request as draft June 13, 2025 16:20
@github-actions github-actions bot added part:docs Affects the documentation part:protobuf Affects the protocol buffer definition files part:python Affects the Python bindings part:tests Affects the unit, integration and performance (benchmarks) tests labels Jun 13, 2025
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR renames the v1 package to v1alpha7 and updates related proto imports to align with the new API version, while also incorporating content from the v0.6.x branch. Key changes include updating package names and import paths for consistency, reorganizing sensor and components definitions, and revising release notes to document these changes.

Reviewed Changes

Copilot reviewed 54 out of 54 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
proto/frequenz/api/common/v1alpha7/market/price.proto New price proto definitions under the v1alpha7 package.
proto/frequenz/api/common/v1alpha7/market/power.proto New power proto definitions under the v1alpha7 package.
proto/frequenz/api/common/v1alpha7/market/energy.proto New energy proto definitions under the v1alpha7 package.
proto/frequenz/api/common/v1alpha7/grid/delivery_duration.proto New grid delivery_duration definitions.
proto/frequenz/api/common/v1alpha7/grid/delivery_area.proto New grid delivery_area definitions (note a spelling issue in the initial comment).
proto/frequenz/api/common/v1/types/decimal.proto Package update from “type” to “types”.
proto/frequenz/api/common/v1/microgrid/sensors/sensors.proto Updates to sensor definitions, including renaming SensorTelemetry to SensorData and import changes.
proto/frequenz/api/common/v1/microgrid/microgrid.proto Updated location import to the new package path.
proto/frequenz/api/common/v1/microgrid/components/*.proto Package renaming changes from “electrical_components” to “components”.
proto/frequenz/api/common/v1/metrics/metric_sample.proto New metric sample definitions.
proto/frequenz/api/common/v1/market/price.proto, power.proto, energy.proto Import updates for the new “types” package.
proto/frequenz/api/common/v1/location.proto Package rename update.
RELEASE_NOTES.md Updated to document the new package naming as well as changes in component types.
Comments suppressed due to low confidence (1)

RELEASE_NOTES.md:36

  • The release notes mention a change from INVERTER_TYPE_SOLAR to INVERTER_TYPE_PHOTOVOLTAIC, but the inverter.proto diff shows the removal of INVERTER_TYPE_WIND_TURBINE instead. Please ensure the release notes accurately reflect the actual code changes.
* `InverterType.INVERTER_TYPE_SOLAR` to `InverterType.INVERTER_TYPE_PHOTOVOLTAIC` (to align with the more colloquial term "PV inverter", but without using abbreviations)

@tiyash-basu-frequenz
Copy link
Contributor Author

Waiting on frequenz-floss/frequenz-repo-config-python#418 getting merged and incorporated into this repo.

@tiyash-basu-frequenz tiyash-basu-frequenz added the status:blocked Other issues must be resolved before this can be worked on label Jun 16, 2025
@llucax
Copy link
Contributor

llucax commented Jun 16, 2025

I created #375 to not mix both issues, as this PR is already disruptive enough 😱

This commit makes the following changes:
- Renames the `v1` package to `v1alpha7` in the proto files.
- Renames the `v1` directory to `v1alpha7` in the proto files.
- Renames the `v1` directory to `v1alpha7` in the `py` directory.
- Rename the test file `test_common.py` to `test_common_v1alpha7.py`.

Signed-off-by: Tiyash Basu <[email protected]>
This commit re-creates the `v1` package with the contents of the
`v0.6.x` branch, which is the latest stable version of the API. The
previous `v1` package has been renamed to `v1alpha7`.

This means that any client or server code that was using the v0.6.x
branch can now use the main branch without any changes, as the
`v1` package now contains the same contents as the `v0.6.x` branch.

Signed-off-by: Tiyash Basu <[email protected]>
llucax added 2 commits June 17, 2025 11:46
Signed-off-by: Leandro Lucarella <[email protected]>
Some files where missing the copyright notice completely, some files
have the wrong copyright year, some files had some TODOs in the
docstring and most had a bad or outdated docstring.

Signed-off-by: Leandro Lucarella <[email protected]>
@florian-wagner-frequenz

Guess I'll approve to get this moving

@tiyash-basu-frequenz tiyash-basu-frequenz added this pull request to the merge queue Jun 17, 2025
@tiyash-basu-frequenz
Copy link
Contributor Author

Thanks @florian-wagner-frequenz :)

@llucax llucax removed the status:blocked Other issues must be resolved before this can be worked on label Jun 17, 2025
Merged via the queue into frequenz-floss:v0.x.x with commit 2eb69e4 Jun 17, 2025
7 checks passed
@tiyash-basu-frequenz tiyash-basu-frequenz deleted the 349_package_versioning branch June 17, 2025 09:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

part:docs Affects the documentation part:protobuf Affects the protocol buffer definition files part:python Affects the Python bindings part:tests Affects the unit, integration and performance (benchmarks) tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Adopt the v1alpha7 namespace for v0.7.0

3 participants