"""Test light conditions.""" from typing import Any import pytest from homeassistant.components.light import ATTR_BRIGHTNESS from homeassistant.const import STATE_OFF, STATE_ON from homeassistant.core import HomeAssistant from tests.components.common import ( ConditionStateDescription, assert_condition_behavior_all, assert_condition_behavior_any, assert_condition_gated_by_labs_flag, assert_condition_options_supported, parametrize_condition_states_all, parametrize_condition_states_any, parametrize_numerical_attribute_condition_above_below_all, parametrize_numerical_attribute_condition_above_below_any, parametrize_target_entities, target_entities, ) # Brightness is stored as a uint8 (0-255) but the threshold is in percent. _BRIGHTNESS_VALUE_SCALE = 255 / 100 @pytest.fixture async def target_lights(hass: HomeAssistant) -> dict[str, list[str]]: """Create multiple light entities associated with different targets.""" return await target_entities(hass, "light", domain_excluded="switch") @pytest.mark.parametrize( "condition", [ "light.is_brightness", "light.is_off", "light.is_on", ], ) async def test_light_conditions_gated_by_labs_flag( hass: HomeAssistant, caplog: pytest.LogCaptureFixture, condition: str ) -> None: """Test the light conditions are gated by the labs flag.""" await assert_condition_gated_by_labs_flag(hass, caplog, condition) _BRIGHTNESS_THRESHOLD = {"threshold": {"type": "above", "value": {"number": 50}}} @pytest.mark.usefixtures("enable_labs_preview_features") @pytest.mark.parametrize( ("condition_key", "base_options", "supports_behavior", "supports_duration"), [ ("light.is_off", {}, True, True), ("light.is_on", {}, True, True), ("light.is_brightness", _BRIGHTNESS_THRESHOLD, True, True), ], ) async def test_light_condition_options_validation( hass: HomeAssistant, condition_key: str, base_options: dict[str, Any] | None, supports_behavior: bool, supports_duration: bool, ) -> None: """Test that light conditions support the expected options.""" await assert_condition_options_supported( hass, condition_key, base_options, supports_behavior=supports_behavior, supports_duration=supports_duration, ) @pytest.mark.usefixtures("enable_labs_preview_features") @pytest.mark.parametrize( ("condition_target_config", "entity_id", "entities_in_target"), parametrize_target_entities("light"), ) @pytest.mark.parametrize( ("condition", "condition_options", "states"), [ *parametrize_condition_states_any( condition="light.is_on", target_states=[STATE_ON], other_states=[STATE_OFF], excluded_entities_from_other_domain=True, ), *parametrize_condition_states_any( condition="light.is_off", target_states=[STATE_OFF], other_states=[STATE_ON], excluded_entities_from_other_domain=True, ), ], ) async def test_light_state_condition_behavior_any( hass: HomeAssistant, target_lights: dict[str, list[str]], condition_target_config: dict, entity_id: str, entities_in_target: int, condition: str, condition_options: dict[str, Any], states: list[ConditionStateDescription], ) -> None: """Test the light state condition with the 'any' behavior.""" await assert_condition_behavior_any( hass, target_entities=target_lights, condition_target_config=condition_target_config, entity_id=entity_id, entities_in_target=entities_in_target, condition=condition, condition_options=condition_options, states=states, ) @pytest.mark.usefixtures("enable_labs_preview_features") @pytest.mark.parametrize( ("condition_target_config", "entity_id", "entities_in_target"), parametrize_target_entities("light"), ) @pytest.mark.parametrize( ("condition", "condition_options", "states"), [ *parametrize_condition_states_all( condition="light.is_on", target_states=[STATE_ON], other_states=[STATE_OFF], excluded_entities_from_other_domain=True, ), *parametrize_condition_states_all( condition="light.is_off", target_states=[STATE_OFF], other_states=[STATE_ON], excluded_entities_from_other_domain=True, ), ], ) async def test_light_state_condition_behavior_all( hass: HomeAssistant, target_lights: dict[str, list[str]], condition_target_config: dict, entity_id: str, entities_in_target: int, condition: str, condition_options: dict[str, Any], states: list[ConditionStateDescription], ) -> None: """Test the light state condition with the 'all' behavior.""" await assert_condition_behavior_all( hass, target_entities=target_lights, condition_target_config=condition_target_config, entity_id=entity_id, entities_in_target=entities_in_target, condition=condition, condition_options=condition_options, states=states, ) @pytest.mark.usefixtures("enable_labs_preview_features") @pytest.mark.parametrize( ("condition_target_config", "entity_id", "entities_in_target"), parametrize_target_entities("light"), ) @pytest.mark.parametrize( ("condition", "condition_options", "states"), [ *parametrize_numerical_attribute_condition_above_below_any( "light.is_brightness", STATE_ON, ATTR_BRIGHTNESS, attribute_value_scale=_BRIGHTNESS_VALUE_SCALE, ), ], ) async def test_light_brightness_condition_behavior_any( hass: HomeAssistant, target_lights: dict[str, list[str]], condition_target_config: dict, entity_id: str, entities_in_target: int, condition: str, condition_options: dict[str, Any], states: list[ConditionStateDescription], ) -> None: """Test the light brightness condition with the 'any' behavior.""" await assert_condition_behavior_any( hass, target_entities=target_lights, condition_target_config=condition_target_config, entity_id=entity_id, entities_in_target=entities_in_target, condition=condition, condition_options=condition_options, states=states, ) @pytest.mark.usefixtures("enable_labs_preview_features") @pytest.mark.parametrize( ("condition_target_config", "entity_id", "entities_in_target"), parametrize_target_entities("light"), ) @pytest.mark.parametrize( ("condition", "condition_options", "states"), [ *parametrize_numerical_attribute_condition_above_below_all( "light.is_brightness", STATE_ON, ATTR_BRIGHTNESS, attribute_value_scale=_BRIGHTNESS_VALUE_SCALE, ), ], ) async def test_light_brightness_condition_behavior_all( hass: HomeAssistant, target_lights: dict[str, list[str]], condition_target_config: dict, entity_id: str, entities_in_target: int, condition: str, condition_options: dict[str, Any], states: list[ConditionStateDescription], ) -> None: """Test the light brightness condition with the 'all' behavior.""" await assert_condition_behavior_all( hass, target_entities=target_lights, condition_target_config=condition_target_config, entity_id=entity_id, entities_in_target=entities_in_target, condition=condition, condition_options=condition_options, states=states, )