- major: probe_template прекращает перебор на unreachable/no_slots/key_error (недоступный модуль: ~10 c вместо ~49 c), продолжает только при properties_missing (доступен, но чужой шаблон); +тест - m1: extra_state_attributes не падает до добавления в hass - m2: reconfigure берёт сохранённый шаблон как дефолт (не пересчитывает по модели); +тест - m3: device_capabilities/display_temperature переведены в необязательные зонды (trial не падает на молчащем caps; feature-модель трактует None как «не режем») - m4: async_sync_now(online_timeout) — честное имя/докстринг - ниты: удалены PRESET_CAP/as_dict/лишние плейсхолдеры, DIRECTION_KEYS упрощён, тавтология в тесте исправлена, en-тире - 59 components + 47 pyfglair/acceptance зелёные
78 lines
2.7 KiB
Python
78 lines
2.7 KiB
Python
"""Базовая сущность fglair: DeviceInfo, значения из координатора."""
|
|
from __future__ import annotations
|
|
|
|
from typing import Optional
|
|
|
|
from homeassistant.helpers.device_registry import DeviceInfo
|
|
from homeassistant.helpers.update_coordinator import CoordinatorEntity
|
|
|
|
from pyfglair import Prop, Value
|
|
|
|
from .const import (
|
|
CONF_DSN,
|
|
CONF_MODEL,
|
|
CONF_NAME,
|
|
DOMAIN,
|
|
entity_description,
|
|
)
|
|
from .coordinator import FglairCoordinator
|
|
|
|
|
|
class FglairEntity(CoordinatorEntity[FglairCoordinator]):
|
|
"""Общий базис: unique_id = <dsn>_<key>, device_info — один прибор."""
|
|
|
|
_attr_has_entity_name = True
|
|
|
|
def __init__(
|
|
self,
|
|
coordinator: FglairCoordinator,
|
|
unique_suffix: str,
|
|
translation_key: Optional[str],
|
|
description_key: Optional[str] = None,
|
|
) -> None:
|
|
super().__init__(coordinator)
|
|
data = coordinator.client.data
|
|
dsn = data[CONF_DSN]
|
|
self._attr_unique_id = f"{dsn}_{unique_suffix}"
|
|
if translation_key is not None:
|
|
self._attr_translation_key = translation_key
|
|
self._description_key = description_key or translation_key
|
|
self._attr_device_info = DeviceInfo(
|
|
identifiers={(DOMAIN, dsn)},
|
|
name=data.get(CONF_NAME) or dsn,
|
|
manufacturer="Fujitsu General",
|
|
model=data.get(CONF_MODEL) or None,
|
|
)
|
|
|
|
@property
|
|
def available(self) -> bool:
|
|
return self.coordinator.data.available and super().available
|
|
|
|
@property
|
|
def extra_state_attributes(self) -> Optional[dict]:
|
|
"""HA не поддерживает тултипы сущностей: краткое описание видно в
|
|
атрибутах (More info → Атрибуты)."""
|
|
if self._description_key is None or self.hass is None:
|
|
return None
|
|
text = entity_description(self.hass.config.language, self._description_key)
|
|
return {"description": text} if text else None
|
|
|
|
def feature_enabled(self, key: str) -> bool:
|
|
return self.coordinator.features.enabled(key)
|
|
|
|
def value(self, prop: Prop) -> Optional[Value]:
|
|
return self.coordinator.data.values.get(prop)
|
|
|
|
def raw_value(self, prop: Prop) -> Optional[int]:
|
|
value = self.value(prop)
|
|
return value.int_value if value is not None else None
|
|
|
|
def display_value(self, prop: Prop) -> Optional[int]:
|
|
"""Значение свойства в единицах отображения (с ручной конверсией)."""
|
|
raw = self.raw_value(prop)
|
|
if raw is None:
|
|
return None
|
|
return self.coordinator.conversions.to_display(prop, raw)
|
|
|
|
|