Skip to content

Add availability template to config flow #147623

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

Open
wants to merge 3 commits into
base: dev
Choose a base branch
from

Conversation

Petro31
Copy link
Contributor

@Petro31 Petro31 commented Jun 26, 2025

Breaking change

Proposed change

Add availability template to config flow inside advanced options.

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

  • 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 the development checklist
  • I have followed the perfect PR recommendations
  • The code has been formatted using Ruff (ruff format homeassistant tests)
  • Tests have been added to verify that the new code works.

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

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

  • The manifest 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 to requirements_all.txt.
    Updated by running python3 -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:

@home-assistant
Copy link

Hey there @home-assistant/core, mind taking a look at this pull request as it has been labeled with an integration (template) you are listed as a code owner for? Thanks!

Code owner commands

Code owners of template can trigger bot actions by commenting:

  • @home-assistant close Closes the pull request.
  • @home-assistant rename Awesome new title Renames the pull request.
  • @home-assistant reopen Reopen the pull request.
  • @home-assistant unassign template Removes the current integration label and assignees on the pull request, add the integration domain after the command.
  • @home-assistant add-label needs-more-information Add a label (needs-more-information, problem in dependency, problem in custom component) to the pull request.
  • @home-assistant remove-label needs-more-information Remove a label (needs-more-information, problem in dependency, problem in custom component) on the pull request.

@Petro31 Petro31 marked this pull request as draft June 26, 2025 19:00
@Petro31
Copy link
Contributor Author

Petro31 commented Jun 26, 2025

cc @epenet

@Petro31
Copy link
Contributor Author

Petro31 commented Jun 26, 2025

Not ready for review, missing tests. Code for functionality is complete.

@frenck frenck requested a review from Copilot June 26, 2025 21:03
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR adds an “Availability” template option under an “Advanced Options” section for all template entities in the config flow and refactors schema definitions across the template platform to merge those advanced options into each component’s config entry schema.

  • Introduce advanced_options with a collapsible “Availability” template selector in config_flow.py
  • Create a helper to flatten advanced_options into top-level options and update all template components to use it
  • Refactor base and feature schemas in trigger_template_entity.py and each homeassistant/components/template/*.py to extend a shared common config-entry schema

Reviewed Changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
helpers.py Added rewrite_configy_entry_to_options_config to merge advanced options into options
config_flow.py Added an advanced_options section for availability templates
helpers/trigger_template_entity.py Split and renamed sensor base schema for advanced options support
template_entity.py & individual component files (sensor, switch, select, number, image, button, binary_sensor, alarm_control_panel) Updated each schema to extend the new common config-entry schema and call the helper
strings.json Added “Advanced Options” and “Availability” translations under each entity section
Comments suppressed due to low confidence (2)

homeassistant/components/template/helpers.py:21

  • The function name rewrite_configy_entry_to_options_config contains a typo. Rename it to rewrite_config_entry_to_options_config for clarity and consistency.
def rewrite_configy_entry_to_options_config(config_entry: ConfigEntry) -> ConfigType:

homeassistant/components/template/helpers.py:21

  • Add unit tests for rewrite_configy_entry_to_options_config to verify that merging advanced_options behaves as expected and that options are flattened correctly.
def rewrite_configy_entry_to_options_config(config_entry: ConfigEntry) -> ConfigType:

@@ -98,6 +146,14 @@
"data_description": {
"device_id": "Select a device to link to this entity."
Copy link
Preview

Copilot AI Jun 26, 2025

Choose a reason for hiding this comment

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

[nitpick] This hard-coded English string bypasses the standard translation key used elsewhere. Consider replacing it with the translation reference ([%key:component::template::config::step::sensor::data_description::device_id%]) for consistency.

Suggested change
"device_id": "Select a device to link to this entity."
"device_id": "[%key:component::template::config::step::sensor::data_description::device_id%]"

Copilot uses AI. Check for mistakes.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This should be in a separate PR

@Petro31 Petro31 marked this pull request as ready for review June 27, 2025 11:00
@dhover
Copy link

dhover commented Jun 27, 2025

@Petro31 The function name rewrite_configy_entry_to_options_config contains a typo in helpers.py.
Did you see that typo?

@@ -98,6 +146,14 @@
"data_description": {
"device_id": "Select a device to link to this entity."
},
"sections": {
"advanced_options": {
"name": "Advanced Options",
Copy link
Contributor

Choose a reason for hiding this comment

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

Sentence-casing:

Suggested change
"name": "Advanced Options",
"name": "Advanced options",

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

Successfully merging this pull request may close these issues.

3 participants