event.py

Go to the documentation of this file.

"""Support for august events."""
 
from __future__ import annotations
 
from collections.abc import Callable
from dataclasses import dataclass
from typing import TYPE_CHECKING
 
from yalexs.activity import Activity
from yalexs.doorbell import DoorbellDetail
from yalexs.lock import LockDetail
 
from homeassistant.components.event import (
    EventDeviceClass,
    EventEntity,
    EventEntityDescription,
)
from homeassistant.core import HomeAssistant, callback
from homeassistant.helpers.entity_platform import AddEntitiesCallback
 
from . import AugustConfigEntry, AugustData
from .entity import AugustDescriptionEntity
from .util import (
    retrieve_ding_activity,
    retrieve_doorbell_motion_activity,
    retrieve_online_state,
)
 
 
@dataclass(kw_only=True, frozen=True)
class AugustEventEntityDescription(EventEntityDescription):
    """Describe august event entities."""
 
    value_fn: Callable[[AugustData, DoorbellDetail | LockDetail], Activity | None]
 
 
TYPES_VIDEO_DOORBELL: tuple[AugustEventEntityDescription, ...] = (
    AugustEventEntityDescription(
        key="motion",
        translation_key="motion",
        device_class=EventDeviceClass.MOTION,
        event_types=["motion"],
        value_fn=retrieve_doorbell_motion_activity,
    ),
)
 
 
TYPES_DOORBELL: tuple[AugustEventEntityDescription, ...] = (
    AugustEventEntityDescription(
        key="doorbell",
        translation_key="doorbell",
        device_class=EventDeviceClass.DOORBELL,
        event_types=["ring"],
        value_fn=retrieve_ding_activity,
    ),
)
 
 
async def async_setup_entry(
    hass: HomeAssistant,
    config_entry: AugustConfigEntry,
    async_add_entities: AddEntitiesCallback,
) -> None:
    """Set up the august event platform."""
    data = config_entry.runtime_data
    entities: list[AugustEventEntity] = [
        AugustEventEntity(data, lock, description)
        for description in TYPES_DOORBELL
        for lock in data.locks
        if (detail := data.get_device_detail(lock.device_id)) and detail.doorbell
    ]
    entities.extend(
        AugustEventEntity(data, doorbell, description)
        for description in TYPES_DOORBELL + TYPES_VIDEO_DOORBELL
        for doorbell in data.doorbells
    )
    async_add_entities(entities)
 
 
class AugustEventEntity(AugustDescriptionEntity, EventEntity):
    """An august event entity."""
 
    entity_description: AugustEventEntityDescription
    _last_activity: Activity | None = None
 
    @callback
    def _update_from_data(self) -> None:
        """Update from data."""
        self._attr_available_attr_available = retrieve_online_state(self._data_data, self._detail_detail)
        current_activity = self.entity_descriptionentity_description.value_fn(self._data_data, self._detail_detail)
        if not current_activity or current_activity == self._last_activity_last_activity:
            return
        self._last_activity_last_activity = current_activity
        event_types = self.entity_descriptionentity_description.event_types
        if TYPE_CHECKING:
            assert event_types is not None
        self._trigger_event_trigger_event(event_type=event_types[0])
        self.async_write_ha_stateasync_write_ha_state()