Files
core/tests/components/generic_hygrostat/test_init.py

616 lines
21 KiB
Python

"""Test Generic Hygrostat component setup process."""
from __future__ import annotations
from unittest.mock import patch
import pytest
from homeassistant.components import generic_hygrostat
from homeassistant.components.generic_hygrostat import DOMAIN
from homeassistant.components.generic_hygrostat.config_flow import ConfigFlowHandler
from homeassistant.config_entries import ConfigEntry, ConfigEntryState
from homeassistant.core import Event, HomeAssistant, callback
from homeassistant.helpers import device_registry as dr, entity_registry as er
from homeassistant.helpers.event import async_track_entity_registry_updated_event
from tests.common import MockConfigEntry
@pytest.fixture
def sensor_config_entry(hass: HomeAssistant) -> er.RegistryEntry:
"""Fixture to create a sensor config entry."""
sensor_config_entry = MockConfigEntry()
sensor_config_entry.add_to_hass(hass)
return sensor_config_entry
@pytest.fixture
def sensor_device(
device_registry: dr.DeviceRegistry, sensor_config_entry: ConfigEntry
) -> dr.DeviceEntry:
"""Fixture to create a sensor device."""
return device_registry.async_get_or_create(
config_entry_id=sensor_config_entry.entry_id,
connections={(dr.CONNECTION_NETWORK_MAC, "12:34:56:AB:CD:EE")},
)
@pytest.fixture
def sensor_entity_entry(
entity_registry: er.EntityRegistry,
sensor_config_entry: ConfigEntry,
sensor_device: dr.DeviceEntry,
) -> er.RegistryEntry:
"""Fixture to create a sensor entity entry."""
return entity_registry.async_get_or_create(
"sensor",
"test",
"unique",
config_entry=sensor_config_entry,
device_id=sensor_device.id,
original_name="ABC",
)
@pytest.fixture
def switch_config_entry(hass: HomeAssistant) -> er.RegistryEntry:
"""Fixture to create a switch config entry."""
switch_config_entry = MockConfigEntry()
switch_config_entry.add_to_hass(hass)
return switch_config_entry
@pytest.fixture
def switch_device(
device_registry: dr.DeviceRegistry, switch_config_entry: ConfigEntry
) -> dr.DeviceEntry:
"""Fixture to create a switch device."""
return device_registry.async_get_or_create(
config_entry_id=switch_config_entry.entry_id,
connections={(dr.CONNECTION_NETWORK_MAC, "12:34:56:AB:CD:EF")},
)
@pytest.fixture
def switch_entity_entry(
entity_registry: er.EntityRegistry,
switch_config_entry: ConfigEntry,
switch_device: dr.DeviceEntry,
) -> er.RegistryEntry:
"""Fixture to create a switch entity entry."""
return entity_registry.async_get_or_create(
"switch",
"test",
"unique",
config_entry=switch_config_entry,
device_id=switch_device.id,
original_name="ABC",
)
@pytest.fixture
def generic_hygrostat_config_entry(
hass: HomeAssistant,
sensor_entity_entry: er.RegistryEntry,
switch_entity_entry: er.RegistryEntry,
) -> MockConfigEntry:
"""Fixture to create a generic_hygrostat config entry."""
config_entry = MockConfigEntry(
data={},
domain=DOMAIN,
options={
"device_class": "humidifier",
"dry_tolerance": 2.0,
"humidifier": switch_entity_entry.entity_id,
"name": "My generic hygrostat",
"target_sensor": sensor_entity_entry.entity_id,
"wet_tolerance": 4.0,
},
title="My generic hygrostat",
version=ConfigFlowHandler.VERSION,
minor_version=ConfigFlowHandler.MINOR_VERSION,
)
config_entry.add_to_hass(hass)
return config_entry
@pytest.fixture
def expected_helper_device_id(
request: pytest.FixtureRequest,
switch_device: dr.DeviceEntry,
) -> str | None:
"""Fixture to provide the expected helper device ID."""
return switch_device.id if request.param == "switch_device_id" else None
def track_entity_registry_actions(hass: HomeAssistant, entity_id: str) -> list[str]:
"""Track entity registry actions for an entity."""
events = []
@callback
def add_event(event: Event[er.EventEntityRegistryUpdatedData]) -> None:
"""Add entity registry updated event to the list."""
events.append(event.data["action"])
async_track_entity_registry_updated_event(hass, entity_id, add_event)
return events
@pytest.mark.usefixtures(
"sensor_config_entry",
"sensor_device",
"sensor_entity_entry",
"switch_config_entry",
"switch_device",
)
@pytest.mark.parametrize(
("source_entity_id", "expected_helper_device_id", "expected_events"),
[
("switch.test_unique", None, ["update"]),
("sensor.test_unique", "switch_device_id", []),
],
indirect=["expected_helper_device_id"],
)
async def test_async_handle_source_entity_changes_source_entity_removed(
hass: HomeAssistant,
device_registry: dr.DeviceRegistry,
entity_registry: er.EntityRegistry,
generic_hygrostat_config_entry: MockConfigEntry,
switch_entity_entry: er.RegistryEntry,
source_entity_id: str,
expected_helper_device_id: str | None,
expected_events: list[str],
) -> None:
"""Test the generic_hygrostat config entry is removed when the source entity is removed."""
source_entity_entry = entity_registry.async_get(source_entity_id)
assert await hass.config_entries.async_setup(
generic_hygrostat_config_entry.entry_id
)
await hass.async_block_till_done()
generic_hygrostat_entity_entry = entity_registry.async_get(
"humidifier.my_generic_hygrostat"
)
assert generic_hygrostat_entity_entry.device_id == switch_entity_entry.device_id
source_device = device_registry.async_get(source_entity_entry.device_id)
assert generic_hygrostat_config_entry.entry_id not in source_device.config_entries
events = track_entity_registry_actions(
hass, generic_hygrostat_entity_entry.entity_id
)
# Remove the source entity's config entry from the device, this removes the
# source entity
with patch(
"homeassistant.components.generic_hygrostat.async_unload_entry",
wraps=generic_hygrostat.async_unload_entry,
) as mock_unload_entry:
device_registry.async_update_device(
source_device.id, remove_config_entry_id=source_entity_entry.config_entry_id
)
await hass.async_block_till_done()
await hass.async_block_till_done()
mock_unload_entry.assert_not_called()
# Check that the helper entity is linked to the expected source device
generic_hygrostat_entity_entry = entity_registry.async_get(
"humidifier.my_generic_hygrostat"
)
assert generic_hygrostat_entity_entry.device_id == expected_helper_device_id
# Check that the device is removed
assert not device_registry.async_get(source_device.id)
# Check that the generic_hygrostat config entry is not removed
assert (
generic_hygrostat_config_entry.entry_id in hass.config_entries.async_entry_ids()
)
# Check we got the expected events
assert events == expected_events
@pytest.mark.usefixtures(
"sensor_config_entry",
"sensor_device",
"sensor_entity_entry",
"switch_config_entry",
"switch_device",
)
@pytest.mark.parametrize(
("source_entity_id", "expected_helper_device_id", "expected_events"),
[
("switch.test_unique", None, ["update"]),
("sensor.test_unique", "switch_device_id", []),
],
indirect=["expected_helper_device_id"],
)
async def test_async_handle_source_entity_changes_source_entity_removed_shared_device(
hass: HomeAssistant,
device_registry: dr.DeviceRegistry,
entity_registry: er.EntityRegistry,
generic_hygrostat_config_entry: MockConfigEntry,
switch_entity_entry: er.RegistryEntry,
source_entity_id: str,
expected_helper_device_id: str | None,
expected_events: list[str],
) -> None:
"""Test the generic_hygrostat config entry is removed when the source entity is removed."""
source_entity_entry = entity_registry.async_get(source_entity_id)
# Add another config entry to the source device
other_config_entry = MockConfigEntry()
other_config_entry.add_to_hass(hass)
device_registry.async_update_device(
source_entity_entry.device_id, add_config_entry_id=other_config_entry.entry_id
)
assert await hass.config_entries.async_setup(
generic_hygrostat_config_entry.entry_id
)
await hass.async_block_till_done()
generic_hygrostat_entity_entry = entity_registry.async_get(
"humidifier.my_generic_hygrostat"
)
assert generic_hygrostat_entity_entry.device_id == switch_entity_entry.device_id
source_device = device_registry.async_get(source_entity_entry.device_id)
assert generic_hygrostat_config_entry.entry_id not in source_device.config_entries
events = track_entity_registry_actions(
hass, generic_hygrostat_entity_entry.entity_id
)
# Remove the source entity's config entry from the device, this removes the
# source entity
with patch(
"homeassistant.components.generic_hygrostat.async_unload_entry",
wraps=generic_hygrostat.async_unload_entry,
) as mock_unload_entry:
device_registry.async_update_device(
source_device.id, remove_config_entry_id=source_entity_entry.config_entry_id
)
await hass.async_block_till_done()
await hass.async_block_till_done()
mock_unload_entry.assert_not_called()
# Check that the helper entity is linked to the expected source device
switch_entity_entry = entity_registry.async_get("switch.test_unique")
generic_hygrostat_entity_entry = entity_registry.async_get(
"humidifier.my_generic_hygrostat"
)
assert generic_hygrostat_entity_entry.device_id == expected_helper_device_id
# Check if the generic_hygrostat config entry is not in the device
source_device = device_registry.async_get(source_device.id)
assert generic_hygrostat_config_entry.entry_id not in source_device.config_entries
# Check that the generic_hygrostat config entry is not removed
assert (
generic_hygrostat_config_entry.entry_id in hass.config_entries.async_entry_ids()
)
# Check we got the expected events
assert events == expected_events
@pytest.mark.usefixtures(
"sensor_config_entry",
"sensor_device",
"sensor_entity_entry",
"switch_config_entry",
"switch_device",
)
@pytest.mark.parametrize(
(
"source_entity_id",
"unload_entry_calls",
"expected_helper_device_id",
"expected_events",
),
[
("switch.test_unique", 1, None, ["update"]),
("sensor.test_unique", 0, "switch_device_id", []),
],
indirect=["expected_helper_device_id"],
)
async def test_async_handle_source_entity_changes_source_entity_removed_from_device(
hass: HomeAssistant,
device_registry: dr.DeviceRegistry,
entity_registry: er.EntityRegistry,
generic_hygrostat_config_entry: MockConfigEntry,
switch_entity_entry: er.RegistryEntry,
source_entity_id: str,
unload_entry_calls: int,
expected_helper_device_id: str | None,
expected_events: list[str],
) -> None:
"""Test the source entity removed from the source device."""
source_entity_entry = entity_registry.async_get(source_entity_id)
assert await hass.config_entries.async_setup(
generic_hygrostat_config_entry.entry_id
)
await hass.async_block_till_done()
generic_hygrostat_entity_entry = entity_registry.async_get(
"humidifier.my_generic_hygrostat"
)
assert generic_hygrostat_entity_entry.device_id == switch_entity_entry.device_id
source_device = device_registry.async_get(source_entity_entry.device_id)
assert generic_hygrostat_config_entry.entry_id not in source_device.config_entries
events = track_entity_registry_actions(
hass, generic_hygrostat_entity_entry.entity_id
)
# Remove the source entity from the device
with patch(
"homeassistant.components.generic_hygrostat.async_unload_entry",
wraps=generic_hygrostat.async_unload_entry,
) as mock_unload_entry:
entity_registry.async_update_entity(
source_entity_entry.entity_id, device_id=None
)
await hass.async_block_till_done()
assert len(mock_unload_entry.mock_calls) == unload_entry_calls
# Check that the helper entity is linked to the expected source device
generic_hygrostat_entity_entry = entity_registry.async_get(
"humidifier.my_generic_hygrostat"
)
assert generic_hygrostat_entity_entry.device_id == expected_helper_device_id
# Check that the generic_hygrostat config entry is not in the device
source_device = device_registry.async_get(source_device.id)
assert generic_hygrostat_config_entry.entry_id not in source_device.config_entries
# Check that the generic_hygrostat config entry is not removed
assert (
generic_hygrostat_config_entry.entry_id in hass.config_entries.async_entry_ids()
)
# Check we got the expected events
assert events == expected_events
@pytest.mark.usefixtures(
"sensor_config_entry",
"sensor_device",
"sensor_entity_entry",
"switch_config_entry",
"switch_device",
)
@pytest.mark.parametrize(
("source_entity_id", "unload_entry_calls", "expected_events"),
[("switch.test_unique", 1, ["update"]), ("sensor.test_unique", 0, [])],
)
async def test_async_handle_source_entity_changes_source_entity_moved_other_device(
hass: HomeAssistant,
device_registry: dr.DeviceRegistry,
entity_registry: er.EntityRegistry,
generic_hygrostat_config_entry: MockConfigEntry,
switch_entity_entry: er.RegistryEntry,
source_entity_id: str,
unload_entry_calls: int,
expected_events: list[str],
) -> None:
"""Test the source entity is moved to another device."""
source_entity_entry = entity_registry.async_get(source_entity_id)
source_device_2 = device_registry.async_get_or_create(
config_entry_id=source_entity_entry.config_entry_id,
connections={(dr.CONNECTION_NETWORK_MAC, "12:34:56:AB:CD:FF")},
)
assert await hass.config_entries.async_setup(
generic_hygrostat_config_entry.entry_id
)
await hass.async_block_till_done()
generic_hygrostat_entity_entry = entity_registry.async_get(
"humidifier.my_generic_hygrostat"
)
assert generic_hygrostat_entity_entry.device_id == switch_entity_entry.device_id
source_device = device_registry.async_get(source_entity_entry.device_id)
assert generic_hygrostat_config_entry.entry_id not in source_device.config_entries
source_device_2 = device_registry.async_get(source_device_2.id)
assert generic_hygrostat_config_entry.entry_id not in source_device_2.config_entries
events = track_entity_registry_actions(
hass, generic_hygrostat_entity_entry.entity_id
)
# Move the source entity to another device
with patch(
"homeassistant.components.generic_hygrostat.async_unload_entry",
wraps=generic_hygrostat.async_unload_entry,
) as mock_unload_entry:
entity_registry.async_update_entity(
source_entity_entry.entity_id, device_id=source_device_2.id
)
await hass.async_block_till_done()
assert len(mock_unload_entry.mock_calls) == unload_entry_calls
# Check that the helper entity is linked to the expected source device
switch_entity_entry = entity_registry.async_get(switch_entity_entry.entity_id)
generic_hygrostat_entity_entry = entity_registry.async_get(
"humidifier.my_generic_hygrostat"
)
assert generic_hygrostat_entity_entry.device_id == switch_entity_entry.device_id
# Check that the generic_hygrostat config entry is not in any of the devices
source_device = device_registry.async_get(source_device.id)
assert generic_hygrostat_config_entry.entry_id not in source_device.config_entries
source_device_2 = device_registry.async_get(source_device_2.id)
assert generic_hygrostat_config_entry.entry_id not in source_device_2.config_entries
# Check that the generic_hygrostat config entry is not removed
assert (
generic_hygrostat_config_entry.entry_id in hass.config_entries.async_entry_ids()
)
# Check we got the expected events
assert events == expected_events
@pytest.mark.usefixtures(
"sensor_config_entry",
"sensor_device",
"sensor_entity_entry",
"switch_config_entry",
"switch_device",
)
@pytest.mark.parametrize(
("source_entity_id", "new_entity_id", "config_key"),
[
("switch.test_unique", "switch.new_entity_id", "humidifier"),
("sensor.test_unique", "sensor.new_entity_id", "target_sensor"),
],
)
async def test_async_handle_source_entity_new_entity_id(
hass: HomeAssistant,
device_registry: dr.DeviceRegistry,
entity_registry: er.EntityRegistry,
generic_hygrostat_config_entry: MockConfigEntry,
switch_entity_entry: er.RegistryEntry,
source_entity_id: str,
new_entity_id: str,
config_key: str,
) -> None:
"""Test the source entity's entity ID is changed."""
source_entity_entry = entity_registry.async_get(source_entity_id)
assert await hass.config_entries.async_setup(
generic_hygrostat_config_entry.entry_id
)
await hass.async_block_till_done()
generic_hygrostat_entity_entry = entity_registry.async_get(
"humidifier.my_generic_hygrostat"
)
assert generic_hygrostat_entity_entry.device_id == switch_entity_entry.device_id
source_device = device_registry.async_get(source_entity_entry.device_id)
assert generic_hygrostat_config_entry.entry_id not in source_device.config_entries
events = track_entity_registry_actions(
hass, generic_hygrostat_entity_entry.entity_id
)
# Change the source entity's entity ID
with patch(
"homeassistant.components.generic_hygrostat.async_unload_entry",
wraps=generic_hygrostat.async_unload_entry,
) as mock_unload_entry:
entity_registry.async_update_entity(
source_entity_entry.entity_id, new_entity_id=new_entity_id
)
await hass.async_block_till_done()
mock_unload_entry.assert_called_once()
# Check that the generic_hygrostat config entry is updated with the new entity ID
assert generic_hygrostat_config_entry.options[config_key] == new_entity_id
# Check that the helper config is not in the device
source_device = device_registry.async_get(source_device.id)
assert generic_hygrostat_config_entry.entry_id not in source_device.config_entries
# Check that the generic_hygrostat config entry is not removed
assert (
generic_hygrostat_config_entry.entry_id in hass.config_entries.async_entry_ids()
)
# Check we got the expected events
assert events == []
@pytest.mark.usefixtures("sensor_device")
async def test_migration_1_1(
hass: HomeAssistant,
device_registry: dr.DeviceRegistry,
entity_registry: er.EntityRegistry,
sensor_entity_entry: er.RegistryEntry,
switch_device: dr.DeviceEntry,
switch_entity_entry: er.RegistryEntry,
) -> None:
"""Test migration from v1.1 removes generic_hygrostat config entry from device."""
generic_hygrostat_config_entry = MockConfigEntry(
data={},
domain=DOMAIN,
options={
"device_class": "humidifier",
"dry_tolerance": 2.0,
"humidifier": switch_entity_entry.entity_id,
"name": "My generic hygrostat",
"target_sensor": sensor_entity_entry.entity_id,
"wet_tolerance": 4.0,
},
title="My generic hygrostat",
version=1,
minor_version=1,
)
generic_hygrostat_config_entry.add_to_hass(hass)
# Add the helper config entry to the device
device_registry.async_update_device(
switch_device.id, add_config_entry_id=generic_hygrostat_config_entry.entry_id
)
# Check preconditions
switch_device = device_registry.async_get(switch_device.id)
assert generic_hygrostat_config_entry.entry_id in switch_device.config_entries
await hass.config_entries.async_setup(generic_hygrostat_config_entry.entry_id)
await hass.async_block_till_done()
assert generic_hygrostat_config_entry.state is ConfigEntryState.LOADED
# Check that the helper config entry is removed from the device and the helper
# entity is linked to the source device
switch_device = device_registry.async_get(switch_device.id)
assert generic_hygrostat_config_entry.entry_id not in switch_device.config_entries
generic_hygrostat_entity_entry = entity_registry.async_get(
"humidifier.my_generic_hygrostat"
)
assert generic_hygrostat_entity_entry.device_id == switch_entity_entry.device_id
assert generic_hygrostat_config_entry.version == 1
assert generic_hygrostat_config_entry.minor_version == 2
async def test_migration_from_future_version(
hass: HomeAssistant,
) -> None:
"""Test migration from future version."""
config_entry = MockConfigEntry(
data={},
domain=DOMAIN,
options={
"device_class": "humidifier",
"dry_tolerance": 2.0,
"humidifier": "switch.test",
"name": "My generic hygrostat",
"target_sensor": "sensor.test",
"wet_tolerance": 4.0,
},
title="My generic hygrostat",
version=2,
minor_version=1,
)
config_entry.add_to_hass(hass)
await hass.config_entries.async_setup(config_entry.entry_id)
await hass.async_block_till_done()
assert config_entry.state is ConfigEntryState.MIGRATION_ERROR