Deprecate legacy "homeassistant" entry in hassio backup/restore folders#170317
Merged
Conversation
The hassio.backup_partial and hassio.restore_partial actions still accept "homeassistant" inside the folders list as an alias for setting homeassistant=True. Raise a fixable, persistent repair issue when the legacy alias is used so users can migrate their automations and scripts. The alias is scheduled to be removed in 2026.12. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
agners
added
integration: hassio
deprecation
home-assistant
Bot
added
cla-signed
core
has-tests
by-code-owner
Quality Scale: internal
labels
Contributor
|
Hey there @home-assistant/supervisor, mind taking a look at this pull request as it has been labeled with an integration ( Code owner commandsCode owners of
|
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a persistent, fixable Repairs issue to help users migrate off the legacy "homeassistant" entry in the folders list for hassio.backup_partial / hassio.restore_partial, ahead of its planned removal in 2026.12.
Changes:
- Create a persistent warning Repairs issue when the legacy
"homeassistant"folder alias is used in partial backup/restore. - Add a
ConfirmRepairFlowfix flow and corresponding user-facing translations for the new issue. - Extend the existing hassio partial backup legacy-folder test to assert the issue is created.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| tests/components/hassio/test_init.py | Verifies a Repairs issue is created when the legacy folder alias is used. |
| homeassistant/components/hassio/strings.json | Adds translations for the new persistent, fixable Repairs issue and confirm flow. |
| homeassistant/components/hassio/services.py | Raises the Repairs issue from the legacy-folder normalization path in partial backup/restore services. |
| homeassistant/components/hassio/repairs.py | Routes the new issue to a ConfirmRepairFlow so users can self-resolve after updating automations/scripts. |
| homeassistant/components/hassio/const.py | Defines the new issue key constant used across services/repairs/translations. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Breaking change
Proposed change
Follow-up of #170312.
The
hassio.backup_partialandhassio.restore_partialactions still accept"homeassistant"inside thefolderslist as a legacy alias for settinghomeassistant: true. Raise a fixable, persistent repair issue when the alias is used so users can migrate their automations and scripts. The alias is scheduled to be removed in 2026.12.The repair flow uses
ConfirmRepairFlow, so users mark the issue resolved themselves once they've updated their automations.Type of change
Additional information
Checklist
ruff format homeassistant tests)If user exposed functionality or configuration variables are added/changed:
If the code communicates with devices, web services, or third-party tools:
Updated and included derived files by running:
python3 -m script.hassfest.requirements_all.txt.Updated by running
python3 -m script.gen_requirements_all.To help with the load of incoming pull requests: