dimplex-controller 0.13.1__tar.gz → 0.15.0__tar.gz

{dimplex_controller-0.13.1 → dimplex_controller-0.15.0}/PKG-INFO

@@ -1,15 +1,13 @@
 Metadata-Version: 2.4
 Name: dimplex-controller
-Version: 0.13.1
+Version: 0.15.0
 Summary: Unofficial async Python client for Dimplex (GDHV IoT) heating appliances — not affiliated with Glen Dimplex
-License: MIT
-License-File: LICENSE
 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.9.0,<4
+Requires-Dist: pydantic>=2.0.0,<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
@@ -104,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
@@ -283,7 +285,9 @@ Main client class. Construct with an `aiohttp.ClientSession` and a `refresh_toke
 | `set_setback_temperature(...)` | Write the setback temperature (untested). |
 | `set_eco_start(hub_id, appliance_ids, enable)` | Toggle EcoStart. |
 | `set_open_window_detection(hub_id, appliance_ids, enable)` | Toggle Open Window Detection. |
-| `set_hot_water_*(...)` / `*_heat_pump_hot_water_schedule(...)` | Hot-water cylinder surface (untested — no hardware). |
+| `set_hot_water_holiday(hub_id, appliance_ids, until, *, enable, heat_pump)` | Cylinder Holiday on/off (validated on an ASHW cylinder). |
+| `get_heat_pump_hot_water_schedule(...)` | ASHW cylinder schedule as `HeatPumpHwcSchedule` (validated). Writing it answers 403. |
+| `set_hot_water_*(...)` | Remaining cylinder controls (untested — no hardware). |
 | `get_tsi_energy_report(hub_id, ...)` | Returns `TsiEnergyReport`. |
 | `capabilities_for(appliance, *, status, product)` | Derive an `ApplianceCapabilities` matrix. |
 | `export_tokens()` / `apply_tokens(bundle)` | Token persistence helpers. |
@@ -303,7 +307,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
@@ -400,4 +404,3 @@ Key points:
 ## Changelog
 
 See [CHANGELOG.md](CHANGELOG.md) for version history.
-

{dimplex_controller-0.13.1 → dimplex_controller-0.15.0}/README.md

@@ -77,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
@@ -256,7 +259,9 @@ Main client class. Construct with an `aiohttp.ClientSession` and a `refresh_toke
 | `set_setback_temperature(...)` | Write the setback temperature (untested). |
 | `set_eco_start(hub_id, appliance_ids, enable)` | Toggle EcoStart. |
 | `set_open_window_detection(hub_id, appliance_ids, enable)` | Toggle Open Window Detection. |
-| `set_hot_water_*(...)` / `*_heat_pump_hot_water_schedule(...)` | Hot-water cylinder surface (untested — no hardware). |
+| `set_hot_water_holiday(hub_id, appliance_ids, until, *, enable, heat_pump)` | Cylinder Holiday on/off (validated on an ASHW cylinder). |
+| `get_heat_pump_hot_water_schedule(...)` | ASHW cylinder schedule as `HeatPumpHwcSchedule` (validated). Writing it answers 403. |
+| `set_hot_water_*(...)` | Remaining cylinder controls (untested — no hardware). |
 | `get_tsi_energy_report(hub_id, ...)` | Returns `TsiEnergyReport`. |
 | `capabilities_for(appliance, *, status, product)` | Derive an `ApplianceCapabilities` matrix. |
 | `export_tokens()` / `apply_tokens(bundle)` | Token persistence helpers. |
@@ -276,7 +281,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.1 → dimplex_controller-0.15.0}/dimplex_controller/__init__.py

@@ -45,6 +45,8 @@ from .models import (
     ApplianceModeStatus,
     ApplianceStatus,
     AutomaticProvisioning,
+    HeatPumpHwcPeriod,
+    HeatPumpHwcSchedule,
     Hub,
     HygieneFrequency,
     ProductModel,
@@ -62,6 +64,7 @@ from .telemetry import (
     EnergySummary,
     filter_telemetry_points,
     parse_telemetry_points,
+    reported_energy,
     summarise_energy,
 )
 
@@ -83,6 +86,8 @@ __all__ = [
     "SetbackStatus",
     "TimerMode",
     "TimerModeSettings",
+    "HeatPumpHwcPeriod",
+    "HeatPumpHwcSchedule",
     "TimerPeriod",
     "AutomaticProvisioning",
     "ProductModel",
@@ -98,6 +103,7 @@ __all__ = [
     "NULL_DATETIME",
     "parse_telemetry_points",
     "filter_telemetry_points",
+    "reported_energy",
     "summarise_energy",
     "EnergySummary",
     "VALUE_KEY_T1",

{dimplex_controller-0.13.1 → dimplex_controller-0.15.0}/dimplex_controller/capabilities.py

@@ -24,6 +24,14 @@ class ApplianceCapabilities:
     Flags are best-effort: when status/product metadata is incomplete the
     library prefers enabling known cloud control paths (boost/away/OWD) so
     users are not locked out of working RPCs.
+
+    One flag is weaker than the rest and must not be used as a gate:
+    :attr:`energy_meter` is a *family hint* derived from the nameplate, so it is
+    true for essentially every appliance with a rated power. When the question is
+    "has this appliance ever reported energy?", ask the telemetry —
+    :func:`dimplex_controller.reported_energy`, or
+    :func:`dimplex_controller.summarise_energy` when the totals are wanted too
+    (dimplex-controller-py#113).
     """
 
     boost: bool = True
@@ -39,6 +47,7 @@ class ApplianceCapabilities:
     # setpoint path. Preferred over rewriting the schedule via SetTimerMode,
     # which Quantum rejects with HTTP 403.
     setpoint_write: bool = True
+    # Family hint, not proof of metering — see the class docstring before gating on it.
     energy_meter: bool = False
     storage: bool = False
     hot_water: bool = False
@@ -162,15 +171,23 @@ def capabilities_for(
         heat_pump = True
         hot_water = True
 
-    boost = True
-    away = True
+    if status is not None and status.AvailableHotWater is not None:
+        hot_water = True
+
+    # A cylinder reports its *water* target in ActiveSetPointTemperature (45 °C
+    # on a live ASHW cylinder), so only a room temperature makes it room climate.
+    # Without one, the room-heater features default to off — a live cylinder
+    # sends null for every one of them — unless its status reports them.
+    climate = not hot_water or (status is not None and status.RoomTemperature is not None)
+
+    boost = climate
+    away = climate
     advance = True
-    open_window = True
-    eco_start = True
-    setback_read = True
-    frost = True
+    open_window = climate
+    eco_start = climate
+    setback_read = climate
+    frost = climate
     timer = True
-    climate = not hot_water  # cylinder-only appliances are not room climate
 
     if status is not None:
         if status.BoostDuration is not None or status.BoostTemperature is not None:
@@ -183,10 +200,6 @@ def capabilities_for(
             eco_start = True
         if status.SetbackEnabled is not None or status.SetbackTemperature is not None:
             setback_read = True
-        if status.AvailableHotWater is not None:
-            hot_water = True
-        if status.RoomTemperature is not None or status.ActiveSetPointTemperature is not None:
-            climate = True
 
     # Advance only means something for a scheduled room heater; a cylinder has
     # no "next comfort period" to jump to.
@@ -200,10 +213,11 @@ def capabilities_for(
         open_window=open_window,
         eco_start=eco_start,
         setback_read=setback_read,
-        setback_write=True,
+        setback_write=climate,
         frost=frost,
         timer=timer,
-        setpoint_write=True,
+        # The room setpoint endpoint; cylinders have their own (Set*TemperatureHwc).
+        setpoint_write=climate,
         energy_meter=energy_meter,
         storage=storage,
         hot_water=hot_water,

{dimplex_controller-0.13.1 → dimplex_controller-0.15.0}/dimplex_controller/client.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import asyncio
 import json
 import logging
+import math
 import random
 from datetime import datetime, timedelta, timezone
 from typing import Any
@@ -36,6 +37,7 @@ from .models import (
     ApplianceModeSettings,
     ApplianceModeStatus,
     ApplianceStatus,
+    HeatPumpHwcSchedule,
     Hub,
     HygieneFrequency,
     ProductModel,
@@ -274,12 +276,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)
@@ -838,6 +842,42 @@ class DimplexControl:
             endpoint=endpoint,
         )
 
+    async def set_hot_water_holiday(
+        self,
+        hub_id: str,
+        appliance_ids: list[str],
+        until: datetime | None = None,
+        *,
+        enable: bool = True,
+        heat_pump: bool = False,
+    ) -> None:
+        """Put a cylinder on Holiday (standby) until ``until``, or clear it.
+
+        Verified on a live ASHW cylinder (EDL200UK-630RF) with ``heat_pump=True``:
+        engaging moved ``ApplianceModes`` 8192 → 8200 and set
+        ``HolidayNumOfDays``, heating stopped, and clearing restored 8192. The
+        cylinder counts holidays in whole days, so ``until`` is also sent as a
+        rounded-up day count; a caller that wants a time of day has to clear
+        Holiday itself at that time.
+        """
+        days = 0
+        if enable:
+            if until is None:
+                raise ValueError("a holiday needs an end time")
+            end = until if until.tzinfo is not None else until.replace(tzinfo=timezone.utc)
+            seconds = (end - datetime.now(timezone.utc)).total_seconds()
+            days = max(1, math.ceil(seconds / 86400))
+        endpoint = "/RemoteControl/SetApplianceModeHeatPumpHwc" if heat_pump else "/RemoteControl/SetApplianceModeHwc"
+        await self.set_mode_flag(
+            hub_id,
+            appliance_ids,
+            ApplianceModeFlag.HOLIDAY,
+            enable=enable,
+            until=until,
+            number_of_days=days,
+            endpoint=endpoint,
+        )
+
     async def set_hot_water_boost_temperature(
         self, hub_id: str, appliance_ids: list[str], temperature: float, *, enable: bool = True
     ) -> None:
@@ -900,10 +940,12 @@ class DimplexControl:
             endpoint=endpoint,
         )
 
-    async def get_heat_pump_hot_water_schedule(self, hub_id: str, appliance_id: str) -> TimerModeSettings:
-        """Read an ASHW cylinder's schedule.
+    async def get_heat_pump_hot_water_schedule(self, hub_id: str, appliance_id: str) -> HeatPumpHwcSchedule:
+        """Read an ASHW cylinder's weekly schedule.
 
-        .. warning:: Untested — APK-confirmed only.
+        Verified on a live ASHW cylinder (EDL200UK-630RF). The reply does not fit
+        :class:`TimerModeSettings` — there is no ``TimerMode`` and each period is
+        ``{DayOfWeek, StartTime, Mode}`` — hence :class:`HeatPumpHwcSchedule`.
         """
         payload = {"HubId": hub_id, "ApplianceId": appliance_id}
         data = await self._request(
@@ -911,12 +953,16 @@ class DimplexControl:
             "/RemoteControl/ApiGetTimerModeDetailsForHeatPumpHwcAppliance",
             json=payload,
         )
-        return TimerModeSettings.model_validate(data)
+        return HeatPumpHwcSchedule.model_validate(data)
 
     async def set_heat_pump_hot_water_schedule(self, settings: TimerModeSettings) -> TimerModeSettings:
         """Write an ASHW cylinder's schedule periods.
 
-        .. warning:: Untested — APK-confirmed only.
+        .. warning:: Does not work yet. On a live ASHW cylinder this endpoint
+           answered HTTP 403 to every body tried — wrapped in ``TimerModeSettings``
+           or ``Settings``, with or without ``TimerMode``, integer or ``HH:MM:SS``
+           times, and app versions up to 3.0.0 — while unwrapped bodies got 400.
+           The request the official app sends has not been captured.
         """
         payload = {"TimerModeSettings": settings.model_dump(mode="json")}
         await self._request("POST", "/RemoteControl/UpdateHeatPumpHwcSchedulePeriods", json=payload)

{dimplex_controller-0.13.1 → dimplex_controller-0.15.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.1 → dimplex_controller-0.15.0}/dimplex_controller/models.py

@@ -255,6 +255,31 @@ class TimerModeSettings(BaseModel):
     TimerPeriods: list[TimerPeriod] = Field(default_factory=list)
 
 
+class HeatPumpHwcPeriod(BaseModel):
+    """One period of an ASHW cylinder's weekly schedule.
+
+    A live cylinder returns one ``{DayOfWeek, StartTime: 0, Mode: 2}`` per day.
+    ``DayOfWeek`` is .NET's (0 = Sunday). ``StartTime`` is an integer, presumed
+    minutes after midnight, and what each ``Mode`` value means is not yet known.
+    """
+
+    DayOfWeek: int
+    StartTime: int
+    Mode: int
+
+
+class HeatPumpHwcSchedule(BaseModel):
+    """``ApiGetTimerModeDetailsForHeatPumpHwcAppliance`` reply.
+
+    Unlike the room-heater :class:`TimerModeSettings` it has no ``TimerMode``
+    and its periods carry a mode instead of an end time and temperature.
+    """
+
+    HubId: str
+    ApplianceId: str
+    TimerPeriods: list[HeatPumpHwcPeriod] = Field(default_factory=list)
+
+
 class UserContext(BaseModel):
     Id: str
     EmailAddress: str | None = None
@@ -286,6 +311,29 @@ class ApplianceStatus(BaseModel):
     LockStatus: int | None = None
     ErrorCode: str | None = None
     WarningCode: str | None = None
+    # Hot-water cylinder fields, as a live ASHW cylinder (EDL200UK-630RF) sends
+    # them. AvailableHotWater above is litres of usable hot water (the app shows
+    # it as "336 L Hot water").
+    Capacity: int | None = None  # tank size, litres
+    HeatingUp: bool | None = None
+    IsGreenEnergyActive: bool | None = None
+    HygieneFrequency: int | None = None  # EFrequency, see HygieneFrequency
+    HygieneTemperature: float | None = None
+    HolidayNumOfDays: int | None = None
+    # Present in the same reply, always null on the cylinder seen so far.
+    DelayedStartTime: str | None = None
+    DsmStatus: int | None = None
+    ModifiedPower: float | None = None
+    ConnectedChargeProfiles: Any = None
+    StandaloneChargeProfiles: Any = 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:

{dimplex_controller-0.13.1 → dimplex_controller-0.15.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:
@@ -213,6 +222,34 @@ def parse_telemetry_points(
     return out
 
 
+def reported_energy(
+    points: Any,
+    *,
+    value_keys: tuple[str, ...] | None = None,
+) -> bool:
+    """Return True when telemetry carries usable points for an appliance.
+
+    The evidence-based counterpart to
+    :attr:`ApplianceCapabilities.energy_meter <.capabilities.ApplianceCapabilities>`,
+    which is a family hint derived from the nameplate and is therefore true for
+    essentially every appliance — it cannot separate a genuinely metered one from an
+    appliance the hub never reports energy for (dimplex-controller-py#113).
+
+    Pass the appliance's entry from
+    :attr:`TsiEnergyReport.ApplianceTelemetryData
+    <.models.TsiEnergyReport>` (raw entries are normalised by
+    :func:`parse_telemetry_points`, so both raw and already-parsed points are
+    accepted). Nothing recognised, an empty list, or a value the parser skips all
+    answer ``False`` — which is the question a consumer gating entity creation
+    actually has.
+
+    Only presence is decided here. A caller that also wants the figures should call
+    :func:`parse_telemetry_points` or :func:`summarise_energy` once and test the
+    result, rather than parse a series twice.
+    """
+    return bool(parse_telemetry_points(points, value_keys=value_keys))
+
+
 def _ensure_aware(ts: datetime, default_tz: tzinfo) -> datetime:
     """Return ``ts`` with a timezone; naive datetimes are assumed ``default_tz``."""
     if ts.tzinfo is None:
@@ -276,6 +313,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 (
@@ -306,8 +348,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.15.0/pyproject.toml

@@ -0,0 +1,96 @@
+[project]
+name = "dimplex-controller"
+version = "0.15.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.9.0,<4",
+    "pydantic>=2.0.0,<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.15.0/pyproject.toml.orig

@@ -0,0 +1,115 @@
+[project]
+name = "dimplex-controller"
+version = "0.15.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",
+]
+# The upper bounds keep the previous caret semantics (a caret range is
+# `>=X,<next-major`), so consumers gain no surprise from the uv migration.
+dependencies = [
+    # Lower bounds are what the code needs, not what uv.lock happens to resolve.
+    # They were raised to the locked versions when the project migrated to uv and
+    # bumped everything in one pass (#110), which made this library uninstallable
+    # alongside Home Assistant: the integration's test stack pins pydantic 2.13.4
+    # while this demanded >=2.13.5, so `dimplex-controller>=0.14.0` resolved to
+    # nothing and the HA integration could not adopt the 0.14.0 ErrorCode/WarningCode
+    # fix (dimplex-controller-hass#256).
+    #
+    # Nothing here needs either new API: plain ``BaseModel``, ``field_validator``,
+    # ``ConfigDict`` and an aiohttp ``ClientSession`` are all 2.0/3.9-era.
+    "aiohttp>=3.9.0,<4",
+    "pydantic>=2.0.0,<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.1/pyproject.toml

@@ -1,85 +0,0 @@
-[tool.poetry]
-name = "dimplex-controller"
-version = "0.13.1"
-description = "Unofficial async Python client for Dimplex (GDHV IoT) heating appliances — not affiliated with Glen Dimplex"
-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
-# `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 = ["poetry-core"]
-build-backend = "poetry.core.masonry.api"