Skip to content

ci: [Backport] Introduced vetting test on PRs and corrected package version to match "current state of the package" #3550

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 11 commits into from
Jul 31, 2025

Conversation

michalChrobot
Copy link
Collaborator

This PR is a backport of #3549 and introduces vetting test that should be running on PR to confirm that the package will be in "releasable state". Things to note are

Bumping package version

After N4E investigation in I noticed that vetting tests were not working properly because after each release we should bump package version to match "current state of the package" which means bumping it by a patch. That way the current package version is being compared against last released. Otherwise this test won't give us any valid result because we will be comparing 2 already released packages.

Because of that I bumped NGO internal version to 2.5.0 and in that way we will be comparing this "current" version against last released 2.4.3

What this test will do

This test will mostly evaluate API compatibility. What we want to achieve is to not release any new minor version if not needed/detect all new APIs earlier. Notice that this test will fail if any new API is introduced (because for new API we need to release new minor and not patch) and in such scenario we should either

  • Bump package version to new minor, indicating that we will release new minor version
  • Make the API internal/private

This will ensure that we know the current state of the package version. Notice that in theory we could also use wrench/api-validation test but this would require manually modifying this file after every wrench update (to add release.py execution) so easier approach will be to create a dedicated test and leave wrench one for actual release validation

release.py script

This python script is basically copied from N4E repo and updates CHANGELOG and any other places that need to be formatted for the release. For now it's only used for this test (to avoid it throwing an error about CHANGELOG being improperly formatted) but in the future we can use it to automate releasing

Backport

#3549

@michalChrobot
Copy link
Collaborator Author

We can consider landing this PR after 1.14.0 release so we are "up to date from the start"

Copy link
Collaborator

@NoelStephensUnity NoelStephensUnity left a comment

Choose a reason for hiding this comment

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

🚀

@michalChrobot
Copy link
Collaborator Author

FYI I included an improvement of release.py to address MTT-12840 and make the package "release ready" with running this script. I'm waiting for 1.14.0 to be merged back first

@michalChrobot michalChrobot merged commit caac92d into develop Jul 31, 2025
23 of 27 checks passed
@michalChrobot michalChrobot deleted the vetting-test-develop branch July 31, 2025 20:08
michalChrobot added a commit that referenced this pull request Jul 31, 2025
…atch "current state of the package" (#3549)

This PR introduces vetting test that should be running on PR to confirm
that the package will be in "releasable state". Things to note are

## Bumping package version
After N4E investigation in I noticed that vetting tests were not working
properly because after each release we should bump package version to
match "current state of the package" which means bumping it by a patch.
That way the current package version is being compared against last
released. Otherwise this test won't give us any valid result because we
will be comparing 2 already released packages.

Because of that I bumped NGO internal version to 2.5.0 and in that way
we will be comparing this "current" version against last released 2.4.3

## What this test will do
This test will mostly evaluate API compatibility. What we want to
achieve is to not release any new minor version if not needed/detect all
new APIs earlier. Notice that this test will fail if any new API is
introduced (because for new API we need to release new minor and not
patch) and in such scenario we should either
- Bump package version to new minor, indicating that we will release new
minor version
- Make the API internal/private

This will ensure that we know the current state of the package version.
Notice that in theory we could also use wrench/api-validation test but
this would require manually modifying this file after every wrench
update (to add release.py execution) so easier approach will be to
create a dedicated test and leave wrench one for actual release
validation

## release.py script
This python script is basically copied from N4E repo and updates
CHANGELOG and any other places that need to be formatted for the
release. For now it's only used for this test (to avoid it throwing an
error about CHANGELOG being improperly formatted) but in the future we
can use it to automate releasing

## Backport

#3550
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants