Add SensorEntityClass support for Environment Canada integration (#58615)

pull/63946/head
Glenn Waters 2022-01-07 12:28:13 -05:00 committed by GitHub
parent 9ef1033152
commit 128433758e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 238 additions and 76 deletions

View File

@ -1,20 +1,201 @@
"""Support for the Environment Canada weather service."""
from __future__ import annotations
import logging
import re
import voluptuous as vol
from homeassistant.components.sensor import SensorDeviceClass, SensorEntity
from homeassistant.components.sensor import (
SensorDeviceClass,
SensorEntity,
SensorEntityDescription,
SensorStateClass,
)
from homeassistant.config_entries import ConfigEntry
from homeassistant.const import ATTR_LOCATION, TEMP_CELSIUS
from homeassistant.const import (
ATTR_LOCATION,
DEGREE,
LENGTH_KILOMETERS,
LENGTH_MILLIMETERS,
PERCENTAGE,
PRESSURE_KPA,
SPEED_KILOMETERS_PER_HOUR,
TEMP_CELSIUS,
UV_INDEX,
)
from homeassistant.core import HomeAssistant
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.update_coordinator import CoordinatorEntity
from .const import ATTR_OBSERVATION_TIME, ATTR_STATION, DOMAIN
from .const import ATTR_STATION, DOMAIN
ATTR_TIME = "alert time"
SENSOR_TYPES: tuple[SensorEntityDescription, ...] = (
SensorEntityDescription(
key="condition",
name="Current Condition",
),
SensorEntityDescription(
key="dewpoint",
name="Dew Point",
device_class=SensorDeviceClass.TEMPERATURE,
native_unit_of_measurement=TEMP_CELSIUS,
state_class=SensorStateClass.MEASUREMENT,
),
SensorEntityDescription(
key="high_temp",
name="High Temperature",
device_class=SensorDeviceClass.TEMPERATURE,
native_unit_of_measurement=TEMP_CELSIUS,
state_class=SensorStateClass.MEASUREMENT,
),
SensorEntityDescription(
key="humidex",
name="Humidex",
device_class=SensorDeviceClass.TEMPERATURE,
native_unit_of_measurement=TEMP_CELSIUS,
state_class=SensorStateClass.MEASUREMENT,
),
SensorEntityDescription(
key="humidity",
name="Humidity",
device_class=SensorDeviceClass.HUMIDITY,
native_unit_of_measurement=PERCENTAGE,
state_class=SensorStateClass.MEASUREMENT,
),
SensorEntityDescription(
key="icon_code",
name="Icon Code",
),
SensorEntityDescription(
key="low_temp",
name="Low Temperature",
device_class=SensorDeviceClass.TEMPERATURE,
native_unit_of_measurement=TEMP_CELSIUS,
state_class=SensorStateClass.MEASUREMENT,
),
SensorEntityDescription(
key="normal_high",
name="Normal High Temperature",
device_class=SensorDeviceClass.TEMPERATURE,
native_unit_of_measurement=TEMP_CELSIUS,
),
SensorEntityDescription(
key="normal_low",
name="Normal Low Temperature",
device_class=SensorDeviceClass.TEMPERATURE,
native_unit_of_measurement=TEMP_CELSIUS,
),
SensorEntityDescription(
key="pop",
name="Chance of Precipitation",
native_unit_of_measurement=PERCENTAGE,
),
SensorEntityDescription(
key="precip_yesterday",
name="Precipitation Yesterday",
native_unit_of_measurement=LENGTH_MILLIMETERS,
state_class=SensorStateClass.MEASUREMENT,
),
SensorEntityDescription(
key="pressure",
name="Barometric Pressure",
device_class=SensorDeviceClass.PRESSURE,
native_unit_of_measurement=PRESSURE_KPA,
state_class=SensorStateClass.MEASUREMENT,
),
SensorEntityDescription(
key="temperature",
name="Temperature",
device_class=SensorDeviceClass.TEMPERATURE,
native_unit_of_measurement=TEMP_CELSIUS,
state_class=SensorStateClass.MEASUREMENT,
),
SensorEntityDescription(
key="tendency",
name="Tendency",
),
SensorEntityDescription(
key="text_summary",
name="Summary",
),
SensorEntityDescription(
key="timestamp",
name="Observation Time",
device_class=SensorDeviceClass.TIMESTAMP,
),
SensorEntityDescription(
key="uv_index",
name="UV Index",
native_unit_of_measurement=UV_INDEX,
state_class=SensorStateClass.MEASUREMENT,
),
SensorEntityDescription(
key="visibility",
name="Visibility",
native_unit_of_measurement=LENGTH_KILOMETERS,
state_class=SensorStateClass.MEASUREMENT,
),
SensorEntityDescription(
key="wind_bearing",
name="Wind Bearing",
native_unit_of_measurement=DEGREE,
),
SensorEntityDescription(
key="wind_chill",
name="Wind Chill",
device_class=SensorDeviceClass.TEMPERATURE,
native_unit_of_measurement=TEMP_CELSIUS,
state_class=SensorStateClass.MEASUREMENT,
),
SensorEntityDescription(
key="wind_dir",
name="Wind Direction",
),
SensorEntityDescription(
key="wind_gust",
name="Wind Gust",
native_unit_of_measurement=SPEED_KILOMETERS_PER_HOUR,
state_class=SensorStateClass.MEASUREMENT,
),
SensorEntityDescription(
key="wind_speed",
name="Wind Speed",
native_unit_of_measurement=SPEED_KILOMETERS_PER_HOUR,
state_class=SensorStateClass.MEASUREMENT,
),
)
ALERT_TYPES: tuple[SensorEntityDescription, ...] = (
SensorEntityDescription(
key="advisories",
name="Advisory",
icon="mdi:bell-alert",
),
SensorEntityDescription(
key="endings",
name="Endings",
icon="mdi:alert-circle-check",
),
SensorEntityDescription(
key="statements",
name="Statements",
icon="mdi:bell-alert",
),
SensorEntityDescription(
key="warnings",
name="Warnings",
icon="mdi:alert-octagon",
),
SensorEntityDescription(
key="watches",
name="Watches",
icon="mdi:alert",
),
)
_LOGGER = logging.getLogger(__name__)
@ -34,94 +215,74 @@ async def async_setup_entry(
) -> None:
"""Add a weather entity from a config_entry."""
coordinator = hass.data[DOMAIN][config_entry.entry_id]["weather_coordinator"]
weather_data = coordinator.ec_data
sensors = list(weather_data.conditions)
labels = [weather_data.conditions[sensor]["label"] for sensor in sensors]
alerts_list = list(weather_data.alerts)
labels = labels + [weather_data.alerts[sensor]["label"] for sensor in alerts_list]
sensors = sensors + alerts_list
async_add_entities(
[
ECSensor(coordinator, sensor, label)
for sensor, label in zip(sensors, labels)
],
True,
)
async_add_entities(ECSensor(coordinator, desc) for desc in SENSOR_TYPES)
async_add_entities(ECAlertSensor(coordinator, desc) for desc in ALERT_TYPES)
class ECSensor(CoordinatorEntity, SensorEntity):
"""Implementation of an Environment Canada sensor."""
class ECBaseSensor(CoordinatorEntity, SensorEntity):
"""Environment Canada sensor base."""
def __init__(self, coordinator, sensor, label):
"""Initialize the sensor."""
def __init__(self, coordinator, description):
"""Initialize the base sensor."""
super().__init__(coordinator)
self.sensor_type = sensor
self.ec_data = coordinator.ec_data
self.entity_description = description
self._ec_data = coordinator.ec_data
self._attr_attribution = self._ec_data.metadata["attribution"]
self._attr_name = f"{coordinator.config_entry.title} {description.name}"
self._attr_unique_id = f"{self._ec_data.metadata['location']}-{description.key}"
self._attr_attribution = self.ec_data.metadata["attribution"]
self._attr_name = f"{coordinator.config_entry.title} {label}"
self._attr_unique_id = f"{self.ec_data.metadata['location']}-{sensor}"
self._attr = None
self._unit = None
self._device_class = None
@property
def extra_state_attributes(self):
"""Return the state attributes of the device."""
return self._attr
class ECSensor(ECBaseSensor):
"""Environment Canada sensor for conditions."""
@property
def native_unit_of_measurement(self):
"""Return the units of measurement."""
return self._unit
@property
def device_class(self):
"""Return the class of this device, from component DEVICE_CLASSES."""
return self._device_class
def __init__(self, coordinator, description):
"""Initialize the sensor."""
super().__init__(coordinator, description)
self._attr_extra_state_attributes = {
ATTR_LOCATION: self._ec_data.metadata.get("location"),
ATTR_STATION: self._ec_data.metadata.get("station"),
}
@property
def native_value(self):
"""Update current conditions."""
metadata = self.ec_data.metadata
sensor_data = self.ec_data.conditions.get(self.sensor_type)
if not sensor_data:
sensor_data = self.ec_data.alerts.get(self.sensor_type)
sensor_type = self.entity_description.key
if sensor_type == "timestamp":
return self._ec_data.metadata.get("timestamp")
self._attr = {}
value = sensor_data.get("value")
if isinstance(value, list):
state = " | ".join([str(s.get("title")) for s in value])[:255]
self._attr.update(
{ATTR_TIME: " | ".join([str(s.get("date")) for s in value])}
)
elif self.sensor_type == "tendency":
state = str(value).capitalize()
value = self._ec_data.conditions.get(sensor_type, {}).get("value")
if sensor_type == "tendency":
value = str(value).capitalize()
elif isinstance(value, str) and len(value) > 255:
state = value[:255]
value = value[:255]
_LOGGER.info(
"Value for %s truncated to 255 characters", self._attr_unique_id
)
else:
state = value
return value
if sensor_data.get("unit") == "C" or self.sensor_type in (
"wind_chill",
"humidex",
):
self._unit = TEMP_CELSIUS
self._device_class = SensorDeviceClass.TEMPERATURE
else:
self._unit = sensor_data.get("unit")
self._attr.update(
{
ATTR_OBSERVATION_TIME: metadata.get("timestamp"),
ATTR_LOCATION: metadata.get("location"),
ATTR_STATION: metadata.get("station"),
}
)
return state
class ECAlertSensor(ECBaseSensor):
"""Environment Canada sensor for alerts."""
@property
def native_value(self):
"""Return the state."""
alert_name = self.entity_description.key
value = self._ec_data.alerts.get(alert_name, {}).get("value", [])
return len(value)
@property
def extra_state_attributes(self):
"""Return the extra state attributes."""
alert_name = self.entity_description.key
value = self._ec_data.alerts.get(alert_name, {}).get("value", [])
extra_state_attrs = {
ATTR_LOCATION: self._ec_data.metadata.get("location"),
ATTR_STATION: self._ec_data.metadata.get("station"),
}
for index, alert in enumerate(value, start=1):
extra_state_attrs[f"alert_{index}"] = alert.get("title")
extra_state_attrs[f"alert_time_{index}"] = alert.get("date")
return extra_state_attrs

View File

@ -87,6 +87,7 @@ class ECWeather(CoordinatorEntity, WeatherEntity):
self._attr_unique_id = (
f"{coordinator.config_entry.unique_id}{'-hourly' if hourly else '-daily'}"
)
self._attr_entity_registry_enabled_default = not hourly
self._hourly = hourly
@property