Refactor Plugwise select and add regulation_mode selector (#69210)

Co-authored-by: Franck Nijhof <frenck@frenck.nl>

homeassistant/components/plugwise/select.py

@@ -1,64 +1,113 @@
 """Plugwise Select component for Home Assistant."""
 from __future__ import annotations
 
-from homeassistant.components.select import SelectEntity
+from collections.abc import Awaitable, Callable
+from dataclasses import dataclass
+from typing import Any
+
+from plugwise import Smile
+
+from homeassistant.components.select import SelectEntity, SelectEntityDescription
 from homeassistant.config_entries import ConfigEntry
 from homeassistant.const import STATE_ON
 from homeassistant.core import HomeAssistant
-from homeassistant.exceptions import HomeAssistantError
+from homeassistant.helpers.entity import EntityCategory
 from homeassistant.helpers.entity_platform import AddEntitiesCallback
 
-from .const import DOMAIN, THERMOSTAT_CLASSES
+from .const import DOMAIN
 from .coordinator import PlugwiseDataUpdateCoordinator
 from .entity import PlugwiseEntity
 
 
+@dataclass
+class PlugwiseSelectDescriptionMixin:
+    """Mixin values for Plugwise Select entities."""
+
+    command: Callable[[Smile, str, str], Awaitable[Any]]
+    current_option: str
+    options: str
+
+
+@dataclass
+class PlugwiseSelectEntityDescription(
+    SelectEntityDescription, PlugwiseSelectDescriptionMixin
+):
+    """Class describing Plugwise Number entities."""
+
+
+SELECT_TYPES = (
+    PlugwiseSelectEntityDescription(
+        key="select_schedule",
+        name="Thermostat Schedule",
+        icon="mdi:calendar-clock",
+        command=lambda api, loc, opt: api.set_schedule_state(loc, opt, STATE_ON),
+        current_option="selected_schedule",
+        options="available_schedules",
+    ),
+    PlugwiseSelectEntityDescription(
+        key="select_regulation_mode",
+        name="Regulation Mode",
+        icon="mdi:hvac",
+        entity_category=EntityCategory.CONFIG,
+        command=lambda api, loc, opt: api.set_regulation_mode(opt),
+        current_option="regulation_mode",
+        options="regulation_modes",
+    ),
+)
+
+
 async def async_setup_entry(
     hass: HomeAssistant,
     config_entry: ConfigEntry,
     async_add_entities: AddEntitiesCallback,
 ) -> None:
     """Set up the Smile selector from a config entry."""
-    coordinator = hass.data[DOMAIN][config_entry.entry_id]
-    async_add_entities(
-        PlugwiseSelectEntity(coordinator, device_id)
-        for device_id, device in coordinator.data.devices.items()
-        if device["class"] in THERMOSTAT_CLASSES
-        and len(device.get("available_schedules")) > 1
-    )
+    coordinator: PlugwiseDataUpdateCoordinator = hass.data[DOMAIN][
+        config_entry.entry_id
+    ]
+
+    entities: list[PlugwiseSelectEntity] = []
+    for device_id, device in coordinator.data.devices.items():
+        for description in SELECT_TYPES:
+            if description.options in device and len(device[description.options]) > 1:
+                entities.append(
+                    PlugwiseSelectEntity(coordinator, device_id, description)
+                )
+
+    async_add_entities(entities)
 
 
 class PlugwiseSelectEntity(PlugwiseEntity, SelectEntity):
     """Represent Smile selector."""
 
+    entity_description: PlugwiseSelectEntityDescription
+
     def __init__(
         self,
         coordinator: PlugwiseDataUpdateCoordinator,
         device_id: str,
+        entity_description: PlugwiseSelectEntityDescription,
     ) -> None:
         """Initialise the selector."""
         super().__init__(coordinator, device_id)
-        self._attr_unique_id = f"{device_id}-select_schedule"
-        self._attr_name = (f"{self.device.get('name', '')} Select Schedule").lstrip()
+        self.entity_description = entity_description
+        self._attr_unique_id = f"{device_id}-{entity_description.key}"
+        self._attr_name = (f"{self.device['name']} {entity_description.name}").lstrip()
 
     @property
-    def current_option(self) -> str | None:
+    def current_option(self) -> str:
         """Return the selected entity option to represent the entity state."""
-        return self.device.get("selected_schedule")
+        return self.device[self.entity_description.current_option]
 
     @property
     def options(self) -> list[str]:
-        """Return a set of selectable options."""
-        return self.device.get("available_schedules", [])
+        """Return the selectable entity options."""
+        return self.device[self.entity_description.options]
 
     async def async_select_option(self, option: str) -> None:
-        """Change the selected option."""
-        if not (
-            await self.coordinator.api.set_schedule_state(
-                self.device.get("location"),
-                option,
-                STATE_ON,
-            )
-        ):
-            raise HomeAssistantError(f"Failed to change to schedule {option}")
+        """Change to the selected entity option."""
+        await self.entity_description.command(
+            self.coordinator.api, self.device["location"], option
+        )
+
         await self.coordinator.async_request_refresh()