Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Update Docs for Entity Data Migration#41982

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 ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Draft
xvanov wants to merge2 commits intohome-assistant:current
base:current
Choose a base branch
Loading
fromxvanov:entity-data-migration

Conversation

@xvanov
Copy link

Breaking change

N/A - This is a new integration with no breaking changes.

Proposed change

See:https://github.com/orgs/home-assistant/discussions/147

Add newentity_migration integration that scans Home Assistant
configurations to find all references to a given entity. This enables
administrators to understand where an entity is used before removing
or replacing it.

Key components:

  • EntityMigrationScanner: Scans automations, scripts, scenes, groups,
    and Lovelace dashboards for entity references
  • WebSocket API: entity_migration/scan command for frontend integration
  • Services: entity_migration.scan service for automation/script usage
  • Models: ScanResult, Reference, and ConfigType dataclasses

The scanner searches across:

  • automation.yaml and automations/*.yaml
  • scripts.yaml and scripts/*.yaml
  • scenes.yaml
  • groups.yaml
  • Lovelace dashboard configs (.storage/lovelace*)

Architecture follows Home Assistant patterns:

  • Async-first design with proper executor usage for file I/O
  • WebSocket commands require admin permission
  • Proper config entry lifecycle management
  • Comprehensive test coverage (27 tests, 91% coverage)

This is the foundation for a planned migration feature which will add
the capability to replace entity references across all configurations.

Type of change

  • Dependency upgrade
  • Bugfix (non-breaking change which fixes an issue)
  • New integration (thank you!)
  • New feature (which adds functionality to an existing integration)
  • Deprecation (breaking change to happen in the future)
  • Breaking change (fix/feature causing existing functionality to break)
  • Code quality improvements to existing code or addition of tests

Additional information

  • This PR fixes or closes issue: fixes #
  • This PR is related to issue:
  • Link to documentation pull request:
  • Link to developer documentation pull request:
  • Link to frontend pull request:

Checklist

  • I understand the code I am submitting and can explain how it works.
  • The code change is tested and works locally.
  • Local tests pass.Your PR cannot be merged unless tests pass
  • There is no commented out code in this PR.
  • I have followed thedevelopment checklist
  • I have followed theperfect PR recommendations
  • The code has been formatted using Ruff (ruff format homeassistant tests)
  • Tests have been added to verify that the new code works.
  • Any generated code has been carefully reviewed for correctness and compliance with project standards.

If user exposed functionality or configuration variables are added/changed:

If the code communicates with devices, web services, or third-party tools:

  • Themanifest file has all fields filled out correctly.
    Updated and included derived files by running:python3 -m script.hassfest.
  • New or updated dependencies have been added torequirements_all.txt.
    Updated by runningpython3 -m script.gen_requirements_all.
  • For the updated dependencies - a link to the changelog, or at minimum a diff between library versions is added to the PR description.

To help with the load of incoming pull requests:

reated-desc+review%3Anone+-status%3Afailure

Summary by CodeRabbit

  • New Features
    • Added Entity Migration (scan service + websocket), Google Air Quality integration (sensors, config flow), and Philips Hue BLE device support (BLE light platform, config flow).
  • Documentation
    • Added UI strings, service descriptions, icons, and quality_scale entries for new integrations.
  • Refactor
    • Template sensor internals reorganized; Esphome entity naming/association behavior updated.
  • Tests
    • Extensive unit, integration, and websocket tests for new features.
  • Chores
    • Brand lists and requirement pins updated; validation/quality checks adjusted.

✏️ Tip: You can customize this high-level summary in your review settings.

@xvanovxvanov requested a review froma team as acode ownerNovember 26, 2025 03:30
@home-assistanthome-assistantbot added the currentThis PR goes into the current branch labelNov 26, 2025
@netlify
Copy link

netlifybot commentedNov 26, 2025
edited
Loading

Deploy Preview forhome-assistant-docs ready!

NameLink
🔨 Latest commit53e94cc
🔍 Latest deploy loghttps://app.netlify.com/projects/home-assistant-docs/deploys/692786deb9ffbc0008ce50b5
😎 Deploy Previewhttps://deploy-preview-41982--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to yourNetlify project configuration.

@c0ffeeca7
Copy link
Contributor

Thank you for contributing,@xvanov 💪

  1. As this PR seems to be related to a code PR, pleaserebase and point this PR against thenext branch.
  2. Please do not alter the PR template. Restore the original template for documentation PRs.
  3. In the PR template, add the link to the related core PR.

@c0ffeeca7c0ffeeca7 marked this pull request as draftNovember 26, 2025 08:41
@c0ffeeca7
Copy link
Contributor

I'mdrafting this PR, as changes are needed.

Please undraft it once the changes have been implemented and the PR is ready for review again.

Sign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

currentThis PR goes into the current branch

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@xvanov@c0ffeeca7

[8]ページ先頭

©2009-2025 Movatter.jp