268 lines
		
	
	
		
			8.0 KiB
		
	
	
	
		
			Python
		
	
	
			
		
		
	
	
			268 lines
		
	
	
		
			8.0 KiB
		
	
	
	
		
			Python
		
	
	
"""The tests for notify entity platform."""
 | 
						|
 | 
						|
import copy
 | 
						|
from unittest.mock import MagicMock
 | 
						|
 | 
						|
import pytest
 | 
						|
import voluptuous as vol
 | 
						|
 | 
						|
from homeassistant.components import notify
 | 
						|
from homeassistant.components.notify import (
 | 
						|
    DOMAIN,
 | 
						|
    SERVICE_SEND_MESSAGE,
 | 
						|
    NotifyEntity,
 | 
						|
    NotifyEntityDescription,
 | 
						|
    NotifyEntityFeature,
 | 
						|
)
 | 
						|
from homeassistant.config_entries import ConfigEntry
 | 
						|
from homeassistant.const import STATE_UNAVAILABLE, STATE_UNKNOWN, Platform
 | 
						|
from homeassistant.core import HomeAssistant, State
 | 
						|
 | 
						|
from tests.common import (
 | 
						|
    MockConfigEntry,
 | 
						|
    MockEntity,
 | 
						|
    MockModule,
 | 
						|
    mock_integration,
 | 
						|
    mock_platform,
 | 
						|
    mock_restore_cache,
 | 
						|
    setup_test_component_platform,
 | 
						|
)
 | 
						|
 | 
						|
TEST_KWARGS = {notify.ATTR_MESSAGE: "Test message"}
 | 
						|
TEST_KWARGS_TITLE = {notify.ATTR_MESSAGE: "Test message", notify.ATTR_TITLE: "My title"}
 | 
						|
 | 
						|
 | 
						|
class MockNotifyEntity(MockEntity, NotifyEntity):
 | 
						|
    """Mock Email notitier entity to use in tests."""
 | 
						|
 | 
						|
    send_message_mock_calls = MagicMock()
 | 
						|
 | 
						|
    async def async_send_message(self, message: str, title: str | None = None) -> None:
 | 
						|
        """Send a notification message."""
 | 
						|
        self.send_message_mock_calls(message, title=title)
 | 
						|
 | 
						|
 | 
						|
class MockNotifyEntityNonAsync(MockEntity, NotifyEntity):
 | 
						|
    """Mock Email notitier entity to use in tests."""
 | 
						|
 | 
						|
    send_message_mock_calls = MagicMock()
 | 
						|
 | 
						|
    def send_message(self, message: str, title: str | None = None) -> None:
 | 
						|
        """Send a notification message."""
 | 
						|
        self.send_message_mock_calls(message, title=title)
 | 
						|
 | 
						|
 | 
						|
async def help_async_setup_entry_init(
 | 
						|
    hass: HomeAssistant, config_entry: ConfigEntry
 | 
						|
) -> bool:
 | 
						|
    """Set up test config entry."""
 | 
						|
    await hass.config_entries.async_forward_entry_setups(config_entry, [DOMAIN])
 | 
						|
    return True
 | 
						|
 | 
						|
 | 
						|
async def help_async_unload_entry(
 | 
						|
    hass: HomeAssistant, config_entry: ConfigEntry
 | 
						|
) -> bool:
 | 
						|
    """Unload test config emntry."""
 | 
						|
    return await hass.config_entries.async_unload_platforms(
 | 
						|
        config_entry, [Platform.NOTIFY]
 | 
						|
    )
 | 
						|
 | 
						|
 | 
						|
@pytest.mark.parametrize(
 | 
						|
    "entity",
 | 
						|
    [
 | 
						|
        MockNotifyEntityNonAsync(name="test", entity_id="notify.test"),
 | 
						|
        MockNotifyEntity(name="test", entity_id="notify.test"),
 | 
						|
    ],
 | 
						|
    ids=["non_async", "async"],
 | 
						|
)
 | 
						|
async def test_send_message_service(
 | 
						|
    hass: HomeAssistant, config_flow_fixture: None, entity: NotifyEntity
 | 
						|
) -> None:
 | 
						|
    """Test send_message service."""
 | 
						|
 | 
						|
    config_entry = MockConfigEntry(domain="test")
 | 
						|
    config_entry.add_to_hass(hass)
 | 
						|
 | 
						|
    mock_integration(
 | 
						|
        hass,
 | 
						|
        MockModule(
 | 
						|
            "test",
 | 
						|
            async_setup_entry=help_async_setup_entry_init,
 | 
						|
            async_unload_entry=help_async_unload_entry,
 | 
						|
        ),
 | 
						|
    )
 | 
						|
    setup_test_component_platform(hass, DOMAIN, [entity], from_config_entry=True)
 | 
						|
    assert await hass.config_entries.async_setup(config_entry.entry_id)
 | 
						|
 | 
						|
    state = hass.states.get("notify.test")
 | 
						|
    assert state.state is STATE_UNKNOWN
 | 
						|
 | 
						|
    await hass.services.async_call(
 | 
						|
        DOMAIN,
 | 
						|
        SERVICE_SEND_MESSAGE,
 | 
						|
        copy.deepcopy(TEST_KWARGS) | {"entity_id": "notify.test"},
 | 
						|
        blocking=True,
 | 
						|
    )
 | 
						|
    await hass.async_block_till_done()
 | 
						|
 | 
						|
    entity.send_message_mock_calls.assert_called_once()
 | 
						|
    entity.send_message_mock_calls.reset_mock()
 | 
						|
 | 
						|
    # Test schema: `None` message fails
 | 
						|
    with pytest.raises(vol.Invalid) as exc:
 | 
						|
        await hass.services.async_call(
 | 
						|
            notify.DOMAIN,
 | 
						|
            notify.SERVICE_SEND_MESSAGE,
 | 
						|
            {"entity_id": "notify.test", notify.ATTR_MESSAGE: None},
 | 
						|
        )
 | 
						|
    assert (
 | 
						|
        str(exc.value) == "string value is None for dictionary value @ data['message']"
 | 
						|
    )
 | 
						|
    entity.send_message_mock_calls.assert_not_called()
 | 
						|
 | 
						|
    # Test schema: No message fails
 | 
						|
    with pytest.raises(vol.Invalid) as exc:
 | 
						|
        await hass.services.async_call(
 | 
						|
            notify.DOMAIN, notify.SERVICE_SEND_MESSAGE, {"entity_id": "notify.test"}
 | 
						|
        )
 | 
						|
    assert str(exc.value) == "required key not provided @ data['message']"
 | 
						|
    entity.send_message_mock_calls.assert_not_called()
 | 
						|
 | 
						|
    # Test unloading the entry succeeds
 | 
						|
    assert await hass.config_entries.async_unload(config_entry.entry_id)
 | 
						|
 | 
						|
 | 
						|
@pytest.mark.parametrize(
 | 
						|
    "entity",
 | 
						|
    [
 | 
						|
        MockNotifyEntityNonAsync(
 | 
						|
            name="test",
 | 
						|
            entity_id="notify.test",
 | 
						|
            supported_features=NotifyEntityFeature.TITLE,
 | 
						|
        ),
 | 
						|
        MockNotifyEntity(
 | 
						|
            name="test",
 | 
						|
            entity_id="notify.test",
 | 
						|
            supported_features=NotifyEntityFeature.TITLE,
 | 
						|
        ),
 | 
						|
    ],
 | 
						|
    ids=["non_async", "async"],
 | 
						|
)
 | 
						|
async def test_send_message_service_with_title(
 | 
						|
    hass: HomeAssistant, config_flow_fixture: None, entity: NotifyEntity
 | 
						|
) -> None:
 | 
						|
    """Test send_message service."""
 | 
						|
 | 
						|
    config_entry = MockConfigEntry(domain="test")
 | 
						|
    config_entry.add_to_hass(hass)
 | 
						|
 | 
						|
    mock_integration(
 | 
						|
        hass,
 | 
						|
        MockModule(
 | 
						|
            "test",
 | 
						|
            async_setup_entry=help_async_setup_entry_init,
 | 
						|
            async_unload_entry=help_async_unload_entry,
 | 
						|
        ),
 | 
						|
    )
 | 
						|
    setup_test_component_platform(hass, DOMAIN, [entity], from_config_entry=True)
 | 
						|
    assert await hass.config_entries.async_setup(config_entry.entry_id)
 | 
						|
 | 
						|
    state = hass.states.get("notify.test")
 | 
						|
    assert state.state is STATE_UNKNOWN
 | 
						|
 | 
						|
    await hass.services.async_call(
 | 
						|
        DOMAIN,
 | 
						|
        SERVICE_SEND_MESSAGE,
 | 
						|
        copy.deepcopy(TEST_KWARGS_TITLE) | {"entity_id": "notify.test"},
 | 
						|
        blocking=True,
 | 
						|
    )
 | 
						|
    await hass.async_block_till_done()
 | 
						|
 | 
						|
    entity.send_message_mock_calls.assert_called_once_with(
 | 
						|
        TEST_KWARGS_TITLE[notify.ATTR_MESSAGE],
 | 
						|
        title=TEST_KWARGS_TITLE[notify.ATTR_TITLE],
 | 
						|
    )
 | 
						|
 | 
						|
 | 
						|
@pytest.mark.parametrize(
 | 
						|
    ("state", "init_state"),
 | 
						|
    [
 | 
						|
        ("2021-01-01T23:59:59+00:00", "2021-01-01T23:59:59+00:00"),
 | 
						|
        (STATE_UNAVAILABLE, STATE_UNKNOWN),
 | 
						|
    ],
 | 
						|
)
 | 
						|
async def test_restore_state(
 | 
						|
    hass: HomeAssistant, config_flow_fixture: None, state: str, init_state: str
 | 
						|
) -> None:
 | 
						|
    """Test we restore state integration."""
 | 
						|
    mock_restore_cache(hass, (State("notify.test", state),))
 | 
						|
 | 
						|
    mock_integration(
 | 
						|
        hass,
 | 
						|
        MockModule(
 | 
						|
            "test",
 | 
						|
            async_setup_entry=help_async_setup_entry_init,
 | 
						|
        ),
 | 
						|
    )
 | 
						|
 | 
						|
    entity = MockNotifyEntity(name="test", entity_id="notify.test")
 | 
						|
    setup_test_component_platform(hass, DOMAIN, [entity], from_config_entry=True)
 | 
						|
 | 
						|
    config_entry = MockConfigEntry(domain="test")
 | 
						|
    config_entry.add_to_hass(hass)
 | 
						|
    assert await hass.config_entries.async_setup(config_entry.entry_id)
 | 
						|
 | 
						|
    state = hass.states.get("notify.test")
 | 
						|
    assert state is not None
 | 
						|
    assert state.state is init_state
 | 
						|
 | 
						|
 | 
						|
async def test_name(hass: HomeAssistant, config_flow_fixture: None) -> None:
 | 
						|
    """Test notify name."""
 | 
						|
 | 
						|
    mock_platform(hass, "test.config_flow")
 | 
						|
    mock_integration(
 | 
						|
        hass,
 | 
						|
        MockModule(
 | 
						|
            "test",
 | 
						|
            async_setup_entry=help_async_setup_entry_init,
 | 
						|
        ),
 | 
						|
    )
 | 
						|
 | 
						|
    # Unnamed notify entity -> no name
 | 
						|
    entity1 = NotifyEntity()
 | 
						|
    entity1.entity_id = "notify.test1"
 | 
						|
 | 
						|
    # Unnamed notify entity and has_entity_name True -> unnamed
 | 
						|
    entity2 = NotifyEntity()
 | 
						|
    entity2.entity_id = "notify.test3"
 | 
						|
    entity2._attr_has_entity_name = True
 | 
						|
 | 
						|
    # Named notify entity and has_entity_name True -> named
 | 
						|
    entity3 = NotifyEntity()
 | 
						|
    entity3.entity_id = "notify.test4"
 | 
						|
    entity3.entity_description = NotifyEntityDescription("test", has_entity_name=True)
 | 
						|
 | 
						|
    setup_test_component_platform(
 | 
						|
        hass, DOMAIN, [entity1, entity2, entity3], from_config_entry=True
 | 
						|
    )
 | 
						|
 | 
						|
    config_entry = MockConfigEntry(domain="test")
 | 
						|
    config_entry.add_to_hass(hass)
 | 
						|
    assert await hass.config_entries.async_setup(config_entry.entry_id)
 | 
						|
    await hass.async_block_till_done()
 | 
						|
 | 
						|
    state = hass.states.get(entity1.entity_id)
 | 
						|
    assert state
 | 
						|
    assert state.attributes == {"supported_features": NotifyEntityFeature(0)}
 | 
						|
 | 
						|
    state = hass.states.get(entity2.entity_id)
 | 
						|
    assert state
 | 
						|
    assert state.attributes == {"supported_features": NotifyEntityFeature(0)}
 | 
						|
 | 
						|
    state = hass.states.get(entity3.entity_id)
 | 
						|
    assert state
 | 
						|
    assert state.attributes == {"supported_features": NotifyEntityFeature(0)}
 |