coordinator.py

Go to the documentation of this file.

"""Data Update Coordinator for IMGW-PIB integration."""
 
import logging
 
from imgw_pib import ApiError, HydrologicalData, ImgwPib
 
from homeassistant.core import HomeAssistant
from homeassistant.helpers.device_registry import DeviceEntryType, DeviceInfo
from homeassistant.helpers.update_coordinator import DataUpdateCoordinator, UpdateFailed
 
from .const import DOMAIN, UPDATE_INTERVAL
 
_LOGGER = logging.getLogger(__name__)
 
 
class ImgwPibDataUpdateCoordinator(DataUpdateCoordinator[HydrologicalData]):
    """Class to manage fetching IMGW-PIB data API."""
 
    def __init__(
        self,
        hass: HomeAssistant,
        imgwpib: ImgwPib,
        station_id: str,
    ) -> None:
        """Initialize."""
        self.imgwpibimgwpib = imgwpib
        self.station_idstation_id = station_id
        self.device_infodevice_info = DeviceInfo(
            entry_type=DeviceEntryType.SERVICE,
            identifiers={(DOMAIN, station_id)},
            manufacturer="IMGW-PIB",
            name=f"{imgwpib.hydrological_stations[station_id]}",
            configuration_url=f"https://hydro.imgw.pl/#/station/hydro/{station_id}",
        )
 
        super().__init__(hass, _LOGGER, name=DOMAIN, update_interval=UPDATE_INTERVAL)
 
    async def _async_update_data(self) -> HydrologicalData:
        """Update data via internal method."""
        try:
            return await self.imgwpibimgwpib.get_hydrological_data()
        except ApiError as err:
            raise UpdateFailed(err) from err