Skip to content

Show update release URL for installed version#702

Draft
TheJulianJES wants to merge 3 commits intozigpy:devfrom
TheJulianJES:tjj/update_show_info_downgrades
Draft

Show update release URL for installed version#702
TheJulianJES wants to merge 3 commits intozigpy:devfrom
TheJulianJES:tjj/update_show_info_downgrades

Conversation

@TheJulianJES
Copy link
Contributor

@TheJulianJES TheJulianJES commented Mar 5, 2026

Proposed change

This changes ZHA update entities to show the release_url of the latest firmware (provided as .downgrades[0]).

Additional information

For zigpy-ota provided updates, the release_url is generally a link to the pull request where that update was submitted. The pull request also shows more context for the update, potentially with additional release notes in the comments. This also allows us to have an easy place to collect feedback for these updates and for HA users to find that, even after they already installed the update.

We can also consider showing the latest (markdown) release notes if that update is already installed. If so, should only the latest version's release notes be shown, the last 5, or all of them?

Related:

Newer version installed than latest in OTA repo?

Right now, we'll show the release URL for the latest version in zigpy-ota. If a user has newer firmware installed than in the zigpy-ota repo, should we not show that link then?
This sometimes happens when manufacturers install new firmware in the factory but consider it to be unimportant to upgrade existing devices with.

Apps

ESPHome / HA apps do not use HA's release_url but instead provide the "release announcement link" in the release notes themselves. This may also be useful for us, since we combine multiple upgrade release notes with the PR linked above, but only ever show the link for the latest release.

More info dialog for ESPHome update entity showing release announcement link in the release notes itself, instead of using HA's dedicated release link position at the top

It's also a little easier to spot there IMO, as it's currently a bit hidden at the top. The general update note is only shown below, which Matter might do the other way around even(?)

@codecov
Copy link

codecov bot commented Mar 5, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.51%. Comparing base (c51efa5) to head (df69b3d).

Additional details and impacted files
@@           Coverage Diff           @@
##              dev     #702   +/-   ##
=======================================
  Coverage   97.51%   97.51%           
=======================================
  Files          62       62           
  Lines       10946    10947    +1     
=======================================
+ Hits        10674    10675    +1     
  Misses        272      272           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

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.

1 participant