"""Provides device actions for lights.""" from __future__ import annotations import voluptuous as vol from homeassistant.components.device_automation import toggle_entity from homeassistant.const import ( ATTR_ENTITY_ID, CONF_DEVICE_ID, CONF_DOMAIN, CONF_ENTITY_ID, CONF_TYPE, SERVICE_TURN_ON, ) from homeassistant.core import Context, HomeAssistant, HomeAssistantError from homeassistant.helpers import config_validation as cv, entity_registry as er from homeassistant.helpers.entity import get_supported_features from homeassistant.helpers.typing import ConfigType, TemplateVarsType from . import ( ATTR_BRIGHTNESS_PCT, ATTR_BRIGHTNESS_STEP_PCT, ATTR_FLASH, DOMAIN, FLASH_SHORT, SUPPORT_FLASH, VALID_BRIGHTNESS_PCT, VALID_FLASH, brightness_supported, get_supported_color_modes, ) # mypy: disallow-any-generics TYPE_BRIGHTNESS_INCREASE = "brightness_increase" TYPE_BRIGHTNESS_DECREASE = "brightness_decrease" TYPE_FLASH = "flash" ACTION_SCHEMA = cv.DEVICE_ACTION_BASE_SCHEMA.extend( { vol.Required(ATTR_ENTITY_ID): cv.entity_id, vol.Required(CONF_DOMAIN): DOMAIN, vol.Required(CONF_TYPE): vol.In( toggle_entity.DEVICE_ACTION_TYPES + [TYPE_BRIGHTNESS_INCREASE, TYPE_BRIGHTNESS_DECREASE, TYPE_FLASH] ), vol.Optional(ATTR_BRIGHTNESS_PCT): VALID_BRIGHTNESS_PCT, vol.Optional(ATTR_FLASH): VALID_FLASH, } ) async def async_call_action_from_config( hass: HomeAssistant, config: ConfigType, variables: TemplateVarsType, context: Context, ) -> None: """Change state based on configuration.""" if ( config[CONF_TYPE] in toggle_entity.DEVICE_ACTION_TYPES and config[CONF_TYPE] != toggle_entity.CONF_TURN_ON ): await toggle_entity.async_call_action_from_config( hass, config, variables, context, DOMAIN ) return data = {ATTR_ENTITY_ID: config[ATTR_ENTITY_ID]} if config[CONF_TYPE] == TYPE_BRIGHTNESS_INCREASE: data[ATTR_BRIGHTNESS_STEP_PCT] = 10 elif config[CONF_TYPE] == TYPE_BRIGHTNESS_DECREASE: data[ATTR_BRIGHTNESS_STEP_PCT] = -10 elif ATTR_BRIGHTNESS_PCT in config: data[ATTR_BRIGHTNESS_PCT] = config[ATTR_BRIGHTNESS_PCT] if config[CONF_TYPE] == TYPE_FLASH: if ATTR_FLASH in config: data[ATTR_FLASH] = config[ATTR_FLASH] else: data[ATTR_FLASH] = FLASH_SHORT await hass.services.async_call( DOMAIN, SERVICE_TURN_ON, data, blocking=True, context=context ) async def async_get_actions( hass: HomeAssistant, device_id: str ) -> list[dict[str, str]]: """List device actions.""" actions = await toggle_entity.async_get_actions(hass, device_id, DOMAIN) entity_registry = er.async_get(hass) for entry in er.async_entries_for_device(entity_registry, device_id): if entry.domain != DOMAIN: continue supported_color_modes = get_supported_color_modes(hass, entry.entity_id) supported_features = get_supported_features(hass, entry.entity_id) base_action = { CONF_DEVICE_ID: device_id, CONF_DOMAIN: DOMAIN, CONF_ENTITY_ID: entry.entity_id, } if brightness_supported(supported_color_modes): actions.extend( ( {**base_action, CONF_TYPE: TYPE_BRIGHTNESS_INCREASE}, {**base_action, CONF_TYPE: TYPE_BRIGHTNESS_DECREASE}, ) ) if supported_features & SUPPORT_FLASH: actions.append({**base_action, CONF_TYPE: TYPE_FLASH}) return actions async def async_get_action_capabilities( hass: HomeAssistant, config: ConfigType ) -> dict[str, vol.Schema]: """List action capabilities.""" if config[CONF_TYPE] != toggle_entity.CONF_TURN_ON: return {} try: supported_color_modes = get_supported_color_modes(hass, config[ATTR_ENTITY_ID]) except HomeAssistantError: supported_color_modes = None try: supported_features = get_supported_features(hass, config[ATTR_ENTITY_ID]) except HomeAssistantError: supported_features = 0 extra_fields = {} if brightness_supported(supported_color_modes): extra_fields[vol.Optional(ATTR_BRIGHTNESS_PCT)] = VALID_BRIGHTNESS_PCT if supported_features & SUPPORT_FLASH: extra_fields[vol.Optional(ATTR_FLASH)] = VALID_FLASH return {"extra_fields": vol.Schema(extra_fields)} if extra_fields else {}