0.1.2: options flow for poll interval + history window

Users can now reach Settings → Devices & Services → ⋮ → Configure to
change two runtime knobs that were previously hard-coded:

* Polling interval — dropdown of 30 min / 1h / 3h / 6h (default) / 12h
  / 24h. Pushed onto the coordinator in-place via add_update_listener,
  so changes take effect on the next tick without reloading the entry.

* History window (1–60 days) — how far back the coordinator pulls on
  every refresh. Read fresh from entry.options each poll, no listener
  needed.

A description in the form warns the user that polling more often than
6 hours does not produce a smoother Energy Dashboard graph: the EAC
portal updates daily and 30-min profile data already lags by hours.
The real fix for graph density is statistics import (planned).

Coordinator no longer uses const-level SCAN_INTERVAL / HISTORY_DAYS;
those are replaced by defaults + per-entry options. Bumps manifest
version 0.1.1 → 0.1.2. EN and RU translations updated.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: SantaFox

custom_components/eac_cyprus/__init__.py

@@ -33,9 +33,16 @@ async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
 
     hass.data.setdefault(DOMAIN, {})[entry.entry_id] = coordinator
     await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS)
+    entry.async_on_unload(entry.add_update_listener(_async_options_updated))
     return True
 
 
+async def _async_options_updated(hass: HomeAssistant, entry: ConfigEntry) -> None:
+    """Apply changes from the options flow without reloading the entry."""
+    coordinator: EacCoordinator = hass.data[DOMAIN][entry.entry_id]
+    coordinator.apply_options()
+
+
 async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
     """Unload a config entry."""
     unloaded = await hass.config_entries.async_unload_platforms(entry, PLATFORMS)

custom_components/eac_cyprus/config_flow.py

@@ -7,11 +7,29 @@
 import aiohttp
 import voluptuous as vol
 
-from homeassistant.config_entries import ConfigFlow, ConfigFlowResult
+from homeassistant.config_entries import (
+    ConfigEntry,
+    ConfigFlow,
+    ConfigFlowResult,
+    OptionsFlow,
+)
+from homeassistant.core import callback
+from homeassistant.helpers import selector
 from homeassistant.helpers.aiohttp_client import async_get_clientsession
 
 from eac_dso_portal import EacApiError, EacAuthError, EacClient
-from .const import CONF_BASE_URL, CONF_EMAIL, CONF_PASSWORD, DEFAULT_BASE_URL, DOMAIN
+from .const import (
+    CONF_BASE_URL,
+    CONF_EMAIL,
+    CONF_HISTORY_DAYS,
+    CONF_PASSWORD,
+    CONF_SCAN_INTERVAL_MINUTES,
+    DEFAULT_BASE_URL,
+    DEFAULT_HISTORY_DAYS,
+    DEFAULT_SCAN_INTERVAL_MINUTES,
+    DOMAIN,
+    SCAN_INTERVAL_CHOICES,
+)
 
 _LOGGER = logging.getLogger(__name__)
 
@@ -29,10 +47,17 @@ class EacConfigFlow(ConfigFlow, domain=DOMAIN):
 
     The portal account is per-email and unique; we use the email as the unique
     id of the config entry, preventing duplicate entries for the same account.
+    Editable runtime settings (poll interval, history window) live in the
+    options flow below.
     """
 
     VERSION = 1
 
+    @staticmethod
+    @callback
+    def async_get_options_flow(config_entry: ConfigEntry) -> OptionsFlow:
+        return EacOptionsFlow()
+
     async def async_step_user(
         self, user_input: dict[str, Any] | None = None
     ) -> ConfigFlowResult:
@@ -74,3 +99,64 @@ async def async_step_user(
         return self.async_show_form(
             step_id="user", data_schema=STEP_USER_SCHEMA, errors=errors
         )
+
+
+# Human labels for the polling-interval dropdown.
+_INTERVAL_LABELS: dict[int, str] = {
+    30: "30 minutes",
+    60: "1 hour",
+    180: "3 hours",
+    360: "6 hours (recommended)",
+    720: "12 hours",
+    1440: "24 hours",
+}
+
+
+class EacOptionsFlow(OptionsFlow):
+    """Editable runtime settings: polling cadence and history window."""
+
+    async def async_step_init(
+        self, user_input: dict[str, Any] | None = None
+    ) -> ConfigFlowResult:
+        if user_input is not None:
+            # The select selector hands back strings; coerce to int once.
+            user_input[CONF_SCAN_INTERVAL_MINUTES] = int(
+                user_input[CONF_SCAN_INTERVAL_MINUTES]
+            )
+            return self.async_create_entry(title="", data=user_input)
+
+        current = self.config_entry.options
+        current_interval = current.get(
+            CONF_SCAN_INTERVAL_MINUTES, DEFAULT_SCAN_INTERVAL_MINUTES
+        )
+        current_history = current.get(CONF_HISTORY_DAYS, DEFAULT_HISTORY_DAYS)
+
+        schema = vol.Schema(
+            {
+                vol.Required(
+                    CONF_SCAN_INTERVAL_MINUTES, default=str(current_interval)
+                ): selector.SelectSelector(
+                    selector.SelectSelectorConfig(
+                        options=[
+                            selector.SelectOptionDict(
+                                value=str(m), label=_INTERVAL_LABELS[m]
+                            )
+                            for m in SCAN_INTERVAL_CHOICES
+                        ],
+                        mode=selector.SelectSelectorMode.DROPDOWN,
+                    ),
+                ),
+                vol.Required(
+                    CONF_HISTORY_DAYS, default=current_history
+                ): selector.NumberSelector(
+                    selector.NumberSelectorConfig(
+                        min=1,
+                        max=60,
+                        step=1,
+                        mode=selector.NumberSelectorMode.BOX,
+                        unit_of_measurement="days",
+                    ),
+                ),
+            }
+        )
+        return self.async_show_form(step_id="init", data_schema=schema)

custom_components/eac_cyprus/const.py

@@ -1,23 +1,27 @@
 """Constants for the EAC Cyprus integration."""
 from __future__ import annotations
 
-from datetime import timedelta
-
 DOMAIN = "eac_cyprus"
 
 CONF_EMAIL = "email"
 CONF_PASSWORD = "password"
 CONF_BASE_URL = "base_url"
 
+# Runtime-tunable options (config entry .options dict).
+CONF_SCAN_INTERVAL_MINUTES = "scan_interval_minutes"
+CONF_HISTORY_DAYS = "history_days"
+
 DEFAULT_BASE_URL = "https://meterreading-dso.eac.com.cy"
 
-# Smart-meter daily values arrive with several hours of lag from the DSO.
-# Polling more often gains nothing, so we stay polite.
-SCAN_INTERVAL = timedelta(hours=6)
+# 6h is plenty: the EAC portal updates daily and 30-min profile data lags by
+# hours, so polling more often gains nothing in practice.
+DEFAULT_SCAN_INTERVAL_MINUTES = 360
+
+# Pulling a few days of history on every refresh lets us recover gracefully
+# from missed reports (e.g. the integration was down or network blipped).
+DEFAULT_HISTORY_DAYS = 14
 
-# How much history to fetch on every refresh. The cumulative meter reading is
-# used as the sensor state, so we only need the latest value, but pulling a
-# few days lets us recover gracefully from missed reports.
-HISTORY_DAYS = 14
+# Values offered in the options-flow dropdown (minutes).
+SCAN_INTERVAL_CHOICES: tuple[int, ...] = (30, 60, 180, 360, 720, 1440)
 
 MANUFACTURER = "EAC (Electricity Authority of Cyprus)"

custom_components/eac_cyprus/coordinator.py

@@ -20,7 +20,13 @@
     ServicePoint,
     UserDetails,
 )
-from .const import DOMAIN, HISTORY_DAYS, SCAN_INTERVAL
+from .const import (
+    CONF_HISTORY_DAYS,
+    CONF_SCAN_INTERVAL_MINUTES,
+    DEFAULT_HISTORY_DAYS,
+    DEFAULT_SCAN_INTERVAL_MINUTES,
+    DOMAIN,
+)
 
 _LOGGER = logging.getLogger(__name__)
 
@@ -56,11 +62,20 @@ def __init__(self, hass: HomeAssistant, client: EacClient, entry: ConfigEntry) -
             hass,
             _LOGGER,
             name=f"{DOMAIN} ({entry.title})",
-            update_interval=SCAN_INTERVAL,
+            update_interval=_interval_from_options(entry),
         )
         self._client = client
         self._entry = entry
 
+    def apply_options(self) -> None:
+        """Re-read the config entry's options and adjust polling cadence.
+
+        Called by the options-flow update listener. ``history_days`` is read
+        on every refresh, so only the poll interval needs to be propagated
+        here. The new value takes effect on the next scheduled tick.
+        """
+        self.update_interval = _interval_from_options(self._entry)
+
     async def _async_update_data(self) -> EacData:
         try:
             user = await self._client.get_user_details()
@@ -71,7 +86,8 @@ async def _async_update_data(self) -> EacData:
             raise UpdateFailed(f"API error: {err}") from err
 
         end = datetime.now(UTC)
-        start = end - timedelta(days=HISTORY_DAYS)
+        history_days = self._entry.options.get(CONF_HISTORY_DAYS, DEFAULT_HISTORY_DAYS)
+        start = end - timedelta(days=history_days)
 
         points: dict[str, ServicePointState] = {}
         for sp in sps:
@@ -123,3 +139,10 @@ def _latest_reading(channels: list[ChannelReadings], channel_id: str) -> Reading
             continue
         return max(cr.readings, key=lambda r: r.dt)
     return None
+
+
+def _interval_from_options(entry: ConfigEntry) -> timedelta:
+    minutes = entry.options.get(
+        CONF_SCAN_INTERVAL_MINUTES, DEFAULT_SCAN_INTERVAL_MINUTES
+    )
+    return timedelta(minutes=int(minutes))

custom_components/eac_cyprus/manifest.json

@@ -9,5 +9,5 @@
   "iot_class": "cloud_polling",
   "issue_tracker": "https://github.com/SantaFox/ha-eac/issues",
   "requirements": ["eac-dso-portal==0.1.0"],
-  "version": "0.1.1"
+  "version": "0.1.2"
 }

custom_components/eac_cyprus/strings.json

@@ -19,5 +19,17 @@
     "abort": {
       "already_configured": "This account is already configured."
     }
+  },
+  "options": {
+    "step": {
+      "init": {
+        "title": "EAC settings",
+        "description": "Heads-up: the portal updates daily and 30-min profile data lags by hours. Polling more often than 6 hours does not give a smoother Energy Dashboard graph — for that you need statistics import (planned).",
+        "data": {
+          "scan_interval_minutes": "Polling interval",
+          "history_days": "History window (days fetched on each refresh)"
+        }
+      }
+    }
   }
 }

custom_components/eac_cyprus/translations/en.json

@@ -19,5 +19,17 @@
     "abort": {
       "already_configured": "This account is already configured."
     }
+  },
+  "options": {
+    "step": {
+      "init": {
+        "title": "EAC settings",
+        "description": "Heads-up: the portal updates daily and 30-min profile data lags by hours. Polling more often than 6 hours does not give a smoother Energy Dashboard graph — for that you need statistics import (planned).",
+        "data": {
+          "scan_interval_minutes": "Polling interval",
+          "history_days": "History window (days fetched on each refresh)"
+        }
+      }
+    }
   }
 }

custom_components/eac_cyprus/translations/ru.json

@@ -19,5 +19,17 @@
     "abort": {
       "already_configured": "Этот аккаунт уже добавлен."
     }
+  },
+  "options": {
+    "step": {
+      "init": {
+        "title": "Настройки EAC",
+        "description": "Имейте в виду: портал обновляет данные раз в сутки, а 30-минутный профиль приходит с задержкой в часы. Опрос чаще 6 часов не сделает график Energy Dashboard плотнее — для этого нужен импорт statistics (в плане).",
+        "data": {
+          "scan_interval_minutes": "Интервал опроса",
+          "history_days": "Окно истории (за сколько дней тянуть на каждом опросе)"
+        }
+      }
+    }
   }
 }