core/homeassistant/components/shelly/text.py

90 lines
2.4 KiB
Python

"""Text for Shelly."""
from __future__ import annotations
from dataclasses import dataclass
from typing import TYPE_CHECKING, Final
from aioshelly.const import RPC_GENERATIONS
from homeassistant.components.text import (
DOMAIN as TEXT_PLATFORM,
TextEntity,
TextEntityDescription,
)
from homeassistant.core import HomeAssistant
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from .coordinator import ShellyConfigEntry
from .entity import (
RpcEntityDescription,
ShellyRpcAttributeEntity,
async_setup_entry_rpc,
)
from .utils import (
async_remove_orphaned_entities,
get_device_entry_gen,
get_virtual_component_ids,
)
@dataclass(frozen=True, kw_only=True)
class RpcTextDescription(RpcEntityDescription, TextEntityDescription):
"""Class to describe a RPC text entity."""
RPC_TEXT_ENTITIES: Final = {
"text": RpcTextDescription(
key="text",
sub_key="value",
has_entity_name=True,
),
}
async def async_setup_entry(
hass: HomeAssistant,
config_entry: ShellyConfigEntry,
async_add_entities: AddEntitiesCallback,
) -> None:
"""Set up sensors for device."""
if get_device_entry_gen(config_entry) in RPC_GENERATIONS:
coordinator = config_entry.runtime_data.rpc
assert coordinator
async_setup_entry_rpc(
hass, config_entry, async_add_entities, RPC_TEXT_ENTITIES, RpcText
)
# the user can remove virtual components from the device configuration, so
# we need to remove orphaned entities
virtual_text_ids = get_virtual_component_ids(
coordinator.device.config, TEXT_PLATFORM
)
async_remove_orphaned_entities(
hass,
config_entry.entry_id,
coordinator.mac,
TEXT_PLATFORM,
virtual_text_ids,
"text",
)
class RpcText(ShellyRpcAttributeEntity, TextEntity):
"""Represent a RPC text entity."""
entity_description: RpcTextDescription
@property
def native_value(self) -> str | None:
"""Return value of sensor."""
if TYPE_CHECKING:
assert isinstance(self.attribute_value, str | None)
return self.attribute_value
async def async_set_value(self, value: str) -> None:
"""Change the value."""
await self.call_rpc("Text.Set", {"id": self._id, "value": value})