dimplex-controller 0.13.0__tar.gz → 0.14.0__tar.gz

{dimplex_controller-0.13.0 → dimplex_controller-0.14.0}/PKG-INFO

@@ -1,15 +1,13 @@
 Metadata-Version: 2.4
 Name: dimplex-controller
-Version: 0.13.0
-Summary: Python client for Dimplex heating controllers (GDHV IoT)
-License: MIT
-License-File: LICENSE
+Version: 0.14.0
+Summary: Unofficial async Python client for Dimplex (GDHV IoT) heating appliances — not affiliated with Glen Dimplex
 Keywords: dimplex,heating,control,iot,asyncio
 Author: Kieran Roper
-Requires-Python: >=3.10,<4.0
+License-Expression: MIT
+License-File: LICENSE
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
@@ -19,8 +17,9 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Home Automation
-Requires-Dist: aiohttp (>=3.9.0,<4.0.0)
-Requires-Dist: pydantic (>=2.0.0,<3.0.0)
+Requires-Dist: aiohttp>=3.14.3,<4
+Requires-Dist: pydantic>=2.13.5,<3
+Requires-Python: >=3.10, <4.0
 Project-URL: Homepage, https://github.com/KRoperUK/dimplex-controller-py
 Project-URL: Repository, https://github.com/KRoperUK/dimplex-controller-py
 Description-Content-Type: text/markdown
@@ -40,14 +39,24 @@ Description-Content-Type: text/markdown
 
 ---
 
+> [!IMPORTANT]
+> **Unofficial library.** Not affiliated with, endorsed by, or supported by Dimplex, Glen
+> Dimplex Heating & Ventilation (GDHV), or the Glen Dimplex Group. This is an independent
+> project built by **reverse-engineering** the official Dimplex Control Android app and the
+> private cloud API it talks to.
+>
+> There is no public or documented API. Dimplex can change or withdraw that API at any time
+> and without notice, which may break this library. Use it at your own risk.
+>
+> No Dimplex code is included or redistributed. "Dimplex", "Quantum", "QRAD" and related
+> marks belong to their respective owners and are used here only to describe compatibility.
+
 ## What does this do?
 
 `dimplex-controller-py` is an asynchronous Python client that talks to the GDHV IoT cloud platform. It handles Azure B2C authentication (including automatic token refresh), discovers your Hubs, Zones and Appliances, and lets you read telemetry and send control commands — all from a script or a larger application.
 
 It is the engine behind the [Dimplex Hub Home Assistant integration](https://github.com/KRoperUK/dimplex-controller-hass) and is published to PyPI as [`dimplex-controller`](https://pypi.org/project/dimplex-controller/).
 
-> **Note:** This is an unofficial library and is not affiliated with or endorsed by Glen Dimplex Heating & Ventilation (GDHV). Use it at your own risk.
-
 ## Contents
 
 - [Features](#features)
@@ -94,9 +103,12 @@ pip install .
 ```bash
 git clone https://github.com/KRoperUK/dimplex-controller-py.git
 cd dimplex-controller-py
-pip install -e ".[dev]"
+uv sync
 ```
 
+`uv sync` creates `.venv`, installs the library in editable mode, and installs the
+dev dependency group from `uv.lock`.
+
 > **Requires:** Python 3.10 or later.
 
 ## Quick start
@@ -186,8 +198,9 @@ await client.set_open_window_detection(hub_id, [appliance_id], True)
 # Timed Boost (ApplianceModes=2, Time = minutes)
 await client.set_boost(hub_id, [appliance_id], temperature=25.0, duration_minutes=60)
 
-# Away until a given moment (ApplianceModes=4). Away is a settable 7–30 °C
-# setback and defaults to the 7 °C anti-freeze floor.
+# Away until a given moment (ApplianceModes=4). Away is a settable 7–18 °C
+# setback and defaults to the 7 °C anti-freeze floor. A higher temperature is
+# clamped to 18 °C with a warning, matching what the cloud does to it anyway.
 from datetime import datetime, timedelta, timezone
 
 await client.set_away(
@@ -292,7 +305,7 @@ Main client class. Construct with an `aiohttp.ClientSession` and a `refresh_toke
 
 - **`DimplexError`** — Base exception.
 - **`DimplexAuthError`** — Authentication or token errors.
-- **`DimplexApiError`** — API returned a non-success status. Contains `status` and `message`.
+- **`DimplexApiError`** — API returned a non-success status. Contains `status`, `message`, `transient` (`True` for a 5xx/429 raised after retries were exhausted, so a caller can back off rather than surface it) and an optional `code`.
 - **`DimplexConnectionError`** — Network-level failures.
 
 ## Troubleshooting
@@ -389,4 +402,3 @@ Key points:
 ## Changelog
 
 See [CHANGELOG.md](CHANGELOG.md) for version history.
-

{dimplex_controller-0.13.0 → dimplex_controller-0.14.0}/README.md

@@ -13,14 +13,24 @@
 
 ---
 
+> [!IMPORTANT]
+> **Unofficial library.** Not affiliated with, endorsed by, or supported by Dimplex, Glen
+> Dimplex Heating & Ventilation (GDHV), or the Glen Dimplex Group. This is an independent
+> project built by **reverse-engineering** the official Dimplex Control Android app and the
+> private cloud API it talks to.
+>
+> There is no public or documented API. Dimplex can change or withdraw that API at any time
+> and without notice, which may break this library. Use it at your own risk.
+>
+> No Dimplex code is included or redistributed. "Dimplex", "Quantum", "QRAD" and related
+> marks belong to their respective owners and are used here only to describe compatibility.
+
 ## What does this do?
 
 `dimplex-controller-py` is an asynchronous Python client that talks to the GDHV IoT cloud platform. It handles Azure B2C authentication (including automatic token refresh), discovers your Hubs, Zones and Appliances, and lets you read telemetry and send control commands — all from a script or a larger application.
 
 It is the engine behind the [Dimplex Hub Home Assistant integration](https://github.com/KRoperUK/dimplex-controller-hass) and is published to PyPI as [`dimplex-controller`](https://pypi.org/project/dimplex-controller/).
 
-> **Note:** This is an unofficial library and is not affiliated with or endorsed by Glen Dimplex Heating & Ventilation (GDHV). Use it at your own risk.
-
 ## Contents
 
 - [Features](#features)
@@ -67,9 +77,12 @@ pip install .
 ```bash
 git clone https://github.com/KRoperUK/dimplex-controller-py.git
 cd dimplex-controller-py
-pip install -e ".[dev]"
+uv sync
 ```
 
+`uv sync` creates `.venv`, installs the library in editable mode, and installs the
+dev dependency group from `uv.lock`.
+
 > **Requires:** Python 3.10 or later.
 
 ## Quick start
@@ -159,8 +172,9 @@ await client.set_open_window_detection(hub_id, [appliance_id], True)
 # Timed Boost (ApplianceModes=2, Time = minutes)
 await client.set_boost(hub_id, [appliance_id], temperature=25.0, duration_minutes=60)
 
-# Away until a given moment (ApplianceModes=4). Away is a settable 7–30 °C
-# setback and defaults to the 7 °C anti-freeze floor.
+# Away until a given moment (ApplianceModes=4). Away is a settable 7–18 °C
+# setback and defaults to the 7 °C anti-freeze floor. A higher temperature is
+# clamped to 18 °C with a warning, matching what the cloud does to it anyway.
 from datetime import datetime, timedelta, timezone
 
 await client.set_away(
@@ -265,7 +279,7 @@ Main client class. Construct with an `aiohttp.ClientSession` and a `refresh_toke
 
 - **`DimplexError`** — Base exception.
 - **`DimplexAuthError`** — Authentication or token errors.
-- **`DimplexApiError`** — API returned a non-success status. Contains `status` and `message`.
+- **`DimplexApiError`** — API returned a non-success status. Contains `status`, `message`, `transient` (`True` for a 5xx/429 raised after retries were exhausted, so a caller can back off rather than surface it) and an optional `code`.
 - **`DimplexConnectionError`** — Network-level failures.
 
 ## Troubleshooting

{dimplex_controller-0.13.0 → dimplex_controller-0.14.0}/dimplex_controller/__init__.py

@@ -1,7 +1,10 @@
 """Dimplex Controller Client.
 
-Async Python client for the Glen Dimplex Heating & Ventilation (GDHV) cloud
-API. See :class:`~dimplex_controller.client.DimplexControl` for the entry
+Unofficial async Python client for the Glen Dimplex Heating & Ventilation
+(GDHV) cloud API. Not affiliated with, endorsed by, or supported by Dimplex
+or the Glen Dimplex Group: the protocol was recovered by reverse-engineering
+the official Dimplex Control Android app, so Dimplex may change or withdraw
+it without notice. See :class:`~dimplex_controller.client.DimplexControl` for the entry
 point and :meth:`DimplexControl.get_appliance_overview` for the read path
 used by the Home Assistant integration.
 
@@ -15,6 +18,8 @@ from .auth import TokenBundle, TokenListener
 from .capabilities import ApplianceCapabilities, capabilities_for
 from .client import DimplexControl
 from .const import (
+    AWAY_TEMP_MAX,
+    AWAY_TEMP_MIN,
     DEFAULT_AWAY_TEMPERATURE,
     DEFAULT_BOOST_TEMPERATURE,
     FROST_TEMPERATURE,
@@ -84,6 +89,8 @@ __all__ = [
     "TsiEnergyReport",
     "DEFAULT_AWAY_TEMPERATURE",
     "DEFAULT_BOOST_TEMPERATURE",
+    "AWAY_TEMP_MIN",
+    "AWAY_TEMP_MAX",
     "FROST_TEMPERATURE",
     "MODE_TEMP_MIN",
     "MODE_TEMP_MAX",

{dimplex_controller-0.13.0 → dimplex_controller-0.14.0}/dimplex_controller/capabilities.py

@@ -9,7 +9,7 @@ from __future__ import annotations
 from dataclasses import dataclass
 from typing import Any
 
-from .const import FROST_TEMPERATURE, MODE_TEMP_MAX, MODE_TEMP_MIN
+from .const import AWAY_TEMP_MAX, AWAY_TEMP_MIN, FROST_TEMPERATURE, MODE_TEMP_MAX, MODE_TEMP_MIN
 from .models import Appliance, ApplianceStatus, AutomaticProvisioning, ProductModel
 
 # Default boost lengths (minutes) offered by the mobile app for most heaters.
@@ -47,6 +47,11 @@ class ApplianceCapabilities:
     climate: bool = True
     min_temp: float = MODE_TEMP_MIN
     max_temp: float = MODE_TEMP_MAX
+    # Away is the one carousel with its own bounds: it shares the 7 °C floor but
+    # stops at 18 °C rather than 30 °C (dimplex-controller-py#98). Consumers
+    # should gate the Away picker on these rather than on min_temp/max_temp.
+    away_min_temp: float = AWAY_TEMP_MIN
+    away_max_temp: float = AWAY_TEMP_MAX
     frost_temp: float = FROST_TEMPERATURE
     default_boost_minutes: int = DEFAULT_BOOST_MINUTES
     boost_durations: tuple[int, ...] = DEFAULT_BOOST_DURATIONS
@@ -83,6 +88,8 @@ class ApplianceCapabilities:
             "climate": self.climate,
             "min_temp": self.min_temp,
             "max_temp": self.max_temp,
+            "away_min_temp": self.away_min_temp,
+            "away_max_temp": self.away_max_temp,
             "frost_temp": self.frost_temp,
             "default_boost_minutes": self.default_boost_minutes,
             "boost_durations": list(self.boost_durations),

{dimplex_controller-0.13.0 → dimplex_controller-0.14.0}/dimplex_controller/client.py

@@ -12,6 +12,8 @@ import aiohttp
 from .auth import AuthManager, TokenBundle, TokenListener
 from .capabilities import ApplianceCapabilities, capabilities_for
 from .const import (
+    AWAY_TEMP_MAX,
+    AWAY_TEMP_MIN,
     BASE_URL,
     DEFAULT_AWAY_TEMPERATURE,
     DEFAULT_BOOST_TEMPERATURE,
@@ -70,6 +72,26 @@ _RETRYABLE_STATUS = frozenset({429, 500, 502, 503, 504})
 DEFAULT_TIMEOUT = 30.0
 
 
+def _clamp_away_temperature(temperature: float) -> float:
+    """Clamp an Away target into the mode's own 7–18 °C range.
+
+    The cloud reduces a higher value silently, so clamping here keeps the value
+    the caller asked for and the value the appliance ends up at in agreement,
+    and the warning makes the adjustment visible.
+    """
+    value = float(temperature)
+    clamped = min(max(value, AWAY_TEMP_MIN), AWAY_TEMP_MAX)
+    if clamped != value:
+        _LOGGER.warning(
+            "Away temperature %.1f °C is outside the %s–%s °C the app offers for Away; using %.1f °C",
+            value,
+            AWAY_TEMP_MIN,
+            AWAY_TEMP_MAX,
+            clamped,
+        )
+    return clamped
+
+
 def _coerce_timeout(timeout: float | aiohttp.ClientTimeout | None) -> aiohttp.ClientTimeout | None:
     """Normalise a timeout value into an :class:`aiohttp.ClientTimeout`.
 
@@ -252,12 +274,14 @@ class DimplexControl:
                             attempts - 1,
                             delay,
                         )
-                        last_error = DimplexApiError(resp.status, text)
+                        last_error = DimplexApiError(resp.status, text, transient=resp.status in _RETRYABLE_STATUS)
                         await asyncio.sleep(delay)
                         continue
 
                     _LOGGER.error("API request failed: %s - %s", resp.status, text)
-                    raise DimplexApiError(resp.status, text)
+                    # A 5xx/429 that reaches here was retried and still failed, so it
+                    # is transient (back off); a 4xx is a hard failure (surface it).
+                    raise DimplexApiError(resp.status, text, transient=resp.status in _RETRYABLE_STATUS)
             except (aiohttp.ClientError, asyncio.TimeoutError) as e:
                 if allow_retry and attempt + 1 < attempts:
                     delay = self._backoff_seconds(attempt)
@@ -325,7 +349,7 @@ class DimplexControl:
         """Get details for a specific zone."""
         payload = {"HubId": hub_id, "ZoneId": zone_id}
         data = await self._request("POST", "/Zones/GetZone", json=payload)
-        return Zone.model_validate(data)  # type: ignore[no-any-return]
+        return Zone.model_validate(data)
 
     async def get_appliance_overview(self, hub_id: str, appliance_ids: list[str]) -> list[ApplianceStatus]:
         """Get status overview for specific appliances.
@@ -351,7 +375,7 @@ class DimplexControl:
     async def get_user_context(self) -> UserContext:
         """Get user profile/context."""
         data = await self._request("GET", "/Identity/GetUserContext")
-        return UserContext.model_validate(data)  # type: ignore[no-any-return]
+        return UserContext.model_validate(data)
 
     async def get_product_models(self) -> list[ProductModel]:
         """Return the cloud product catalogue (models + provisioning metadata).
@@ -371,7 +395,7 @@ class DimplexControl:
             "TimerMode": 0,  # Required field in request; value ignored on read
         }
         data = await self._request("POST", "/RemoteControl/GetTimerModeDetailsForAppliance", json=payload)
-        return TimerModeSettings.model_validate(data)  # type: ignore[no-any-return]
+        return TimerModeSettings.model_validate(data)
 
     async def get_schedule(self, hub_id: str, appliance_id: str) -> TimerModeSettings:
         """Return the current timer mode + periods (alias of :meth:`get_appliance_features`)."""
@@ -591,15 +615,26 @@ class DimplexControl:
         """Enable or disable Away mode.
 
         Sends ``ApplianceModes=4`` (:attr:`~dimplex_controller.ApplianceModeFlag.AWAY`).
-        Away is a *settable* setback: the app offers 7–30 °C and defaults to the
-        7 °C anti-freeze floor, so a low ``temperature`` is the normal case
-        rather than a bug.
+        Away is a *settable* setback: the app offers 7–18 °C
+        (:data:`~dimplex_controller.AWAY_TEMP_MIN` / :data:`~dimplex_controller.AWAY_TEMP_MAX`)
+        and defaults to the 7 °C anti-freeze floor, so a low ``temperature`` is
+        the normal case rather than a bug.
 
         ``until`` is the "away until" datetime the app sends in ``Date``. Pass a
         :class:`~datetime.datetime` or an ISO-8601 string. ``number_of_days`` is
         retained for backwards compatibility and, when ``until`` is omitted, is
         converted into an equivalent ``Date``.
 
+        When engaging Away, ``temperature`` is clamped into the Away range and a
+        warning logged if it had to be: the cloud silently reduces a higher
+        value, so clamping locally makes the outcome the caller actually gets
+        visible rather than surprising (dimplex-controller-py#98). The clamp is
+        skipped when clearing, where the temperature is inert.
+
+        .. versionchanged:: 0.13.1
+           ``temperature`` is clamped to ``AWAY_TEMP_MIN``..``AWAY_TEMP_MAX``
+           when ``enable`` is true.
+
         .. versionchanged:: 0.13.0
            Previously sent ``ApplianceModes=32``, which is **FrostProtect** —
            the appliance was pinned to the fixed 7 °C frost setpoint and the
@@ -607,6 +642,8 @@ class DimplexControl:
            Away duration now travels in ``Date`` as the app does, not only in
            ``NumberOfDays``.
         """
+        if enable:
+            temperature = _clamp_away_temperature(temperature)
         days = int(number_of_days)
         if until is None and days > 0:
             until = datetime.now(timezone.utc) + timedelta(days=days)
@@ -876,7 +913,7 @@ class DimplexControl:
             "/RemoteControl/ApiGetTimerModeDetailsForHeatPumpHwcAppliance",
             json=payload,
         )
-        return TimerModeSettings.model_validate(data)  # type: ignore[no-any-return]
+        return TimerModeSettings.model_validate(data)
 
     async def set_heat_pump_hot_water_schedule(self, settings: TimerModeSettings) -> TimerModeSettings:
         """Write an ASHW cylinder's schedule periods.

{dimplex_controller-0.13.0 → dimplex_controller-0.14.0}/dimplex_controller/const.py

@@ -26,15 +26,24 @@ B2C_POLICY = "B2C_1A_DimplexControlSignupSignin"
 # recovered from Dimplex Control APK 2.26.0.
 # See ``docs/decompiled-api-reference.md``.
 
-# The mode carousels (Away / Boost / Frost / Manual / Eco) all offer 7–30 °C.
+# The mode carousels (Boost / Frost / Manual / Eco) offer 7–30 °C. Away shares
+# the floor but *not* the ceiling — see AWAY_TEMP_MAX below.
 MODE_TEMP_MIN = 7.0
 MODE_TEMP_MAX = 30.0
 
+# Away has its own, narrower ceiling. The app's Away picker will not offer above
+# 18 °C, and a live test against a Quantum requesting 25 °C produced 18 °C in the
+# cloud overview, the app and the appliance's own panel — so the earlier reading
+# of ``UpdateTempRange`` that folded Away into the shared 7–30 carousel was
+# over-generalised (dimplex-controller-py#98).
+AWAY_TEMP_MIN = 7.0
+AWAY_TEMP_MAX = 18.0
+
 # Frost protection is always driven at the anti-freeze floor.
 FROST_TEMPERATURE = 7.0
 
 # Away defaults to the frost floor (it is an anti-freeze setback by default)
-# but is user-settable across MODE_TEMP_MIN..MODE_TEMP_MAX.
+# but is user-settable across AWAY_TEMP_MIN..AWAY_TEMP_MAX.
 DEFAULT_AWAY_TEMPERATURE = FROST_TEMPERATURE
 
 # Boost's default in the app's picker.

{dimplex_controller-0.13.0 → dimplex_controller-0.14.0}/dimplex_controller/exceptions.py

@@ -79,11 +79,31 @@ class DimplexAuthTransientError(DimplexAuthError):
 
 
 class DimplexApiError(DimplexError):
-    """Exception for API errors."""
+    """Exception for API errors.
 
-    def __init__(self, status: int, message: str):
+    Attributes:
+        status: HTTP status returned by the API.
+        message: Short server message (never a full token).
+        transient: ``True`` when the failure may succeed on retry — a 5xx or 429
+            raised only after ``client.py`` exhausted its internal retries. ``False``
+            for a hard 4xx (404/400/403). Callers (e.g. the Home Assistant
+            coordinator) back off and keep entities available on ``transient``, and
+            surface the error otherwise.
+        code: Optional stable, machine-readable identifier.
+    """
+
+    def __init__(
+        self,
+        status: int,
+        message: str,
+        *,
+        transient: bool = False,
+        code: str | None = None,
+    ):
         self.status = status
         self.message = message
+        self.transient = transient
+        self.code = code
         super().__init__(f"API Error {status}: {message}")
 
 

{dimplex_controller-0.13.0 → dimplex_controller-0.14.0}/dimplex_controller/models.py

@@ -139,7 +139,7 @@ class ProductModel(BaseModel):
         if not raw:
             return None
         try:
-            return AutomaticProvisioning.model_validate_json(raw)  # type: ignore[no-any-return]
+            return AutomaticProvisioning.model_validate_json(raw)
         except (json.JSONDecodeError, ValueError):
             return None
 
@@ -178,7 +178,7 @@ class Appliance(BaseModel):
         if not raw:
             return None
         try:
-            return AutomaticProvisioning.model_validate_json(raw)  # type: ignore[no-any-return]
+            return AutomaticProvisioning.model_validate_json(raw)
         except (json.JSONDecodeError, ValueError):
             return None
 
@@ -287,6 +287,14 @@ class ApplianceStatus(BaseModel):
     ErrorCode: str | None = None
     WarningCode: str | None = None
 
+    @field_validator("ErrorCode", "WarningCode", mode="before")
+    @classmethod
+    def _coerce_code(cls, value: Any) -> Any:
+        # GetApplianceOverview sends these as integers (0 when healthy).
+        if isinstance(value, int) and not isinstance(value, bool):
+            return str(value)
+        return value
+
     @property
     def mode_flags(self) -> ApplianceModeFlag:
         """Return ``ApplianceModes`` as a typed flag set."""
@@ -425,7 +433,7 @@ class TsiEnergyReport(BaseModel):
     """
 
     HubId: str
-    ApplianceTelemetryData: dict[str, list] = Field(default_factory=dict)
+    ApplianceTelemetryData: dict[str, list[Any]] = Field(default_factory=dict)
 
 
 # `TsiReportType` integer values understood by the API. We do not know the

{dimplex_controller-0.13.0 → dimplex_controller-0.14.0}/dimplex_controller/telemetry.py

@@ -117,6 +117,15 @@ def _coerce_timestamp(raw: Any) -> datetime | None:
         return raw
     if isinstance(raw, int | float):
         ts = float(raw)
+        # Seconds-vs-milliseconds disambiguation is magnitude-only, which is safe for
+        # the data this parses: a Unix *seconds* epoch does not reach 1e12 until the
+        # year ~33658, and the cloud emits second-resolution `TS` values, so anything
+        # above the threshold is a millisecond epoch. The converse edge is not
+        # defended — a millisecond epoch before 2001-09-09 (< 1e12) would be misread
+        # as seconds — because the cloud has never produced one. A value just below
+        # 1e12 read as seconds lands past datetime's representable range and is
+        # dropped by the guard below rather than mis-parsed. See
+        # dimplex-controller-py#121 for why this is intentional rather than a gap.
         if ts > 1e12:
             ts = ts / 1000.0
         try:
@@ -276,6 +285,11 @@ def summarise_energy(
     ``points`` may be raw cloud payloads or already-parsed
     :data:`TelemetryPoint` tuples. When raw, they are passed through
     :func:`parse_telemetry_points` first.
+
+    Points with no parseable timestamp (``ts is None``) are excluded from the
+    total in **every** mode. They cannot be placed on a calendar day, so
+    counting them only in ``lifetime`` would make the cumulative total disagree
+    with the sum of the per-day totals (dimplex-controller-py#120).
     """
     parsed: list[TelemetryPoint]
     if (
@@ -285,7 +299,7 @@ def summarise_energy(
         and isinstance(points[0], tuple)
         and len(points[0]) == 2
     ):
-        parsed = list(points)  # type: ignore[arg-type]
+        parsed = list(points)
     else:
         parsed = parse_telemetry_points(points, value_keys=value_keys)
 
@@ -306,8 +320,16 @@ def summarise_energy(
             mode="daily",
         )
 
-    # lifetime — include every parseable point; window — optional start/end filter
-    selected = filter_telemetry_points(parsed, start=start, end=end, tz=tz) if mode == "window" else list(parsed)
+    # lifetime / window — totals must reconcile with the per-day totals, so a point
+    # with no parseable timestamp is dropped from both. A ``ts is None`` point cannot
+    # be placed on any calendar day (``daily``/``window`` already drop it via
+    # ``filter_telemetry_points``), so counting it only in the lifetime total made the
+    # cumulative meter disagree with the sum of its days — silent drift into the HA
+    # Energy Dashboard's TOTAL_INCREASING sensor (dimplex-controller-py#120).
+    if mode == "window":
+        selected = filter_telemetry_points(parsed, start=start, end=end, tz=tz)
+    else:
+        selected = [(ts, value) for ts, value in parsed if ts is not None]
 
     timestamps = [ts for ts, _ in selected if ts is not None]
     total = sum(v for _, v in selected)

dimplex_controller-0.14.0/pyproject.toml

@@ -0,0 +1,96 @@
+[project]
+name = "dimplex-controller"
+version = "0.14.0"
+description = "Unofficial async Python client for Dimplex (GDHV IoT) heating appliances — not affiliated with Glen Dimplex"
+license = "MIT"
+license-files = ["LICENSE"]
+readme = "README.md"
+requires-python = ">=3.10,<4.0"
+keywords = [
+    "dimplex",
+    "heating",
+    "control",
+    "iot",
+    "asyncio",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Home Automation",
+]
+dependencies = [
+    "aiohttp>=3.14.3,<4",
+    "pydantic>=2.13.5,<3",
+]
+
+[[project.authors]]
+name = "Kieran Roper"
+
+[project.urls]
+Homepage = "https://github.com/KRoperUK/dimplex-controller-py"
+Repository = "https://github.com/KRoperUK/dimplex-controller-py"
+
+[project.scripts]
+dimplex = "dimplex_controller.cli:main"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1,<10",
+    "pytest-asyncio>=1.4.0,<2",
+    "pytest-cov>=7.1.0,<8",
+    "aresponses>=3.0.0,<4",
+    "ruff>=0.16.7,<0.17",
+    "pre-commit>=4.6.2,<5",
+    "twine>=7.0.0,<8",
+    "python-dotenv>=1.2.3,<2",
+    "mypy>=2.3.1,<3",
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+extend-exclude = ["*.md"]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "W",
+    "UP",
+    "B",
+    "SIM",
+]
+ignore = ["E501"]
+
+[tool.mypy]
+python_version = "3.10"
+files = ["dimplex_controller"]
+ignore_missing_imports = true
+strict = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.coverage.run]
+source = ["dimplex_controller"]
+
+[tool.coverage.report]
+show_missing = true
+fail_under = 80
+
+[tool.uv.build-backend]
+module-root = ""
+
+[build-system]
+requires = ["uv_build>=0.11.19,<0.13.0"]
+build-backend = "uv_build"

dimplex_controller-0.14.0/pyproject.toml.orig

@@ -0,0 +1,106 @@
+[project]
+name = "dimplex-controller"
+version = "0.14.0"
+description = "Unofficial async Python client for Dimplex (GDHV IoT) heating appliances — not affiliated with Glen Dimplex"
+authors = [{ name = "Kieran Roper" }]
+license = "MIT"
+license-files = ["LICENSE"]
+readme = "README.md"
+requires-python = ">=3.10,<4.0"
+keywords = ["dimplex", "heating", "control", "iot", "asyncio"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Home Automation",
+]
+# Lower bounds are the versions this release was developed and tested against;
+# the upper bounds keep the previous caret semantics (a caret range is
+# `>=X,<next-major`), so consumers gain no surprise from the migration.
+dependencies = [
+    "aiohttp>=3.14.3,<4",
+    "pydantic>=2.13.5,<3",
+]
+
+[project.urls]
+Homepage = "https://github.com/KRoperUK/dimplex-controller-py"
+Repository = "https://github.com/KRoperUK/dimplex-controller-py"
+
+[project.scripts]
+dimplex = "dimplex_controller.cli:main"
+
+# PEP 735 dependency groups: not installed into a consumer's environment, only
+# into a development one.
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1,<10",
+    "pytest-asyncio>=1.4.0,<2",
+    "pytest-cov>=7.1.0,<8",
+    "aresponses>=3.0.0,<4",
+    "ruff>=0.16.7,<0.17",
+    "pre-commit>=4.6.2,<5",
+    "twine>=7.0.0,<8",
+    "python-dotenv>=1.2.3,<2",
+    "mypy>=2.3.1,<3",
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+# Python inside Markdown is not formatted here. The code blocks in README.md and
+# docs/ carry deliberate column alignment (see the temperature-constant table in
+# docs/api-reference.md) and ruff's formatter normalises comment spacing, so
+# formatting them would trade readable docs for tool uniformity. This also keeps a
+# bare `ruff format .` in step with the pre-commit hooks, which are python/pyi only.
+extend-exclude = ["*.md"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W", "UP", "B", "SIM"]
+# E501 (line length) is handled by the formatter; long strings/comments are fine.
+ignore = ["E501"]
+
+[tool.mypy]
+python_version = "3.10"
+files = ["dimplex_controller"]
+ignore_missing_imports = true
+# `strict` rather than the four flags this used to carry (disallow_untyped_defs,
+# warn_return_any, warn_unused_configs, warn_redundant_casts). The library is the
+# layer the Home Assistant integration trusts for models, capabilities and error
+# types, and that consumer runs strict mypy over its own code — so a library
+# checked more loosely could hand it types that do not hold
+# (dimplex-controller-hass#202).
+#
+# Raising it surfaced seven stale `# type: ignore` comments, all of which mypy
+# reported as unused, plus one missing generic argument. No real type errors.
+strict = true
+
+[tool.pytest.ini_options]
+# All async tests use asyncio; "auto" means new tests don't each need the
+# @pytest.mark.asyncio decorator (existing markers remain valid).
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.coverage.run]
+source = ["dimplex_controller"]
+
+[tool.coverage.report]
+show_missing = true
+# Guardrail so coverage can't silently regress. Raise as coverage improves.
+fail_under = 80
+
+[build-system]
+requires = ["uv_build>=0.11.19,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+# The package is at the repository root, not under src/, which is what uv_build
+# assumes by default. The module name is inferred from the project name
+# (dimplex-controller -> dimplex_controller), so it needs no override.
+module-root = ""

dimplex_controller-0.13.0/pyproject.toml

@@ -1,80 +0,0 @@
-[tool.poetry]
-name = "dimplex-controller"
-version = "0.13.0"
-description = "Python client for Dimplex heating controllers (GDHV IoT)"
-authors = ["Kieran Roper"]
-license = "MIT"
-readme = "README.md"
-homepage = "https://github.com/KRoperUK/dimplex-controller-py"
-repository = "https://github.com/KRoperUK/dimplex-controller-py"
-keywords = ["dimplex", "heating", "control", "iot", "asyncio"]
-classifiers = [
-    "Development Status :: 5 - Production/Stable",
-    "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
-    "Natural Language :: English",
-    "Operating System :: OS Independent",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Topic :: Home Automation",
-]
-packages = [{ include = "dimplex_controller" }]
-
-[tool.poetry.scripts]
-dimplex = "dimplex_controller.cli:main"
-
-[tool.poetry.dependencies]
-python = "^3.10"
-aiohttp = "^3.9.0"
-pydantic = "^2.0.0"
-
-[tool.poetry.group.dev.dependencies]
-pytest = "^8.0.0"
-pytest-asyncio = "^1.0.0"
-pytest-cov = "^6.0.0"
-aresponses = "^3.0.0"
-ruff = "^0.15.0"
-pre-commit = "^3.6.0"
-twine = "^6.2.0"
-python-dotenv = "^1.2.1"
-mypy = "^1.0.0"
-
-[tool.ruff]
-line-length = 120
-target-version = "py310"
-
-[tool.ruff.lint]
-select = ["E", "F", "I", "W", "UP", "B", "SIM"]
-# E501 (line length) is handled by the formatter; long strings/comments are fine.
-ignore = ["E501"]
-
-[tool.mypy]
-python_version = "3.10"
-files = ["dimplex_controller"]
-ignore_missing_imports = true
-# Incrementally strict — these catch real bugs without requiring a full rewrite.
-disallow_untyped_defs = true
-warn_return_any = true
-warn_unused_configs = true
-warn_redundant_casts = true
-
-[tool.pytest.ini_options]
-# All async tests use asyncio; "auto" means new tests don't each need the
-# @pytest.mark.asyncio decorator (existing markers remain valid).
-asyncio_mode = "auto"
-testpaths = ["tests"]
-
-[tool.coverage.run]
-source = ["dimplex_controller"]
-
-[tool.coverage.report]
-show_missing = true
-# Guardrail so coverage can't silently regress. Raise as coverage improves.
-fail_under = 80
-
-[build-system]
-requires = ["poetry-core"]
-build-backend = "poetry.core.masonry.api"