entity.py

Go to the documentation of this file.

"""Adapter to wrap the rachiopy api for home assistant."""
 
from abc import abstractmethod
from typing import Any
 
from homeassistant.core import callback
from homeassistant.helpers import device_registry as dr
from homeassistant.helpers.device_registry import DeviceInfo
from homeassistant.helpers.entity import Entity
from homeassistant.helpers.update_coordinator import CoordinatorEntity
 
from .const import (
    DEFAULT_NAME,
    DOMAIN,
    KEY_CONNECTED,
    KEY_ID,
    KEY_NAME,
    KEY_REPORTED_STATE,
    KEY_STATE,
)
from .coordinator import RachioUpdateCoordinator
from .device import RachioIro
 
 
class RachioDevice(Entity):
    """Base class for rachio devices."""
 
    _attr_should_poll = False
 
    def __init__(self, controller: RachioIro) -> None:
        """Initialize a Rachio device."""
        super().__init__()
        self._controller_controller = controller
        self._attr_device_info_attr_device_info = DeviceInfo(
            identifiers={
                (
                    DOMAIN,
                    self._controller_controller.serial_number,
                )
            },
            connections={
                (
                    dr.CONNECTION_NETWORK_MAC,
                    self._controller_controller.mac_address,
                )
            },
            name=self._controller_controller.name,
            model=self._controller_controller.model,
            manufacturer=DEFAULT_NAME,
            configuration_url="https://app.rach.io",
        )
 
 
class RachioHoseTimerEntity(CoordinatorEntity[RachioUpdateCoordinator]):
    """Base class for smart hose timer entities."""
 
    _attr_has_entity_name = True
 
    def __init__(
        self, data: dict[str, Any], coordinator: RachioUpdateCoordinator
    ) -> None:
        """Initialize a Rachio smart hose timer entity."""
        super().__init__(coordinator)
        self.idid = data[KEY_ID]
        self._name_name = data[KEY_NAME]
        self._attr_device_info_attr_device_info = DeviceInfo(
            identifiers={(DOMAIN, self.idid)},
            model="Smart Hose Timer",
            name=self._name_name,
            manufacturer=DEFAULT_NAME,
            configuration_url="https://app.rach.io",
        )
        self._update_attr_update_attr()
 
    @property
    def available(self) -> bool:
        """Return if the entity is available."""
        return (
            super().available
            and self.coordinator.data[self.idid][KEY_STATE][KEY_REPORTED_STATE][
                KEY_CONNECTED
            ]
        )
 
    @abstractmethod
    def _update_attr(self) -> None:
        """Update the state and attributes."""
 
    @callback
    def _handle_coordinator_update(self) -> None:
        """Handle updated data from the coordinator."""
        self._update_attr_update_attr()
        super()._handle_coordinator_update()