mirror of https://github.com/home-assistant/core
99 lines
3.0 KiB
Python
99 lines
3.0 KiB
Python
"""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 = retrieve_online_state(self._data, self._detail)
|
|
current_activity = self.entity_description.value_fn(self._data, self._detail)
|
|
if not current_activity or current_activity == self._last_activity:
|
|
return
|
|
self._last_activity = current_activity
|
|
event_types = self.entity_description.event_types
|
|
if TYPE_CHECKING:
|
|
assert event_types is not None
|
|
self._trigger_event(event_type=event_types[0])
|
|
self.async_write_ha_state()
|