entity.py

Go to the documentation of this file.

"""Support for IQVIA."""
 
from __future__ import annotations
 
from typing import Any
 
from homeassistant.config_entries import ConfigEntry
from homeassistant.core import callback
from homeassistant.helpers.entity import EntityDescription
from homeassistant.helpers.update_coordinator import (
    CoordinatorEntity,
    DataUpdateCoordinator,
)
 
from .const import CONF_ZIP_CODE, DOMAIN, TYPE_ALLERGY_FORECAST, TYPE_ALLERGY_OUTLOOK
 
 
class IQVIAEntity(CoordinatorEntity[DataUpdateCoordinator[dict[str, Any]]]):
    """Define a base IQVIA entity."""
 
    _attr_has_entity_name = True
 
    def __init__(
        self,
        coordinator: DataUpdateCoordinator[dict[str, Any]],
        entry: ConfigEntry,
        description: EntityDescription,
    ) -> None:
        """Initialize."""
        super().__init__(coordinator)
 
        self._attr_extra_state_attributes_attr_extra_state_attributes = {}
        self._attr_unique_id_attr_unique_id = f"{entry.data[CONF_ZIP_CODE]}_{description.key}"
        self._entry_entry = entry
        self.entity_descriptionentity_description = description
 
    @callback
    def _handle_coordinator_update(self) -> None:
        """Handle updated data from the coordinator."""
        if not self.coordinator.last_update_success:
            return
 
        self.update_from_latest_dataupdate_from_latest_data()
        self.async_write_ha_state()
 
    async def async_added_to_hass(self) -> None:
        """Register callbacks."""
        await super().async_added_to_hass()
 
        if self.entity_descriptionentity_description.key == TYPE_ALLERGY_FORECAST:
            self.async_on_remove(
                self.hasshass.data[DOMAIN][self._entry_entry.entry_id][
                    TYPE_ALLERGY_OUTLOOK
                ].async_add_listener(self._handle_coordinator_update_handle_coordinator_update)
            )
 
        self.update_from_latest_dataupdate_from_latest_data()
 
    @callback
    def update_from_latest_data(self) -> None:
        """Update the entity from the latest data."""
        raise NotImplementedError