core/tests/components/zimi/test_config_flow.py

376 lines
11 KiB
Python

"""Tests for the zimi config flow."""
from unittest.mock import MagicMock, patch
import pytest
from zcc import (
ControlPointCannotConnectError,
ControlPointConnectionRefusedError,
ControlPointDescription,
ControlPointError,
ControlPointInvalidHostError,
ControlPointTimeoutError,
)
from homeassistant import config_entries
from homeassistant.components.zimi.const import DOMAIN
from homeassistant.const import CONF_HOST, CONF_PORT
from homeassistant.core import HomeAssistant
from homeassistant.data_entry_flow import FlowResultType
from homeassistant.helpers.device_registry import format_mac
from tests.common import MockConfigEntry
INPUT_MAC = "aa:bb:cc:dd:ee:ff"
INPUT_MAC_EXTRA = "aa:bb:cc:dd:ee:ee"
INPUT_HOST = "192.168.1.100"
INPUT_HOST_EXTRA = "192.168.1.101"
INPUT_PORT = 5003
INPUT_PORT_EXTRA = 5004
INVALID_INPUT_MAC = "xyz"
MISMATCHED_INPUT_MAC = "aa:bb:cc:dd:ee:ee"
SELECTED_HOST_AND_PORT = "selected_host_and_port"
@pytest.fixture
def discovery_mock():
"""Mock the ControlPointDiscoveryService."""
with patch(
"homeassistant.components.zimi.config_flow.ControlPointDiscoveryService",
autospec=True,
) as mock:
mock.return_value = mock
yield mock
async def test_user_discovery_success(
hass: HomeAssistant,
discovery_mock: MagicMock,
) -> None:
"""Test user form transitions to creation if zcc discovery succeeds."""
discovery_mock.discovers.return_value = [
ControlPointDescription(host=INPUT_HOST, port=INPUT_PORT)
]
discovery_mock.return_value.validate_connection.return_value = (
ControlPointDescription(host=INPUT_HOST, port=INPUT_PORT, mac=INPUT_MAC)
)
result = await hass.config_entries.flow.async_init(
DOMAIN, context={"source": config_entries.SOURCE_USER}
)
assert result["type"] is FlowResultType.CREATE_ENTRY
assert result["context"] == {
"source": config_entries.SOURCE_USER,
"unique_id": INPUT_MAC,
}
assert result["data"] == {
"host": INPUT_HOST,
"port": INPUT_PORT,
"mac": format_mac(INPUT_MAC),
}
async def test_user_discovery_success_selection(
hass: HomeAssistant,
discovery_mock: MagicMock,
) -> None:
"""Test user form transitions via selection to creation if zcc discovery succeeds has multiple hosts."""
discovery_mock.discovers.return_value = [
ControlPointDescription(host=INPUT_HOST, port=INPUT_PORT),
ControlPointDescription(host=INPUT_HOST_EXTRA, port=INPUT_PORT_EXTRA),
]
result = await hass.config_entries.flow.async_init(
DOMAIN, context={"source": config_entries.SOURCE_USER}
)
assert result["type"] is FlowResultType.FORM
assert result["step_id"] == "selection"
assert result["errors"] == {}
discovery_mock.return_value.validate_connection.return_value = (
ControlPointDescription(
host=INPUT_HOST_EXTRA, port=INPUT_PORT_EXTRA, mac=INPUT_MAC_EXTRA
)
)
result = await hass.config_entries.flow.async_configure(
result["flow_id"],
{
SELECTED_HOST_AND_PORT: f"{INPUT_HOST_EXTRA}:{INPUT_PORT_EXTRA!s}",
},
)
assert result["type"] is FlowResultType.CREATE_ENTRY
assert result["data"] == {
"host": INPUT_HOST_EXTRA,
"port": INPUT_PORT_EXTRA,
"mac": format_mac(INPUT_MAC_EXTRA),
}
async def test_user_discovery_duplicates(
hass: HomeAssistant,
discovery_mock: MagicMock,
) -> None:
"""Test that flow is aborted if duplicates are added."""
MockConfigEntry(
domain=DOMAIN,
unique_id=INPUT_MAC,
data={
CONF_HOST: INPUT_HOST,
CONF_PORT: INPUT_PORT,
"mac": format_mac(INPUT_MAC),
},
).add_to_hass(hass)
discovery_mock.discovers.return_value = [
ControlPointDescription(host=INPUT_HOST, port=INPUT_PORT)
]
discovery_mock.return_value.validate_connection.return_value = (
ControlPointDescription(host=INPUT_HOST, port=INPUT_PORT, mac=INPUT_MAC)
)
result = await hass.config_entries.flow.async_init(
DOMAIN, context={"source": config_entries.SOURCE_USER}
)
assert result["type"] is FlowResultType.ABORT
assert result["reason"] == "already_configured"
async def test_finish_manual_success(
hass: HomeAssistant,
discovery_mock: MagicMock,
) -> None:
"""Test manual form transitions to creation with valid data."""
discovery_mock.discovers.side_effect = ControlPointError("Discovery failed")
discovery_mock.return_value.validate_connection.return_value = (
ControlPointDescription(host=INPUT_HOST, port=INPUT_PORT, mac=INPUT_MAC)
)
result = await hass.config_entries.flow.async_init(
DOMAIN, context={"source": config_entries.SOURCE_USER}
)
assert result["type"] is FlowResultType.FORM
assert result["step_id"] == "manual"
assert result["errors"] == {}
result = await hass.config_entries.flow.async_configure(
result["flow_id"],
{
CONF_HOST: INPUT_HOST,
CONF_PORT: INPUT_PORT,
},
)
assert result["type"] is FlowResultType.CREATE_ENTRY
assert result["title"] == f"ZIMI Controller ({INPUT_HOST}:{INPUT_PORT})"
assert result["data"] == {
"host": INPUT_HOST,
"port": INPUT_PORT,
"mac": format_mac(INPUT_MAC),
}
async def test_manual_cannot_connect(
hass: HomeAssistant,
discovery_mock: MagicMock,
) -> None:
"""Test manual form transitions via cannot_connect to creation."""
discovery_mock.discovers.side_effect = ControlPointError("Discovery failed")
result = await hass.config_entries.flow.async_init(
DOMAIN, context={"source": config_entries.SOURCE_USER}
)
assert result["type"] is FlowResultType.FORM
assert result["step_id"] == "manual"
assert result["errors"] == {}
# First attempt fails with CANNOT_CONNECT when attempting to connect
discovery_mock.return_value.validate_connection.side_effect = (
ControlPointCannotConnectError
)
result = await hass.config_entries.flow.async_configure(
result["flow_id"],
{
CONF_HOST: INPUT_HOST,
CONF_PORT: INPUT_PORT,
},
)
assert result["type"] is FlowResultType.FORM
assert result["step_id"] == "manual"
assert result["errors"] == {"base": "cannot_connect"}
# Second attempt succeeds
discovery_mock.return_value.validate_connection.side_effect = None
discovery_mock.return_value.validate_connection.return_value = (
ControlPointDescription(host=INPUT_HOST, port=INPUT_PORT, mac=INPUT_MAC)
)
result = await hass.config_entries.flow.async_configure(
result["flow_id"],
{
CONF_HOST: INPUT_HOST,
CONF_PORT: INPUT_PORT,
},
)
assert result["type"] is FlowResultType.CREATE_ENTRY
assert result["title"] == f"ZIMI Controller ({INPUT_HOST}:{INPUT_PORT})"
assert result["data"] == {
"host": INPUT_HOST,
"port": INPUT_PORT,
"mac": format_mac(INPUT_MAC),
}
async def test_manual_gethostbyname_error(
hass: HomeAssistant,
discovery_mock: MagicMock,
) -> None:
"""Test manual form transitions via gethostbyname failure to creation."""
discovery_mock.discovers.side_effect = ControlPointError("Discovery failed")
result = await hass.config_entries.flow.async_init(
DOMAIN, context={"source": config_entries.SOURCE_USER}
)
assert result["type"] is FlowResultType.FORM
assert result["step_id"] == "manual"
assert result["errors"] == {}
# First attempt fails with name lookup failure when attempting to connect
discovery_mock.return_value.validate_connection.side_effect = (
ControlPointInvalidHostError
)
result = await hass.config_entries.flow.async_configure(
result["flow_id"],
{
CONF_HOST: INPUT_HOST,
CONF_PORT: INPUT_PORT,
},
)
assert result["type"] is FlowResultType.FORM
assert result["step_id"]
assert result["errors"] == {"base": "invalid_host"}
# Second attempt succeeds
discovery_mock.return_value.validate_connection.side_effect = None
discovery_mock.return_value.validate_connection.return_value = (
ControlPointDescription(host=INPUT_HOST, port=INPUT_PORT, mac=INPUT_MAC)
)
result = await hass.config_entries.flow.async_configure(
result["flow_id"],
{
CONF_HOST: INPUT_HOST,
CONF_PORT: INPUT_PORT,
},
)
assert result["type"] is FlowResultType.CREATE_ENTRY
assert result["title"] == f"ZIMI Controller ({INPUT_HOST}:{INPUT_PORT})"
assert result["data"] == {
"host": INPUT_HOST,
"port": INPUT_PORT,
"mac": format_mac(INPUT_MAC),
}
@pytest.mark.parametrize(
("side_effect", "error_expected"),
[
(
ControlPointInvalidHostError,
{"base": "invalid_host"},
),
(
ControlPointConnectionRefusedError,
{"base": "connection_refused"},
),
(
ControlPointCannotConnectError,
{"base": "cannot_connect"},
),
(
ControlPointTimeoutError,
{"base": "timeout"},
),
(
Exception,
{"base": "unknown"},
),
],
)
async def test_manual_connection_errors(
hass: HomeAssistant,
discovery_mock: MagicMock,
side_effect: Exception,
error_expected: dict,
) -> None:
"""Test manual form connection errors."""
discovery_mock.discovers.side_effect = ControlPointError("Discovery failed")
result = await hass.config_entries.flow.async_init(
DOMAIN, context={"source": config_entries.SOURCE_USER}
)
assert result["type"] is FlowResultType.FORM
assert result["step_id"] == "manual"
assert result["errors"] == {}
# First attempt fails with connection errors
discovery_mock.return_value.validate_connection.side_effect = side_effect
result = await hass.config_entries.flow.async_configure(
result["flow_id"],
{
CONF_HOST: INPUT_HOST,
CONF_PORT: INPUT_PORT,
},
)
assert result["type"] is FlowResultType.FORM
assert result["step_id"] == "manual"
assert result["errors"] == error_expected
# Second attempt succeeds
discovery_mock.return_value.validate_connection.side_effect = None
discovery_mock.return_value.validate_connection.return_value = (
ControlPointDescription(host=INPUT_HOST, port=INPUT_PORT, mac=INPUT_MAC)
)
result = await hass.config_entries.flow.async_configure(
result["flow_id"],
{
CONF_HOST: INPUT_HOST,
CONF_PORT: INPUT_PORT,
},
)
assert result["type"] is FlowResultType.CREATE_ENTRY
assert result["title"] == f"ZIMI Controller ({INPUT_HOST}:{INPUT_PORT})"
assert result["data"] == {
"host": INPUT_HOST,
"port": INPUT_PORT,
"mac": format_mac(INPUT_MAC),
}