1
mirror of https://github.com/home-assistant/core synced 2024-08-28 03:36:46 +02:00
ha-core/homeassistant/components/wemo/sensor.py
Erik Montnemery 0c2485bc03
Freeze integration entity descriptions (#105984)
Co-authored-by: J. Nick Koston <nick@koston.org>
2023-12-18 16:28:13 -10:00

108 lines
3.5 KiB
Python

"""Support for power sensors in WeMo Insight devices."""
from __future__ import annotations
from collections.abc import Callable
from dataclasses import dataclass
from typing import cast
from homeassistant.components.sensor import (
SensorDeviceClass,
SensorEntity,
SensorEntityDescription,
SensorStateClass,
)
from homeassistant.config_entries import ConfigEntry
from homeassistant.const import UnitOfEnergy, UnitOfPower
from homeassistant.core import HomeAssistant
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.typing import StateType
from . import async_wemo_dispatcher_connect
from .entity import WemoEntity
from .wemo_device import DeviceCoordinator
@dataclass(frozen=True)
class AttributeSensorDescription(SensorEntityDescription):
"""SensorEntityDescription for WeMo AttributeSensor entities."""
# AttributeSensor does not support UNDEFINED,
# restrict the type to str | None.
name: str | None = None
state_conversion: Callable[[StateType], StateType] | None = None
unique_id_suffix: str | None = None
ATTRIBUTE_SENSORS = (
AttributeSensorDescription(
name="Current Power",
device_class=SensorDeviceClass.POWER,
state_class=SensorStateClass.MEASUREMENT,
native_unit_of_measurement=UnitOfPower.WATT,
key="current_power_watts",
unique_id_suffix="currentpower",
state_conversion=lambda state: round(cast(float, state), 2),
),
AttributeSensorDescription(
name="Today Energy",
device_class=SensorDeviceClass.ENERGY,
state_class=SensorStateClass.TOTAL_INCREASING,
native_unit_of_measurement=UnitOfEnergy.KILO_WATT_HOUR,
key="today_kwh",
unique_id_suffix="todaymw",
state_conversion=lambda state: round(cast(float, state), 2),
),
)
async def async_setup_entry(
hass: HomeAssistant,
_config_entry: ConfigEntry,
async_add_entities: AddEntitiesCallback,
) -> None:
"""Set up WeMo sensors."""
async def _discovered_wemo(coordinator: DeviceCoordinator) -> None:
"""Handle a discovered Wemo device."""
async_add_entities(
AttributeSensor(coordinator, description)
for description in ATTRIBUTE_SENSORS
if hasattr(coordinator.wemo, description.key)
)
await async_wemo_dispatcher_connect(hass, _discovered_wemo)
class AttributeSensor(WemoEntity, SensorEntity):
"""Sensor that reads attributes of a wemo device."""
entity_description: AttributeSensorDescription
def __init__(
self, coordinator: DeviceCoordinator, description: AttributeSensorDescription
) -> None:
"""Init AttributeSensor."""
super().__init__(coordinator)
self.entity_description = description
@property
def name_suffix(self) -> str | None:
"""Return the name of the entity."""
return self.entity_description.name
@property
def unique_id_suffix(self) -> str | None:
"""Suffix to append to the WeMo device's unique ID."""
return self.entity_description.unique_id_suffix
def convert_state(self, value: StateType) -> StateType:
"""Convert native state to a value appropriate for the sensor."""
if (convert := self.entity_description.state_conversion) is None:
return None
return convert(value)
@property
def native_value(self) -> StateType:
"""Return the value of the device attribute."""
return self.convert_state(getattr(self.wemo, self.entity_description.key))