"""The PurpleAir integration.""" from __future__ import annotations from collections.abc import Mapping from typing import Any from aiopurpleair.models.sensors import SensorModel from homeassistant.config_entries import ConfigEntry from homeassistant.const import ( ATTR_LATITUDE, ATTR_LONGITUDE, CONF_SHOW_ON_MAP, Platform, ) from homeassistant.core import HomeAssistant from homeassistant.helpers.device_registry import DeviceInfo from homeassistant.helpers.update_coordinator import CoordinatorEntity from .const import DOMAIN from .coordinator import PurpleAirDataUpdateCoordinator PLATFORMS = [Platform.SENSOR] async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: """Set up PurpleAir from a config entry.""" coordinator = PurpleAirDataUpdateCoordinator(hass, entry) await coordinator.async_config_entry_first_refresh() hass.data.setdefault(DOMAIN, {})[entry.entry_id] = coordinator await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS) entry.async_on_unload(entry.add_update_listener(async_handle_entry_update)) return True async def async_handle_entry_update(hass: HomeAssistant, entry: ConfigEntry) -> None: """Handle an options update.""" await hass.config_entries.async_reload(entry.entry_id) async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: """Unload a config entry.""" if unload_ok := await hass.config_entries.async_unload_platforms(entry, PLATFORMS): hass.data[DOMAIN].pop(entry.entry_id) return unload_ok class PurpleAirEntity(CoordinatorEntity[PurpleAirDataUpdateCoordinator]): """Define a base PurpleAir entity.""" _attr_has_entity_name = True def __init__( self, coordinator: PurpleAirDataUpdateCoordinator, entry: ConfigEntry, sensor_index: int, ) -> None: """Initialize.""" super().__init__(coordinator) self._sensor_index = sensor_index self._attr_device_info = DeviceInfo( configuration_url=self.coordinator.async_get_map_url(sensor_index), hw_version=self.sensor_data.hardware, identifiers={(DOMAIN, str(sensor_index))}, manufacturer="PurpleAir, Inc.", model=self.sensor_data.model, name=self.sensor_data.name, sw_version=self.sensor_data.firmware_version, ) self._entry = entry @property def extra_state_attributes(self) -> Mapping[str, Any]: """Return entity specific state attributes.""" attrs = {} # Displaying the geography on the map relies upon putting the latitude/longitude # in the entity attributes with "latitude" and "longitude" as the keys. # Conversely, we can hide the location on the map by using other keys, like # "lati" and "long": if self._entry.options.get(CONF_SHOW_ON_MAP): attrs[ATTR_LATITUDE] = self.sensor_data.latitude attrs[ATTR_LONGITUDE] = self.sensor_data.longitude else: attrs["lati"] = self.sensor_data.latitude attrs["long"] = self.sensor_data.longitude return attrs @property def sensor_data(self) -> SensorModel: """Define a property to get this entity's SensorModel object.""" return self.coordinator.data.data[self._sensor_index]