homeassistant 2025.8.2__py3-none-any.whl → 2025.9.0b0__py3-none-any.whl

homeassistant/components/home_connect/services.py

@@ -8,7 +8,6 @@ from typing import Any, cast
 from aiohomeconnect.client import Client as HomeConnectClient
 from aiohomeconnect.model import (
     ArrayOfOptions,
-    CommandKey,
     Option,
     OptionKey,
     ProgramKey,
@@ -21,7 +20,6 @@ from homeassistant.const import ATTR_DEVICE_ID
 from homeassistant.core import HomeAssistant, ServiceCall, callback
 from homeassistant.exceptions import HomeAssistantError, ServiceValidationError
 from homeassistant.helpers import config_validation as cv, device_registry as dr
-from homeassistant.helpers.issue_registry import IssueSeverity, async_create_issue
 
 from .const import (
     AFFECTS_TO_ACTIVE_PROGRAM,
@@ -29,18 +27,11 @@ from .const import (
     ATTR_AFFECTS_TO,
     ATTR_KEY,
     ATTR_PROGRAM,
-    ATTR_UNIT,
     ATTR_VALUE,
     DOMAIN,
     PROGRAM_ENUM_OPTIONS,
-    SERVICE_OPTION_ACTIVE,
-    SERVICE_OPTION_SELECTED,
-    SERVICE_PAUSE_PROGRAM,
-    SERVICE_RESUME_PROGRAM,
-    SERVICE_SELECT_PROGRAM,
     SERVICE_SET_PROGRAM_AND_OPTIONS,
     SERVICE_SETTING,
-    SERVICE_START_PROGRAM,
     TRANSLATION_KEYS_PROGRAMS_MAP,
 )
 from .coordinator import HomeConnectConfigEntry
@@ -88,43 +79,6 @@ SERVICE_SETTING_SCHEMA = vol.Schema(
     }
 )
 
-# DEPRECATED: Remove in 2025.9.0
-SERVICE_OPTION_SCHEMA = vol.Schema(
-    {
-        vol.Required(ATTR_DEVICE_ID): str,
-        vol.Required(ATTR_KEY): vol.All(
-            vol.Coerce(OptionKey),
-            vol.NotIn([OptionKey.UNKNOWN]),
-        ),
-        vol.Required(ATTR_VALUE): vol.Any(str, int, bool),
-        vol.Optional(ATTR_UNIT): str,
-    }
-)
-
-# DEPRECATED: Remove in 2025.9.0
-SERVICE_PROGRAM_SCHEMA = vol.Any(
-    {
-        vol.Required(ATTR_DEVICE_ID): str,
-        vol.Required(ATTR_PROGRAM): vol.All(
-            vol.Coerce(ProgramKey),
-            vol.NotIn([ProgramKey.UNKNOWN]),
-        ),
-        vol.Required(ATTR_KEY): vol.All(
-            vol.Coerce(OptionKey),
-            vol.NotIn([OptionKey.UNKNOWN]),
-        ),
-        vol.Required(ATTR_VALUE): vol.Any(int, str),
-        vol.Optional(ATTR_UNIT): str,
-    },
-    {
-        vol.Required(ATTR_DEVICE_ID): str,
-        vol.Required(ATTR_PROGRAM): vol.All(
-            vol.Coerce(ProgramKey),
-            vol.NotIn([ProgramKey.UNKNOWN]),
-        ),
-    },
-)
-
 
 def _require_program_or_at_least_one_option(data: dict) -> dict:
     if ATTR_PROGRAM not in data and not any(
@@ -216,205 +170,6 @@ async def _get_client_and_ha_id(
     return entry.runtime_data.client, ha_id
 
 
-async def _async_service_program(call: ServiceCall, start: bool) -> None:
-    """Execute calls to services taking a program."""
-    program = call.data[ATTR_PROGRAM]
-    client, ha_id = await _get_client_and_ha_id(call.hass, call.data[ATTR_DEVICE_ID])
-
-    option_key = call.data.get(ATTR_KEY)
-    options = (
-        [
-            Option(
-                option_key,
-                call.data[ATTR_VALUE],
-                unit=call.data.get(ATTR_UNIT),
-            )
-        ]
-        if option_key is not None
-        else None
-    )
-
-    async_create_issue(
-        call.hass,
-        DOMAIN,
-        "deprecated_set_program_and_option_actions",
-        breaks_in_ha_version="2025.9.0",
-        is_fixable=True,
-        is_persistent=True,
-        severity=IssueSeverity.WARNING,
-        translation_key="deprecated_set_program_and_option_actions",
-        translation_placeholders={
-            "new_action_key": SERVICE_SET_PROGRAM_AND_OPTIONS,
-            "remove_release": "2025.9.0",
-            "deprecated_action_yaml": "\n".join(
-                [
-                    "```yaml",
-                    f"action: {DOMAIN}.{SERVICE_START_PROGRAM if start else SERVICE_SELECT_PROGRAM}",
-                    "data:",
-                    f"  {ATTR_DEVICE_ID}: DEVICE_ID",
-                    f"  {ATTR_PROGRAM}: {program}",
-                    *([f"  {ATTR_KEY}: {options[0].key}"] if options else []),
-                    *([f"  {ATTR_VALUE}: {options[0].value}"] if options else []),
-                    *(
-                        [f"  {ATTR_UNIT}: {options[0].unit}"]
-                        if options and options[0].unit
-                        else []
-                    ),
-                    "```",
-                ]
-            ),
-            "new_action_yaml": "\n  ".join(
-                [
-                    "```yaml",
-                    f"action: {DOMAIN}.{SERVICE_SET_PROGRAM_AND_OPTIONS}",
-                    "data:",
-                    f"  {ATTR_DEVICE_ID}: DEVICE_ID",
-                    f"  {ATTR_AFFECTS_TO}: {AFFECTS_TO_ACTIVE_PROGRAM if start else AFFECTS_TO_SELECTED_PROGRAM}",
-                    f"  {ATTR_PROGRAM}: {bsh_key_to_translation_key(program.value)}",
-                    *(
-                        [
-                            f"  {bsh_key_to_translation_key(options[0].key)}: {options[0].value}"
-                        ]
-                        if options
-                        else []
-                    ),
-                    "```",
-                ]
-            ),
-            "repo_link": "[aiohomeconnect](https://github.com/MartinHjelmare/aiohomeconnect)",
-        },
-    )
-
-    try:
-        if start:
-            await client.start_program(ha_id, program_key=program, options=options)
-        else:
-            await client.set_selected_program(
-                ha_id, program_key=program, options=options
-            )
-    except HomeConnectError as err:
-        raise HomeAssistantError(
-            translation_domain=DOMAIN,
-            translation_key="start_program" if start else "select_program",
-            translation_placeholders={
-                **get_dict_from_home_connect_error(err),
-                "program": program,
-            },
-        ) from err
-
-
-async def _async_service_set_program_options(call: ServiceCall, active: bool) -> None:
-    """Execute calls to services taking a program."""
-    option_key = call.data[ATTR_KEY]
-    value = call.data[ATTR_VALUE]
-    unit = call.data.get(ATTR_UNIT)
-    client, ha_id = await _get_client_and_ha_id(call.hass, call.data[ATTR_DEVICE_ID])
-
-    async_create_issue(
-        call.hass,
-        DOMAIN,
-        "deprecated_set_program_and_option_actions",
-        breaks_in_ha_version="2025.9.0",
-        is_fixable=True,
-        is_persistent=True,
-        severity=IssueSeverity.WARNING,
-        translation_key="deprecated_set_program_and_option_actions",
-        translation_placeholders={
-            "new_action_key": SERVICE_SET_PROGRAM_AND_OPTIONS,
-            "remove_release": "2025.9.0",
-            "deprecated_action_yaml": "\n".join(
-                [
-                    "```yaml",
-                    f"action: {DOMAIN}.{SERVICE_OPTION_ACTIVE if active else SERVICE_OPTION_SELECTED}",
-                    "data:",
-                    f"  {ATTR_DEVICE_ID}: DEVICE_ID",
-                    f"  {ATTR_KEY}: {option_key}",
-                    f"  {ATTR_VALUE}: {value}",
-                    *([f"  {ATTR_UNIT}: {unit}"] if unit else []),
-                    "```",
-                ]
-            ),
-            "new_action_yaml": "\n  ".join(
-                [
-                    "```yaml",
-                    f"action: {DOMAIN}.{SERVICE_SET_PROGRAM_AND_OPTIONS}",
-                    "data:",
-                    f"  {ATTR_DEVICE_ID}: DEVICE_ID",
-                    f"  {ATTR_AFFECTS_TO}: {AFFECTS_TO_ACTIVE_PROGRAM if active else AFFECTS_TO_SELECTED_PROGRAM}",
-                    f"  {bsh_key_to_translation_key(option_key)}: {value}",
-                    "```",
-                ]
-            ),
-            "repo_link": "[aiohomeconnect](https://github.com/MartinHjelmare/aiohomeconnect)",
-        },
-    )
-    try:
-        if active:
-            await client.set_active_program_option(
-                ha_id,
-                option_key=option_key,
-                value=value,
-                unit=unit,
-            )
-        else:
-            await client.set_selected_program_option(
-                ha_id,
-                option_key=option_key,
-                value=value,
-                unit=unit,
-            )
-    except HomeConnectError as err:
-        raise HomeAssistantError(
-            translation_domain=DOMAIN,
-            translation_key="set_options_active_program"
-            if active
-            else "set_options_selected_program",
-            translation_placeholders={
-                **get_dict_from_home_connect_error(err),
-                "key": option_key,
-                "value": str(value),
-            },
-        ) from err
-
-
-async def _async_service_command(call: ServiceCall, command_key: CommandKey) -> None:
-    """Execute calls to services executing a command."""
-    client, ha_id = await _get_client_and_ha_id(call.hass, call.data[ATTR_DEVICE_ID])
-
-    async_create_issue(
-        call.hass,
-        DOMAIN,
-        "deprecated_command_actions",
-        breaks_in_ha_version="2025.9.0",
-        is_fixable=True,
-        is_persistent=True,
-        severity=IssueSeverity.WARNING,
-        translation_key="deprecated_command_actions",
-    )
-
-    try:
-        await client.put_command(ha_id, command_key=command_key, value=True)
-    except HomeConnectError as err:
-        raise HomeAssistantError(
-            translation_domain=DOMAIN,
-            translation_key="execute_command",
-            translation_placeholders={
-                **get_dict_from_home_connect_error(err),
-                "command": command_key.value,
-            },
-        ) from err
-
-
-async def async_service_option_active(call: ServiceCall) -> None:
-    """Service for setting an option for an active program."""
-    await _async_service_set_program_options(call, True)
-
-
-async def async_service_option_selected(call: ServiceCall) -> None:
-    """Service for setting an option for a selected program."""
-    await _async_service_set_program_options(call, False)
-
-
 async def async_service_setting(call: ServiceCall) -> None:
     """Service for changing a setting."""
     key = call.data[ATTR_KEY]
@@ -435,21 +190,6 @@ async def async_service_setting(call: ServiceCall) -> None:
         ) from err
 
 
-async def async_service_pause_program(call: ServiceCall) -> None:
-    """Service for pausing a program."""
-    await _async_service_command(call, CommandKey.BSH_COMMON_PAUSE_PROGRAM)
-
-
-async def async_service_resume_program(call: ServiceCall) -> None:
-    """Service for resuming a paused program."""
-    await _async_service_command(call, CommandKey.BSH_COMMON_RESUME_PROGRAM)
-
-
-async def async_service_select_program(call: ServiceCall) -> None:
-    """Service for selecting a program."""
-    await _async_service_program(call, False)
-
-
 async def async_service_set_program_and_options(call: ServiceCall) -> None:
     """Service for setting a program and options."""
     data = dict(call.data)
@@ -517,54 +257,13 @@ async def async_service_set_program_and_options(call: ServiceCall) -> None:
         ) from err
 
 
-async def async_service_start_program(call: ServiceCall) -> None:
-    """Service for starting a program."""
-    await _async_service_program(call, True)
-
-
 @callback
 def async_setup_services(hass: HomeAssistant) -> None:
     """Register custom actions."""
 
-    hass.services.async_register(
-        DOMAIN,
-        SERVICE_OPTION_ACTIVE,
-        async_service_option_active,
-        schema=SERVICE_OPTION_SCHEMA,
-    )
-    hass.services.async_register(
-        DOMAIN,
-        SERVICE_OPTION_SELECTED,
-        async_service_option_selected,
-        schema=SERVICE_OPTION_SCHEMA,
-    )
     hass.services.async_register(
         DOMAIN, SERVICE_SETTING, async_service_setting, schema=SERVICE_SETTING_SCHEMA
     )
-    hass.services.async_register(
-        DOMAIN,
-        SERVICE_PAUSE_PROGRAM,
-        async_service_pause_program,
-        schema=SERVICE_COMMAND_SCHEMA,
-    )
-    hass.services.async_register(
-        DOMAIN,
-        SERVICE_RESUME_PROGRAM,
-        async_service_resume_program,
-        schema=SERVICE_COMMAND_SCHEMA,
-    )
-    hass.services.async_register(
-        DOMAIN,
-        SERVICE_SELECT_PROGRAM,
-        async_service_select_program,
-        schema=SERVICE_PROGRAM_SCHEMA,
-    )
-    hass.services.async_register(
-        DOMAIN,
-        SERVICE_START_PROGRAM,
-        async_service_start_program,
-        schema=SERVICE_PROGRAM_SCHEMA,
-    )
     hass.services.async_register(
         DOMAIN,
         SERVICE_SET_PROGRAM_AND_OPTIONS,

homeassistant/components/home_connect/services.yaml

@@ -1,51 +1,3 @@
-start_program:
-  fields:
-    device_id:
-      required: true
-      selector:
-        device:
-          integration: home_connect
-    program:
-      example: "Dishcare.Dishwasher.Program.Auto2"
-      required: true
-      selector:
-        text:
-    key:
-      example: "BSH.Common.Option.StartInRelative"
-      selector:
-        text:
-    value:
-      example: 1800
-      selector:
-        object:
-    unit:
-      example: "seconds"
-      selector:
-        text:
-select_program:
-  fields:
-    device_id:
-      required: true
-      selector:
-        device:
-          integration: home_connect
-    program:
-      example: "Dishcare.Dishwasher.Program.Auto2"
-      required: true
-      selector:
-        text:
-    key:
-      example: "BSH.Common.Option.StartInRelative"
-      selector:
-        text:
-    value:
-      example: 1800
-      selector:
-        object:
-    unit:
-      example: "seconds"
-      selector:
-        text:
 set_program_and_options:
   fields:
     device_id:
@@ -599,54 +551,6 @@ set_program_and_options:
                 - laundry_care_common_enum_type_vario_perfect_off
                 - laundry_care_common_enum_type_vario_perfect_eco_perfect
                 - laundry_care_common_enum_type_vario_perfect_speed_perfect
-pause_program:
-  fields:
-    device_id:
-      required: true
-      selector:
-        device:
-          integration: home_connect
-resume_program:
-  fields:
-    device_id:
-      required: true
-      selector:
-        device:
-          integration: home_connect
-set_option_active:
-  fields:
-    device_id:
-      required: true
-      selector:
-        device:
-          integration: home_connect
-    key:
-      example: "LaundryCare.Dryer.Option.DryingTarget"
-      required: true
-      selector:
-        text:
-    value:
-      example: "LaundryCare.Dryer.EnumType.DryingTarget.IronDry"
-      required: true
-      selector:
-        object:
-set_option_selected:
-  fields:
-    device_id:
-      required: true
-      selector:
-        device:
-          integration: home_connect
-    key:
-      example: "LaundryCare.Dryer.Option.DryingTarget"
-      required: true
-      selector:
-        text:
-    value:
-      example: "LaundryCare.Dryer.EnumType.DryingTarget.IronDry"
-      required: true
-      selector:
-        object:
 change_setting:
   fields:
     device_id:

homeassistant/components/home_connect/strings.json

@@ -145,28 +145,6 @@
           }
         }
       }
-    },
-    "deprecated_command_actions": {
-      "title": "The command related actions are deprecated in favor of the new buttons",
-      "fix_flow": {
-        "step": {
-          "confirm": {
-            "title": "[%key:component::home_connect::issues::deprecated_command_actions::title%]",
-            "description": "The `pause_program` and `resume_program` actions have been deprecated in favor of new button entities, if the command is available for your appliance. Please update your automations, scripts and panels that use this action to use the button entities instead, and press on submit to fix the issue."
-          }
-        }
-      }
-    },
-    "deprecated_set_program_and_option_actions": {
-      "title": "The executed action is deprecated",
-      "fix_flow": {
-        "step": {
-          "confirm": {
-            "title": "[%key:component::home_connect::issues::deprecated_set_program_and_option_actions::title%]",
-            "description": "`start_program`, `select_program`, `set_option_active`, and `set_option_selected` actions are deprecated and will be removed in the {remove_release} release, please use the `{new_action_key}` action instead. For the executed action:\n{deprecated_action_yaml}\nyou can do the following transformation using the recognized options:\n  {new_action_yaml}\nIf the option is not in the recognized options, please submit an issue or a pull request requesting the addition of the option at {repo_link}."
-          }
-        }
-      }
     }
   },
   "selector": {
@@ -517,49 +495,6 @@
     }
   },
   "services": {
-    "start_program": {
-      "name": "Start program",
-      "description": "Selects a program and starts it.",
-      "fields": {
-        "device_id": {
-          "name": "[%key:component::home_connect::services::set_program_and_options::fields::device_id::name%]",
-          "description": "[%key:component::home_connect::services::set_program_and_options::fields::device_id::description%]"
-        },
-        "program": { "name": "Program", "description": "Program to select." },
-        "key": { "name": "Option key", "description": "Key of the option." },
-        "value": {
-          "name": "Option value",
-          "description": "Value of the option."
-        },
-        "unit": { "name": "Option unit", "description": "Unit for the option." }
-      }
-    },
-    "select_program": {
-      "name": "Select program",
-      "description": "Selects a program without starting it.",
-      "fields": {
-        "device_id": {
-          "name": "[%key:component::home_connect::services::set_program_and_options::fields::device_id::name%]",
-          "description": "[%key:component::home_connect::services::set_program_and_options::fields::device_id::description%]"
-        },
-        "program": {
-          "name": "[%key:component::home_connect::services::start_program::fields::program::name%]",
-          "description": "[%key:component::home_connect::services::start_program::fields::program::description%]"
-        },
-        "key": {
-          "name": "[%key:component::home_connect::services::start_program::fields::key::name%]",
-          "description": "[%key:component::home_connect::services::start_program::fields::key::description%]"
-        },
-        "value": {
-          "name": "[%key:component::home_connect::services::start_program::fields::value::name%]",
-          "description": "[%key:component::home_connect::services::start_program::fields::value::description%]"
-        },
-        "unit": {
-          "name": "[%key:component::home_connect::services::start_program::fields::unit::name%]",
-          "description": "[%key:component::home_connect::services::start_program::fields::unit::description%]"
-        }
-      }
-    },
     "set_program_and_options": {
       "name": "Set program and options",
       "description": "Starts or selects a program with options or sets the options for the active or the selected program.",
@@ -744,62 +679,6 @@
         }
       }
     },
-    "pause_program": {
-      "name": "Pause program",
-      "description": "Pauses the current running program.",
-      "fields": {
-        "device_id": {
-          "name": "[%key:component::home_connect::services::set_program_and_options::fields::device_id::name%]",
-          "description": "[%key:component::home_connect::services::set_program_and_options::fields::device_id::description%]"
-        }
-      }
-    },
-    "resume_program": {
-      "name": "Resume program",
-      "description": "Resumes a paused program.",
-      "fields": {
-        "device_id": {
-          "name": "[%key:component::home_connect::services::set_program_and_options::fields::device_id::name%]",
-          "description": "[%key:component::home_connect::services::set_program_and_options::fields::device_id::description%]"
-        }
-      }
-    },
-    "set_option_active": {
-      "name": "Set active program option",
-      "description": "Sets an option for the active program.",
-      "fields": {
-        "device_id": {
-          "name": "[%key:component::home_connect::services::set_program_and_options::fields::device_id::name%]",
-          "description": "[%key:component::home_connect::services::set_program_and_options::fields::device_id::description%]"
-        },
-        "key": {
-          "name": "Key",
-          "description": "[%key:component::home_connect::services::start_program::fields::key::description%]"
-        },
-        "value": {
-          "name": "Value",
-          "description": "[%key:component::home_connect::services::start_program::fields::value::description%]"
-        }
-      }
-    },
-    "set_option_selected": {
-      "name": "Set selected program option",
-      "description": "Sets options for the selected program.",
-      "fields": {
-        "device_id": {
-          "name": "[%key:component::home_connect::services::set_program_and_options::fields::device_id::name%]",
-          "description": "[%key:component::home_connect::services::set_program_and_options::fields::device_id::description%]"
-        },
-        "key": {
-          "name": "[%key:component::home_connect::services::start_program::fields::key::name%]",
-          "description": "[%key:component::home_connect::services::start_program::fields::key::description%]"
-        },
-        "value": {
-          "name": "[%key:component::home_connect::services::start_program::fields::value::name%]",
-          "description": "[%key:component::home_connect::services::start_program::fields::value::description%]"
-        }
-      }
-    },
     "change_setting": {
       "name": "Change setting",
       "description": "Changes a setting.",

homeassistant/components/home_connect/translations/bg.json

@@ -491,35 +491,6 @@
                 }
             }
         },
-        "select_program": {
-            "fields": {
-                "key": {
-                    "description": "\u041a\u043b\u044e\u0447 \u043d\u0430 \u043e\u043f\u0446\u0438\u044f\u0442\u0430."
-                },
-                "program": {
-                    "name": "\u041f\u0440\u043e\u0433\u0440\u0430\u043c\u0430"
-                }
-            },
-            "name": "\u0418\u0437\u0431\u043e\u0440 \u043d\u0430 \u043f\u0440\u043e\u0433\u0440\u0430\u043c\u0430"
-        },
-        "set_option_active": {
-            "fields": {
-                "key": {
-                    "description": "\u041a\u043b\u044e\u0447 \u043d\u0430 \u043e\u043f\u0446\u0438\u044f\u0442\u0430.",
-                    "name": "\u041a\u043b\u044e\u0447"
-                },
-                "value": {
-                    "name": "\u0421\u0442\u043e\u0439\u043d\u043e\u0441\u0442"
-                }
-            }
-        },
-        "set_option_selected": {
-            "fields": {
-                "key": {
-                    "description": "\u041a\u043b\u044e\u0447 \u043d\u0430 \u043e\u043f\u0446\u0438\u044f\u0442\u0430."
-                }
-            }
-        },
         "set_program_and_options": {
             "fields": {
                 "b_s_h_common_option_duration": {
@@ -540,16 +511,6 @@
                 }
             },
             "name": "\u0417\u0430\u0434\u0430\u0432\u0430\u043d\u0435 \u043d\u0430 \u043f\u0440\u043e\u0433\u0440\u0430\u043c\u0430 \u0438 \u043e\u043f\u0446\u0438\u0438"
-        },
-        "start_program": {
-            "fields": {
-                "key": {
-                    "description": "\u041a\u043b\u044e\u0447 \u043d\u0430 \u043e\u043f\u0446\u0438\u044f\u0442\u0430."
-                },
-                "program": {
-                    "name": "\u041f\u0440\u043e\u0433\u0440\u0430\u043c\u0430"
-                }
-            }
         }
     }
 }