1
mirror of https://github.com/home-assistant/core synced 2024-08-28 03:36:46 +02:00
ha-core/homeassistant/components/ipma/sensor.py

99 lines
3.0 KiB
Python

"""Support for IPMA sensors."""
from __future__ import annotations
import asyncio
from collections.abc import Callable, Coroutine
from dataclasses import dataclass
import logging
from pyipma.api import IPMA_API
from pyipma.location import Location
from pyipma.rcm import RCM
from pyipma.uv import UV
from homeassistant.components.sensor import SensorEntity, SensorEntityDescription
from homeassistant.config_entries import ConfigEntry
from homeassistant.core import HomeAssistant
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.util import Throttle
from .const import DATA_API, DATA_LOCATION, DOMAIN, MIN_TIME_BETWEEN_UPDATES
from .entity import IPMADevice
_LOGGER = logging.getLogger(__name__)
@dataclass(frozen=True, kw_only=True)
class IPMASensorEntityDescription(SensorEntityDescription):
"""Describes a IPMA sensor entity."""
value_fn: Callable[[Location, IPMA_API], Coroutine[Location, IPMA_API, int | None]]
async def async_retrieve_rcm(location: Location, api: IPMA_API) -> int | None:
"""Retrieve RCM."""
fire_risk: RCM = await location.fire_risk(api)
if fire_risk:
return fire_risk.rcm
return None
async def async_retrieve_uvi(location: Location, api: IPMA_API) -> int | None:
"""Retrieve UV."""
uv_risk: UV = await location.uv_risk(api)
if uv_risk:
return round(uv_risk.iUv)
return None
SENSOR_TYPES: tuple[IPMASensorEntityDescription, ...] = (
IPMASensorEntityDescription(
key="rcm",
translation_key="fire_risk",
value_fn=async_retrieve_rcm,
),
IPMASensorEntityDescription(
key="uvi",
translation_key="uv_index",
value_fn=async_retrieve_uvi,
),
)
async def async_setup_entry(
hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback
) -> None:
"""Set up the IPMA sensor platform."""
api = hass.data[DOMAIN][entry.entry_id][DATA_API]
location = hass.data[DOMAIN][entry.entry_id][DATA_LOCATION]
entities = [IPMASensor(api, location, description) for description in SENSOR_TYPES]
async_add_entities(entities, True)
class IPMASensor(SensorEntity, IPMADevice):
"""Representation of an IPMA sensor."""
entity_description: IPMASensorEntityDescription
_attr_has_entity_name = True
def __init__(
self,
api: IPMA_API,
location: Location,
description: IPMASensorEntityDescription,
) -> None:
"""Initialize the IPMA Sensor."""
IPMADevice.__init__(self, api, location)
self.entity_description = description
self._attr_unique_id = f"{self._location.station_latitude}, {self._location.station_longitude}, {self.entity_description.key}"
@Throttle(MIN_TIME_BETWEEN_UPDATES)
async def async_update(self) -> None:
"""Update sensors."""
async with asyncio.timeout(10):
self._attr_native_value = await self.entity_description.value_fn(
self._location, self._api
)