Skip to content
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

Plugins: Improve levitate / breaking changes report in grafana/grafana #89822

Merged
merged 19 commits into from
Jul 11, 2024

Conversation

oshirohugo
Copy link
Contributor

@oshirohugo oshirohugo commented Jun 27, 2024

What is this feature?

This PR is adding more details to the report generated by the levitate pipeline:

  • numbers of plugins affected by the breaking changes (if any)
  • links to a panel where they can see each plugin affected, how many imports they are doing and the files where the imports are done (see the example of the new report in the item Special notes for your reviewer

Why do we need this feature?

This feature is necessary to give developers a better way to analyse and react to possible breaking changes.

Who is this feature for?

Grafana developers

Which issue(s) does this PR fix?:

Fixes https://github.com/grafana/grafana-community-team/issues/137

Special notes for your reviewer:

In this feature we choose to go with links instead of showing the info directly to avoid showing info of private plugins.

This is an example of the new report:
##################

Changes

useTheme2
/tmp/@grafana/[email protected]/package/dist/index.d.ts
Parameter type changed:
-ErrorInfo
+interface ErrorInfo {
+    componentStack: string;
+}


GrafanaTheme2.spacing

/tmp/@grafana/[email protected]/package/dist/index.d.ts

-T = unknown
+T = any

Number of affected plugins: 22

To check the plugin affected by each import, click on the links below.

Changes

@grafana/ui/useTheme2
@grafana/data/GrafanaTheme2.spacing

##################

Please check that:

  • It works as expected from a user's perspective.
  • If this is a pre-GA feature, it is behind a feature toggle.
  • The docs are updated, and if this is a notable improvement, it's added to our What's New doc.

@oshirohugo oshirohugo self-assigned this Jun 27, 2024
@oshirohugo oshirohugo force-pushed the improve-levitate-report branch from 081588b to 9f6562d Compare July 1, 2024 10:07
@oshirohugo oshirohugo force-pushed the improve-levitate-report branch from 9f6562d to f0193b9 Compare July 4, 2024 12:56
@oshirohugo oshirohugo marked this pull request as ready for review July 10, 2024 11:11
@oshirohugo oshirohugo requested review from a team and tolzhabayev as code owners July 10, 2024 11:11
@github-actions github-actions bot added this to the 11.2.x milestone Jul 10, 2024
@oshirohugo oshirohugo changed the title Plugins: Add gcloud auth and usage to levitate workflow Plugins: Improve levitate / breaking changes report in grafana/grafana Jul 10, 2024
markdown += createLinks(changes, affectingProperties).join('<br>\n');
}
} else {
markdown += '<h4>No affected plugins found</h4>';
Copy link
Member

Choose a reason for hiding this comment

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

What if we don't print this part and instead just output a blank report?

My concern is that this line can give a false feeling that nothing is broken and you can go ahead and merge but in truth our database of dependency usage is not 100% reliable so we can't reliable say "nothing is affected"

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thanks for your review. It makes sense. I'll change that :D

Copy link
Member

@academo academo left a comment

Choose a reason for hiding this comment

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

Excellent work on this @oshirohugo !

Copy link
Contributor

@leventebalogh leventebalogh left a comment

Choose a reason for hiding this comment

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

Nice 🚀

@oshirohugo oshirohugo merged commit 0a1b9f9 into main Jul 11, 2024
15 checks passed
@oshirohugo oshirohugo deleted the improve-levitate-report branch July 11, 2024 09:38
ryantxu pushed a commit that referenced this pull request Jul 11, 2024
#89822)

* Plugins: Add gcloud auth and usage to levitate workflow

---------

Co-authored-by: Levente Balogh <[email protected]>
@aangelisc aangelisc modified the milestones: 11.2.x, 11.2.0 Aug 21, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Development

Successfully merging this pull request may close these issues.

4 participants