geo_location.py

Go to the documentation of this file.

"""Support for NSW Rural Fire Service Feeds."""
 
from __future__ import annotations
 
from collections.abc import Callable
from datetime import datetime, timedelta
import logging
from typing import Any
 
from aio_geojson_nsw_rfs_incidents import NswRuralFireServiceIncidentsFeedManager
from aio_geojson_nsw_rfs_incidents.feed_entry import (
    NswRuralFireServiceIncidentsFeedEntry,
)
import voluptuous as vol
 
from homeassistant.components.geo_location import (
    PLATFORM_SCHEMA as GEO_LOCATION_PLATFORM_SCHEMA,
    GeolocationEvent,
)
from homeassistant.const import (
    ATTR_LOCATION,
    CONF_LATITUDE,
    CONF_LONGITUDE,
    CONF_RADIUS,
    CONF_SCAN_INTERVAL,
    EVENT_HOMEASSISTANT_START,
    EVENT_HOMEASSISTANT_STOP,
    UnitOfLength,
)
from homeassistant.core import Event, HomeAssistant, callback
from homeassistant.helpers import aiohttp_client, config_validation as cv
from homeassistant.helpers.dispatcher import (
    async_dispatcher_connect,
    async_dispatcher_send,
)
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.event import async_track_time_interval
from homeassistant.helpers.typing import ConfigType, DiscoveryInfoType
 
_LOGGER = logging.getLogger(__name__)
 
ATTR_CATEGORY = "category"
ATTR_COUNCIL_AREA = "council_area"
ATTR_EXTERNAL_ID = "external_id"
ATTR_FIRE = "fire"
ATTR_PUBLICATION_DATE = "publication_date"
ATTR_RESPONSIBLE_AGENCY = "responsible_agency"
ATTR_SIZE = "size"
ATTR_STATUS = "status"
ATTR_TYPE = "type"
 
CONF_CATEGORIES = "categories"
 
DEFAULT_RADIUS_IN_KM = 20.0
 
SCAN_INTERVAL = timedelta(minutes=5)
 
SIGNAL_DELETE_ENTITY = "nsw_rural_fire_service_feed_delete_{}"
SIGNAL_UPDATE_ENTITY = "nsw_rural_fire_service_feed_update_{}"
 
SOURCE = "nsw_rural_fire_service_feed"
 
VALID_CATEGORIES = ["Advice", "Emergency Warning", "Not Applicable", "Watch and Act"]
 
PLATFORM_SCHEMA = GEO_LOCATION_PLATFORM_SCHEMA.extend(
    {
        vol.Optional(CONF_CATEGORIES, default=[]): vol.All(
            cv.ensure_list, [vol.In(VALID_CATEGORIES)]
        ),
        vol.Optional(CONF_LATITUDE): cv.latitude,
        vol.Optional(CONF_LONGITUDE): cv.longitude,
        vol.Optional(CONF_RADIUS, default=DEFAULT_RADIUS_IN_KM): vol.Coerce(float),
    }
)
 
 
async def async_setup_platform(
    hass: HomeAssistant,
    config: ConfigType,
    async_add_entities: AddEntitiesCallback,
    discovery_info: DiscoveryInfoType | None = None,
) -> None:
    """Set up the NSW Rural Fire Service Feed platform."""
    scan_interval: timedelta = config.get(CONF_SCAN_INTERVAL, SCAN_INTERVAL)
    coordinates: tuple[float, float] = (
        config.get(CONF_LATITUDE, hass.config.latitude),
        config.get(CONF_LONGITUDE, hass.config.longitude),
    )
    radius_in_km: float = config[CONF_RADIUS]
    categories: list[str] = config[CONF_CATEGORIES]
    # Initialize the entity manager.
    manager = NswRuralFireServiceFeedEntityManager(
        hass, async_add_entities, scan_interval, coordinates, radius_in_km, categories
    )
 
    async def start_feed_manager(event: Event) -> None:
        """Start feed manager."""
        await manager.async_init()
 
    async def stop_feed_manager(event: Event) -> None:
        """Stop feed manager."""
        await manager.async_stop()
 
    hass.bus.async_listen_once(EVENT_HOMEASSISTANT_START, start_feed_manager)
    hass.bus.async_listen_once(EVENT_HOMEASSISTANT_STOP, stop_feed_manager)
    hass.async_create_task(manager.async_update())
 
 
class NswRuralFireServiceFeedEntityManager:
    """Feed Entity Manager for NSW Rural Fire Service GeoJSON feed."""
 
    def __init__(
        self,
        hass: HomeAssistant,
        async_add_entities: AddEntitiesCallback,
        scan_interval: timedelta,
        coordinates: tuple[float, float],
        radius_in_km: float,
        categories: list[str],
    ) -> None:
        """Initialize the Feed Entity Manager."""
        self._hass_hass = hass
        websession = aiohttp_client.async_get_clientsession(hass)
        self._feed_manager_feed_manager = NswRuralFireServiceIncidentsFeedManager(
            websession,
            self._generate_entity_generate_entity,
            self._update_entity_update_entity,
            self._remove_entity_remove_entity,
            coordinates,
            filter_radius=radius_in_km,
            filter_categories=categories,
        )
        self._async_add_entities_async_add_entities = async_add_entities
        self._scan_interval_scan_interval = scan_interval
        self._track_time_remove_callback_track_time_remove_callback: Callable[[], None] | None = None
 
    async def async_init(self) -> None:
        """Schedule initial and regular updates based on configured time interval."""
 
        async def update(event_time: datetime) -> None:
            """Update."""
            await self.async_updateasync_update()
 
        # Trigger updates at regular intervals.
        self._track_time_remove_callback_track_time_remove_callback = async_track_time_interval(
            self._hass_hass, update, self._scan_interval_scan_interval
        )
 
        _LOGGER.debug("Feed entity manager initialized")
 
    async def async_update(self) -> None:
        """Refresh data."""
        await self._feed_manager_feed_manager.update()
        _LOGGER.debug("Feed entity manager updated")
 
    async def async_stop(self) -> None:
        """Stop this feed entity manager from refreshing."""
        if self._track_time_remove_callback_track_time_remove_callback:
            self._track_time_remove_callback_track_time_remove_callback()
        _LOGGER.debug("Feed entity manager stopped")
 
    def get_entry(
        self, external_id: str
    ) -> NswRuralFireServiceIncidentsFeedEntry | None:
        """Get feed entry by external id."""
        return self._feed_manager_feed_manager.feed_entries.get(external_id)
 
    async def _generate_entity(self, external_id: str) -> None:
        """Generate new entity."""
        new_entity = NswRuralFireServiceLocationEvent(self, external_id)
        # Add new entities to HA.
        self._async_add_entities_async_add_entities([new_entity], True)
 
    async def _update_entity(self, external_id: str) -> None:
        """Update entity."""
        async_dispatcher_send(self._hass_hass, SIGNAL_UPDATE_ENTITY.format(external_id))
 
    async def _remove_entity(self, external_id: str) -> None:
        """Remove entity."""
        async_dispatcher_send(self._hass_hass, SIGNAL_DELETE_ENTITY.format(external_id))
 
 
class NswRuralFireServiceLocationEvent(GeolocationEvent):
    """Represents an external event with NSW Rural Fire Service data."""
 
    _attr_should_poll = False
    _attr_source = SOURCE
    _attr_unit_of_measurement = UnitOfLength.KILOMETERS
 
    def __init__(
        self, feed_manager: NswRuralFireServiceFeedEntityManager, external_id: str
    ) -> None:
        """Initialize entity with data from feed entry."""
        self._feed_manager_feed_manager = feed_manager
        self._external_id_external_id = external_id
        self._category_category = None
        self._publication_date_publication_date = None
        self._location_location = None
        self._council_area_council_area = None
        self._status_status = None
        self._type_type = None
        self._fire_fire = None
        self._size_size = None
        self._responsible_agency_responsible_agency = None
        self._remove_signal_delete_remove_signal_delete: Callable[[], None]
        self._remove_signal_update_remove_signal_update: Callable[[], None]
 
    async def async_added_to_hass(self) -> None:
        """Call when entity is added to hass."""
        self._remove_signal_delete_remove_signal_delete = async_dispatcher_connect(
            self.hasshass,
            SIGNAL_DELETE_ENTITY.format(self._external_id_external_id),
            self._delete_callback_delete_callback,
        )
        self._remove_signal_update_remove_signal_update = async_dispatcher_connect(
            self.hasshass,
            SIGNAL_UPDATE_ENTITY.format(self._external_id_external_id),
            self._update_callback_update_callback,
        )
 
    async def async_will_remove_from_hass(self) -> None:
        """Call when entity will be removed from hass."""
        self._remove_signal_delete_remove_signal_delete()
        self._remove_signal_update_remove_signal_update()
 
    @callback
    def _delete_callback(self) -> None:
        """Remove this entity."""
        self.hasshass.async_create_task(self.async_removeasync_remove(force_remove=True))
 
    @callback
    def _update_callback(self) -> None:
        """Call update method."""
        self.async_schedule_update_ha_stateasync_schedule_update_ha_state(True)
 
    async def async_update(self) -> None:
        """Update this entity from the data held in the feed manager."""
        _LOGGER.debug("Updating %s", self._external_id_external_id)
        feed_entry = self._feed_manager_feed_manager.get_entry(self._external_id_external_id)
        if feed_entry:
            self._update_from_feed_update_from_feed(feed_entry)
 
    def _update_from_feed(
        self, feed_entry: NswRuralFireServiceIncidentsFeedEntry
    ) -> None:
        """Update the internal state from the provided feed entry."""
        self._attr_name_attr_name = feed_entry.title
        self._attr_distance_attr_distance = feed_entry.distance_to_home
        self._attr_latitude_attr_latitude = feed_entry.coordinates[0]
        self._attr_longitude_attr_longitude = feed_entry.coordinates[1]
        self._attr_attribution_attr_attribution = feed_entry.attribution
        self._category_category = feed_entry.category
        self._publication_date_publication_date = feed_entry.publication_date
        self._location_location = feed_entry.location
        self._council_area_council_area = feed_entry.council_area
        self._status_status = feed_entry.status
        self._type_type = feed_entry.type
        self._fire_fire = feed_entry.fire
        self._size_size = feed_entry.size
        self._responsible_agency_responsible_agency = feed_entry.responsible_agency
 
    @property
    def icon(self) -> str:
        """Return the icon to use in the frontend."""
        if self._fire_fire:
            return "mdi:fire"
        return "mdi:alarm-light"
 
    @property
    def extra_state_attributes(self) -> dict[str, Any]:
        """Return the device state attributes."""
        return {
            key: value
            for key, value in (
                (ATTR_EXTERNAL_ID, self._external_id_external_id),
                (ATTR_CATEGORY, self._category_category),
                (ATTR_LOCATION, self._location_location),
                (ATTR_PUBLICATION_DATE, self._publication_date_publication_date),
                (ATTR_COUNCIL_AREA, self._council_area_council_area),
                (ATTR_STATUS, self._status_status),
                (ATTR_TYPE, self._type_type),
                (ATTR_FIRE, self._fire_fire),
                (ATTR_SIZE, self._size_size),
                (ATTR_RESPONSIBLE_AGENCY, self._responsible_agency_responsible_agency),
            )
            if value or isinstance(value, bool)
        }