python-daikin-itm 0.1.0__tar.gz → 0.1.1__tar.gz

{python_daikin_itm-0.1.0 → python_daikin_itm-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-daikin-itm
-Version: 0.1.0
+Version: 0.1.1
 Summary: Asynchronous Python client for the Daikin intelligent Touch Manager (iTM).
 Keywords: async,client,daikin,itm,intelligent touch manager,hvac
 Author: Robbin Janssen, Robin Mulder
@@ -52,8 +52,6 @@ A Python package to control the indoor units connected to a Daikin
 built-in web UI, so it needs no cloud service and no extra hardware: only
 network access to the iTM and a user account on it.
 
-Based on the original work by Robin Mulder (Exonet).
-
 Used by the Home Assistant integration
 [home-assistant-daikin-itm](https://github.com/robbinjanssen/home-assistant-daikin-itm).
 
@@ -220,6 +218,7 @@ class SessionStore(Protocol):
 | `SessionEnded` | The iTM ended the session (it answered with a LOGOUT update), e.g. because the token was stale. |
 | `VersionMismatch` | The iTM expects another web UI version string (subclass of `SessionEnded`); carries it in `.version`. |
 | `ItmCommandError` | The iTM answered a command with a dialog, the UI was not as expected, or a change was not confirmed in time. |
+| `SetpointOutOfRange` | The unit does not accept the setpoint (subclass of `ItmCommandError`). The allowed setpoints depend on the unit and its operation mode; the ones it accepts now are in `.allowed`. |
 | `ZoneNotFound` | A zone of the zone path is not there (subclass of `ItmCommandError`); the names that are there are in `.available`. |
 
 Network errors are raised as `aiohttp.ClientError` or `TimeoutError`.

{python_daikin_itm-0.1.0 → python_daikin_itm-0.1.1}/README.md

@@ -23,8 +23,6 @@ A Python package to control the indoor units connected to a Daikin
 built-in web UI, so it needs no cloud service and no extra hardware: only
 network access to the iTM and a user account on it.
 
-Based on the original work by Robin Mulder (Exonet).
-
 Used by the Home Assistant integration
 [home-assistant-daikin-itm](https://github.com/robbinjanssen/home-assistant-daikin-itm).
 
@@ -191,6 +189,7 @@ class SessionStore(Protocol):
 | `SessionEnded` | The iTM ended the session (it answered with a LOGOUT update), e.g. because the token was stale. |
 | `VersionMismatch` | The iTM expects another web UI version string (subclass of `SessionEnded`); carries it in `.version`. |
 | `ItmCommandError` | The iTM answered a command with a dialog, the UI was not as expected, or a change was not confirmed in time. |
+| `SetpointOutOfRange` | The unit does not accept the setpoint (subclass of `ItmCommandError`). The allowed setpoints depend on the unit and its operation mode; the ones it accepts now are in `.allowed`. |
 | `ZoneNotFound` | A zone of the zone path is not there (subclass of `ItmCommandError`); the names that are there are in `.available`. |
 
 Network errors are raised as `aiohttp.ClientError` or `TimeoutError`.

{python_daikin_itm-0.1.0 → python_daikin_itm-0.1.1}/daikin_itm/__init__.py

@@ -13,6 +13,7 @@ from .exceptions import (
     LoginRejected,
     ProtocolError,
     SessionEnded,
+    SetpointOutOfRange,
     VersionMismatch,
     ZoneNotFound,
 )
@@ -31,6 +32,7 @@ __all__ = [
     "ProtocolError",
     "SessionEnded",
     "SessionStore",
+    "SetpointOutOfRange",
     "Unit",
     "VersionMismatch",
     "ZoneNotFound",

{python_daikin_itm-0.1.0 → python_daikin_itm-0.1.1}/daikin_itm/client.py

@@ -29,6 +29,7 @@ from .exceptions import (
     LoginRejected,
     ProtocolError,
     SessionEnded,
+    SetpointOutOfRange,
     VersionMismatch,
     ZoneNotFound,
 )
@@ -807,8 +808,7 @@ class ItmClient:
                     raise ItmCommandError(msg)
                 nums = list(current.setpoint_range)
                 if value not in nums:
-                    msg = f"{unit}: setpoint {value} outside allowed range {nums}"
-                    raise ItmCommandError(msg)
+                    raise SetpointOutOfRange(unit, value, current.setpoint_range)
                 if current.setpoint == value:
                     return current
                 await s.choose(P_SETPOINT, nums.index(value))

{python_daikin_itm-0.1.0 → python_daikin_itm-0.1.1}/daikin_itm/exceptions.py

@@ -59,3 +59,27 @@ class ZoneNotFound(ItmCommandError):  # noqa: N818 - public API name
         super().__init__(f"{zone!r} not found here; available: {available}")
         self.zone = zone
         self.available = available
+
+
+class SetpointOutOfRange(ItmCommandError):  # noqa: N818 - public API name
+    """The unit does not accept the setpoint; carries the setpoints it does accept.
+
+    The allowed setpoints depend on the unit and its operation mode, so they may have
+    changed since the unit was last read.
+    """
+
+    def __init__(self, unit: str, value: int, allowed: tuple[int, ...]) -> None:
+        """Initialize the error.
+
+        Args:
+        ----
+            unit: The name of the unit.
+            value: The setpoint that was asked for.
+            allowed: The setpoints the unit accepts now, as read while writing.
+
+        """
+        msg = f"{unit}: setpoint {value} outside allowed range {list(allowed)}"
+        super().__init__(msg)
+        self.unit = unit
+        self.value = value
+        self.allowed = allowed

{python_daikin_itm-0.1.0 → python_daikin_itm-0.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-daikin-itm"
-version = "0.1.0"
+version = "0.1.1"
 description = "Asynchronous Python client for the Daikin intelligent Touch Manager (iTM)."
 license = "MIT"
 license-files = ["LICENSE"]

{python_daikin_itm-0.1.0 → python_daikin_itm-0.1.1}/pyproject.toml.orig

@@ -1,7 +1,7 @@
 [project]
 name = "python-daikin-itm"
 # The version is set from the release tag by the release workflow.
-version = "0.1.0"
+version = "0.1.1"
 description = "Asynchronous Python client for the Daikin intelligent Touch Manager (iTM)."
 authors = [
     { name = "Robbin Janssen", email = "robbinjanssen@gmail.com" },