"""The tests for mqtt select component.""" import copy import json from unittest.mock import patch import pytest from homeassistant.components import mqtt, select from homeassistant.components.mqtt.select import MQTT_SELECT_ATTRIBUTES_BLOCKED from homeassistant.components.select import ( ATTR_OPTION, ATTR_OPTIONS, DOMAIN as SELECT_DOMAIN, SERVICE_SELECT_OPTION, ) from homeassistant.const import ( ATTR_ASSUMED_STATE, ATTR_ENTITY_ID, STATE_UNKNOWN, Platform, ) import homeassistant.core as ha from homeassistant.setup import async_setup_component from .test_common import ( help_test_availability_when_connection_lost, help_test_availability_without_topic, help_test_custom_availability_payload, help_test_default_availability_payload, help_test_discovery_broken, help_test_discovery_removal, help_test_discovery_update, help_test_discovery_update_attr, help_test_discovery_update_unchanged, help_test_encoding_subscribable_topics, help_test_entity_debug_info_message, help_test_entity_device_info_remove, help_test_entity_device_info_update, help_test_entity_device_info_with_connection, help_test_entity_device_info_with_identifier, help_test_entity_id_update_discovery_update, help_test_entity_id_update_subscriptions, help_test_publishing_with_custom_encoding, help_test_reloadable, help_test_reloadable_late, help_test_setting_attribute_via_mqtt_json_message, help_test_setting_attribute_with_template, help_test_setting_blocked_attribute_via_mqtt_json_message, help_test_setup_manual_entity_from_yaml, help_test_unique_id, help_test_unload_config_entry_with_platform, help_test_update_with_json_attrs_bad_json, help_test_update_with_json_attrs_not_dict, ) from tests.common import async_fire_mqtt_message, mock_restore_cache DEFAULT_CONFIG = { mqtt.DOMAIN: { select.DOMAIN: { "name": "test", "command_topic": "test-topic", "options": ["milk", "beer"], } } } # Test deprecated YAML configuration under the platform key # Scheduled to be removed in HA core 2022.12 DEFAULT_CONFIG_LEGACY = copy.deepcopy(DEFAULT_CONFIG[mqtt.DOMAIN]) DEFAULT_CONFIG_LEGACY[select.DOMAIN]["platform"] = mqtt.DOMAIN @pytest.fixture(autouse=True) def select_platform_only(): """Only setup the select platform to speed up tests.""" with patch("homeassistant.components.mqtt.PLATFORMS", [Platform.SELECT]): yield async def test_run_select_setup(hass, mqtt_mock_entry_with_yaml_config): """Test that it fetches the given payload.""" topic = "test/select" await async_setup_component( hass, mqtt.DOMAIN, { mqtt.DOMAIN: { select.DOMAIN: { "state_topic": topic, "command_topic": topic, "name": "Test Select", "options": ["milk", "beer"], } } }, ) await hass.async_block_till_done() await mqtt_mock_entry_with_yaml_config() async_fire_mqtt_message(hass, topic, "milk") await hass.async_block_till_done() state = hass.states.get("select.test_select") assert state.state == "milk" async_fire_mqtt_message(hass, topic, "beer") await hass.async_block_till_done() state = hass.states.get("select.test_select") assert state.state == "beer" async def test_value_template(hass, mqtt_mock_entry_with_yaml_config): """Test that it fetches the given payload with a template.""" topic = "test/select" await async_setup_component( hass, mqtt.DOMAIN, { mqtt.DOMAIN: { select.DOMAIN: { "state_topic": topic, "command_topic": topic, "name": "Test Select", "options": ["milk", "beer"], "value_template": "{{ value_json.val }}", } } }, ) await hass.async_block_till_done() await mqtt_mock_entry_with_yaml_config() async_fire_mqtt_message(hass, topic, '{"val":"milk"}') await hass.async_block_till_done() state = hass.states.get("select.test_select") assert state.state == "milk" async_fire_mqtt_message(hass, topic, '{"val":"beer"}') await hass.async_block_till_done() state = hass.states.get("select.test_select") assert state.state == "beer" async_fire_mqtt_message(hass, topic, '{"val": null}') await hass.async_block_till_done() state = hass.states.get("select.test_select") assert state.state == STATE_UNKNOWN async def test_run_select_service_optimistic(hass, mqtt_mock_entry_with_yaml_config): """Test that set_value service works in optimistic mode.""" topic = "test/select" fake_state = ha.State("select.test_select", "milk") mock_restore_cache(hass, (fake_state,)) assert await async_setup_component( hass, mqtt.DOMAIN, { mqtt.DOMAIN: { select.DOMAIN: { "command_topic": topic, "name": "Test Select", "options": ["milk", "beer"], } } }, ) await hass.async_block_till_done() mqtt_mock = await mqtt_mock_entry_with_yaml_config() state = hass.states.get("select.test_select") assert state.state == "milk" assert state.attributes.get(ATTR_ASSUMED_STATE) await hass.services.async_call( SELECT_DOMAIN, SERVICE_SELECT_OPTION, {ATTR_ENTITY_ID: "select.test_select", ATTR_OPTION: "beer"}, blocking=True, ) mqtt_mock.async_publish.assert_called_once_with(topic, "beer", 0, False) mqtt_mock.async_publish.reset_mock() state = hass.states.get("select.test_select") assert state.state == "beer" async def test_run_select_service_optimistic_with_command_template( hass, mqtt_mock_entry_with_yaml_config ): """Test that set_value service works in optimistic mode and with a command_template.""" topic = "test/select" fake_state = ha.State("select.test_select", "milk") mock_restore_cache(hass, (fake_state,)) assert await async_setup_component( hass, mqtt.DOMAIN, { mqtt.DOMAIN: { select.DOMAIN: { "command_topic": topic, "name": "Test Select", "options": ["milk", "beer"], "command_template": '{"option": "{{ value }}"}', } } }, ) await hass.async_block_till_done() mqtt_mock = await mqtt_mock_entry_with_yaml_config() state = hass.states.get("select.test_select") assert state.state == "milk" assert state.attributes.get(ATTR_ASSUMED_STATE) await hass.services.async_call( SELECT_DOMAIN, SERVICE_SELECT_OPTION, {ATTR_ENTITY_ID: "select.test_select", ATTR_OPTION: "beer"}, blocking=True, ) mqtt_mock.async_publish.assert_called_once_with( topic, '{"option": "beer"}', 0, False ) mqtt_mock.async_publish.reset_mock() state = hass.states.get("select.test_select") assert state.state == "beer" async def test_run_select_service(hass, mqtt_mock_entry_with_yaml_config): """Test that set_value service works in non optimistic mode.""" cmd_topic = "test/select/set" state_topic = "test/select" assert await async_setup_component( hass, mqtt.DOMAIN, { mqtt.DOMAIN: { select.DOMAIN: { "command_topic": cmd_topic, "state_topic": state_topic, "name": "Test Select", "options": ["milk", "beer"], } } }, ) await hass.async_block_till_done() mqtt_mock = await mqtt_mock_entry_with_yaml_config() async_fire_mqtt_message(hass, state_topic, "beer") state = hass.states.get("select.test_select") assert state.state == "beer" await hass.services.async_call( SELECT_DOMAIN, SERVICE_SELECT_OPTION, {ATTR_ENTITY_ID: "select.test_select", ATTR_OPTION: "milk"}, blocking=True, ) mqtt_mock.async_publish.assert_called_once_with(cmd_topic, "milk", 0, False) state = hass.states.get("select.test_select") assert state.state == "beer" async def test_run_select_service_with_command_template( hass, mqtt_mock_entry_with_yaml_config ): """Test that set_value service works in non optimistic mode and with a command_template.""" cmd_topic = "test/select/set" state_topic = "test/select" assert await async_setup_component( hass, mqtt.DOMAIN, { mqtt.DOMAIN: { select.DOMAIN: { "command_topic": cmd_topic, "state_topic": state_topic, "name": "Test Select", "options": ["milk", "beer"], "command_template": '{"option": "{{ value }}"}', } } }, ) await hass.async_block_till_done() mqtt_mock = await mqtt_mock_entry_with_yaml_config() async_fire_mqtt_message(hass, state_topic, "beer") state = hass.states.get("select.test_select") assert state.state == "beer" await hass.services.async_call( SELECT_DOMAIN, SERVICE_SELECT_OPTION, {ATTR_ENTITY_ID: "select.test_select", ATTR_OPTION: "milk"}, blocking=True, ) mqtt_mock.async_publish.assert_called_once_with( cmd_topic, '{"option": "milk"}', 0, False ) async def test_availability_when_connection_lost( hass, mqtt_mock_entry_with_yaml_config ): """Test availability after MQTT disconnection.""" await help_test_availability_when_connection_lost( hass, mqtt_mock_entry_with_yaml_config, select.DOMAIN, DEFAULT_CONFIG ) async def test_availability_without_topic(hass, mqtt_mock_entry_with_yaml_config): """Test availability without defined availability topic.""" await help_test_availability_without_topic( hass, mqtt_mock_entry_with_yaml_config, select.DOMAIN, DEFAULT_CONFIG ) async def test_default_availability_payload(hass, mqtt_mock_entry_with_yaml_config): """Test availability by default payload with defined topic.""" await help_test_default_availability_payload( hass, mqtt_mock_entry_with_yaml_config, select.DOMAIN, DEFAULT_CONFIG ) async def test_custom_availability_payload(hass, mqtt_mock_entry_with_yaml_config): """Test availability by custom payload with defined topic.""" await help_test_custom_availability_payload( hass, mqtt_mock_entry_with_yaml_config, select.DOMAIN, DEFAULT_CONFIG ) async def test_setting_attribute_via_mqtt_json_message( hass, mqtt_mock_entry_with_yaml_config ): """Test the setting of attribute via MQTT with JSON payload.""" await help_test_setting_attribute_via_mqtt_json_message( hass, mqtt_mock_entry_with_yaml_config, select.DOMAIN, DEFAULT_CONFIG ) async def test_setting_blocked_attribute_via_mqtt_json_message( hass, mqtt_mock_entry_no_yaml_config ): """Test the setting of attribute via MQTT with JSON payload.""" await help_test_setting_blocked_attribute_via_mqtt_json_message( hass, mqtt_mock_entry_no_yaml_config, select.DOMAIN, DEFAULT_CONFIG, MQTT_SELECT_ATTRIBUTES_BLOCKED, ) async def test_setting_attribute_with_template(hass, mqtt_mock_entry_with_yaml_config): """Test the setting of attribute via MQTT with JSON payload.""" await help_test_setting_attribute_with_template( hass, mqtt_mock_entry_with_yaml_config, select.DOMAIN, DEFAULT_CONFIG ) async def test_update_with_json_attrs_not_dict( hass, mqtt_mock_entry_with_yaml_config, caplog ): """Test attributes get extracted from a JSON result.""" await help_test_update_with_json_attrs_not_dict( hass, mqtt_mock_entry_with_yaml_config, caplog, select.DOMAIN, DEFAULT_CONFIG, ) async def test_update_with_json_attrs_bad_json( hass, mqtt_mock_entry_with_yaml_config, caplog ): """Test attributes get extracted from a JSON result.""" await help_test_update_with_json_attrs_bad_json( hass, mqtt_mock_entry_with_yaml_config, caplog, select.DOMAIN, DEFAULT_CONFIG, ) async def test_discovery_update_attr(hass, mqtt_mock_entry_no_yaml_config, caplog): """Test update of discovered MQTTAttributes.""" await help_test_discovery_update_attr( hass, mqtt_mock_entry_no_yaml_config, caplog, select.DOMAIN, DEFAULT_CONFIG, ) async def test_unique_id(hass, mqtt_mock_entry_with_yaml_config): """Test unique id option only creates one select per unique_id.""" config = { mqtt.DOMAIN: { select.DOMAIN: [ { "name": "Test 1", "state_topic": "test-topic", "command_topic": "test-topic", "unique_id": "TOTALLY_UNIQUE", "options": ["milk", "beer"], }, { "name": "Test 2", "state_topic": "test-topic", "command_topic": "test-topic", "unique_id": "TOTALLY_UNIQUE", "options": ["milk", "beer"], }, ] } } await help_test_unique_id( hass, mqtt_mock_entry_with_yaml_config, select.DOMAIN, config ) async def test_discovery_removal_select(hass, mqtt_mock_entry_no_yaml_config, caplog): """Test removal of discovered select.""" data = json.dumps(DEFAULT_CONFIG[mqtt.DOMAIN][select.DOMAIN]) await help_test_discovery_removal( hass, mqtt_mock_entry_no_yaml_config, caplog, select.DOMAIN, data ) async def test_discovery_update_select(hass, mqtt_mock_entry_no_yaml_config, caplog): """Test update of discovered select.""" config1 = { "name": "Beer", "state_topic": "test-topic", "command_topic": "test-topic", "options": ["milk", "beer"], } config2 = { "name": "Milk", "state_topic": "test-topic", "command_topic": "test-topic", "options": ["milk", "beer"], } await help_test_discovery_update( hass, mqtt_mock_entry_no_yaml_config, caplog, select.DOMAIN, config1, config2 ) async def test_discovery_update_unchanged_select( hass, mqtt_mock_entry_no_yaml_config, caplog ): """Test update of discovered select.""" data1 = '{ "name": "Beer", "state_topic": "test-topic", "command_topic": "test-topic", "options": ["milk", "beer"]}' with patch( "homeassistant.components.mqtt.select.MqttSelect.discovery_update" ) as discovery_update: await help_test_discovery_update_unchanged( hass, mqtt_mock_entry_no_yaml_config, caplog, select.DOMAIN, data1, discovery_update, ) @pytest.mark.no_fail_on_log_exception async def test_discovery_broken(hass, mqtt_mock_entry_no_yaml_config, caplog): """Test handling of bad discovery message.""" data1 = '{ "name": "Beer" }' data2 = '{ "name": "Milk", "state_topic": "test-topic", "command_topic": "test-topic", "options": ["milk", "beer"]}' await help_test_discovery_broken( hass, mqtt_mock_entry_no_yaml_config, caplog, select.DOMAIN, data1, data2 ) async def test_entity_device_info_with_connection(hass, mqtt_mock_entry_no_yaml_config): """Test MQTT select device registry integration.""" await help_test_entity_device_info_with_connection( hass, mqtt_mock_entry_no_yaml_config, select.DOMAIN, DEFAULT_CONFIG ) async def test_entity_device_info_with_identifier(hass, mqtt_mock_entry_no_yaml_config): """Test MQTT select device registry integration.""" await help_test_entity_device_info_with_identifier( hass, mqtt_mock_entry_no_yaml_config, select.DOMAIN, DEFAULT_CONFIG ) async def test_entity_device_info_update(hass, mqtt_mock_entry_no_yaml_config): """Test device registry update.""" await help_test_entity_device_info_update( hass, mqtt_mock_entry_no_yaml_config, select.DOMAIN, DEFAULT_CONFIG ) async def test_entity_device_info_remove(hass, mqtt_mock_entry_no_yaml_config): """Test device registry remove.""" await help_test_entity_device_info_remove( hass, mqtt_mock_entry_no_yaml_config, select.DOMAIN, DEFAULT_CONFIG ) async def test_entity_id_update_subscriptions(hass, mqtt_mock_entry_with_yaml_config): """Test MQTT subscriptions are managed when entity_id is updated.""" await help_test_entity_id_update_subscriptions( hass, mqtt_mock_entry_with_yaml_config, select.DOMAIN, DEFAULT_CONFIG ) async def test_entity_id_update_discovery_update(hass, mqtt_mock_entry_no_yaml_config): """Test MQTT discovery update when entity_id is updated.""" await help_test_entity_id_update_discovery_update( hass, mqtt_mock_entry_no_yaml_config, select.DOMAIN, DEFAULT_CONFIG ) async def test_entity_debug_info_message(hass, mqtt_mock_entry_no_yaml_config): """Test MQTT debug info.""" await help_test_entity_debug_info_message( hass, mqtt_mock_entry_no_yaml_config, select.DOMAIN, DEFAULT_CONFIG, select.SERVICE_SELECT_OPTION, service_parameters={ATTR_OPTION: "beer"}, command_payload="beer", state_payload="milk", ) @pytest.mark.parametrize("options", [["milk", "beer"], ["milk"], []]) async def test_options_attributes(hass, mqtt_mock_entry_with_yaml_config, options): """Test options attribute.""" topic = "test/select" await async_setup_component( hass, mqtt.DOMAIN, { mqtt.DOMAIN: { select.DOMAIN: { "state_topic": topic, "command_topic": topic, "name": "Test select", "options": options, } } }, ) await hass.async_block_till_done() await mqtt_mock_entry_with_yaml_config() state = hass.states.get("select.test_select") assert state.attributes.get(ATTR_OPTIONS) == options async def test_mqtt_payload_not_an_option_warning( hass, caplog, mqtt_mock_entry_with_yaml_config ): """Test warning for MQTT payload which is not a valid option.""" topic = "test/select" await async_setup_component( hass, mqtt.DOMAIN, { mqtt.DOMAIN: { select.DOMAIN: { "state_topic": topic, "command_topic": topic, "name": "Test Select", "options": ["milk", "beer"], } } }, ) await hass.async_block_till_done() await mqtt_mock_entry_with_yaml_config() async_fire_mqtt_message(hass, topic, "öl") await hass.async_block_till_done() assert ( "Invalid option for select.test_select: 'öl' (valid options: ['milk', 'beer'])" in caplog.text ) @pytest.mark.parametrize( "service,topic,parameters,payload,template", [ ( select.SERVICE_SELECT_OPTION, "command_topic", {"option": "beer"}, "beer", "command_template", ), ], ) async def test_publishing_with_custom_encoding( hass, mqtt_mock_entry_with_yaml_config, caplog, service, topic, parameters, payload, template, ): """Test publishing MQTT payload with different encoding.""" domain = select.DOMAIN config = DEFAULT_CONFIG config[mqtt.DOMAIN][domain]["options"] = ["milk", "beer"] await help_test_publishing_with_custom_encoding( hass, mqtt_mock_entry_with_yaml_config, caplog, domain, config, service, topic, parameters, payload, template, ) async def test_reloadable(hass, mqtt_mock_entry_with_yaml_config, caplog, tmp_path): """Test reloading the MQTT platform.""" domain = select.DOMAIN config = DEFAULT_CONFIG await help_test_reloadable( hass, mqtt_mock_entry_with_yaml_config, caplog, tmp_path, domain, config ) # Test deprecated YAML configuration under the platform key # Scheduled to be removed in HA core 2022.12 async def test_reloadable_late(hass, mqtt_client_mock, caplog, tmp_path): """Test reloading the MQTT platform with late entry setup.""" domain = select.DOMAIN config = DEFAULT_CONFIG_LEGACY[domain] await help_test_reloadable_late(hass, caplog, tmp_path, domain, config) @pytest.mark.parametrize( "topic,value,attribute,attribute_value", [ ("state_topic", "milk", None, "milk"), ("state_topic", "beer", None, "beer"), ], ) async def test_encoding_subscribable_topics( hass, mqtt_mock_entry_with_yaml_config, caplog, topic, value, attribute, attribute_value, ): """Test handling of incoming encoded payload.""" config = copy.deepcopy(DEFAULT_CONFIG[mqtt.DOMAIN][select.DOMAIN]) config["options"] = ["milk", "beer"] await help_test_encoding_subscribable_topics( hass, mqtt_mock_entry_with_yaml_config, caplog, select.DOMAIN, config, topic, value, attribute, attribute_value, ) async def test_setup_manual_entity_from_yaml(hass): """Test setup manual configured MQTT entity.""" platform = select.DOMAIN await help_test_setup_manual_entity_from_yaml(hass, DEFAULT_CONFIG) assert hass.states.get(f"{platform}.test") async def test_unload_entry(hass, mqtt_mock_entry_with_yaml_config, tmp_path): """Test unloading the config entry.""" domain = select.DOMAIN config = DEFAULT_CONFIG await help_test_unload_config_entry_with_platform( hass, mqtt_mock_entry_with_yaml_config, tmp_path, domain, config ) # Test deprecated YAML configuration under the platform key # Scheduled to be removed in HA core 2022.12 async def test_setup_with_legacy_schema(hass, mqtt_mock_entry_with_yaml_config): """Test a setup with deprecated yaml platform schema.""" domain = select.DOMAIN config = copy.deepcopy(DEFAULT_CONFIG_LEGACY[domain]) config["name"] = "test" assert await async_setup_component(hass, domain, {domain: config}) await hass.async_block_till_done() await mqtt_mock_entry_with_yaml_config() assert hass.states.get(f"{domain}.test") is not None