python-duco-connectivity 0.10.0__tar.gz → 0.11.0__tar.gz

{python_duco_connectivity-0.10.0/src/python_duco_connectivity.egg-info → python_duco_connectivity-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-duco-connectivity
-Version: 0.10.0
+Version: 0.11.0
 Summary: Async HTTP client for the local Duco Connectivity API
 Author: Ronald van der Meer
 License-Expression: MIT
@@ -76,8 +76,9 @@ bypass-target endpoint is unsupported, the relevant helper raises
 subclass and preserves the HTTP status, path, and response body. A valid
 ventilation-temperature response always returns a `VentilationTemperatureInfo`
 model, whose individual temperature fields can be `None` when omitted. The
-bypass-target helper returns `None` when its target is omitted from a valid
-response.
+bypass-target helper returns a typed target model for successful parameter-
+specific reads and raises `DucoError` if the requested target field is missing
+from an otherwise valid `/config` response.
 
 Diagnostic subsystem reads now keep raw component and status strings from
 `Diag.SubSystems`, so future subsystem names or status values remain available

{python_duco_connectivity-0.10.0 → python_duco_connectivity-0.11.0}/README.md

@@ -44,8 +44,9 @@ bypass-target endpoint is unsupported, the relevant helper raises
 subclass and preserves the HTTP status, path, and response body. A valid
 ventilation-temperature response always returns a `VentilationTemperatureInfo`
 model, whose individual temperature fields can be `None` when omitted. The
-bypass-target helper returns `None` when its target is omitted from a valid
-response.
+bypass-target helper returns a typed target model for successful parameter-
+specific reads and raises `DucoError` if the requested target field is missing
+from an otherwise valid `/config` response.
 
 Diagnostic subsystem reads now keep raw component and status strings from
 `Diag.SubSystems`, so future subsystem names or status values remain available

{python_duco_connectivity-0.10.0 → python_duco_connectivity-0.11.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-duco-connectivity"
-version = "0.10.0"
+version = "0.11.0"
 description = "Async HTTP client for the local Duco Connectivity API"
 readme = "README.md"
 license = "MIT"

{python_duco_connectivity-0.10.0 → python_duco_connectivity-0.11.0}/src/duco_connectivity/client.py

@@ -2295,7 +2295,7 @@ class DucoClient:
     async def async_get_bypass_supply_temperature_target(
         self,
         zone_id: int,
-    ) -> BypassSupplyTemperatureTarget | None:
+    ) -> BypassSupplyTemperatureTarget:
         """Return a bypass supply target from `/config` in Celsius."""
         parameter = self._validate_bypass_zone_id(zone_id)
         try:
@@ -2312,7 +2312,11 @@ class DucoClient:
                     err.body,
                 ) from err
             raise
-        return self._extract_bypass_supply_temperature_target(config, zone_id)
+        target = self._extract_bypass_supply_temperature_target(config, zone_id)
+        if target is None:
+            msg = f"Expected {parameter} in /config response"
+            raise DucoError(msg)
+        return target
 
     async def async_set_bypass_supply_temperature_target(
         self,

{python_duco_connectivity-0.10.0 → python_duco_connectivity-0.11.0/src/python_duco_connectivity.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-duco-connectivity
-Version: 0.10.0
+Version: 0.11.0
 Summary: Async HTTP client for the local Duco Connectivity API
 Author: Ronald van der Meer
 License-Expression: MIT
@@ -76,8 +76,9 @@ bypass-target endpoint is unsupported, the relevant helper raises
 subclass and preserves the HTTP status, path, and response body. A valid
 ventilation-temperature response always returns a `VentilationTemperatureInfo`
 model, whose individual temperature fields can be `None` when omitted. The
-bypass-target helper returns `None` when its target is omitted from a valid
-response.
+bypass-target helper returns a typed target model for successful parameter-
+specific reads and raises `DucoError` if the requested target field is missing
+from an otherwise valid `/config` response.
 
 Diagnostic subsystem reads now keep raw component and status strings from
 `Diag.SubSystems`, so future subsystem names or status values remain available

{python_duco_connectivity-0.10.0 → python_duco_connectivity-0.11.0}/tests/test_api_reference.py

@@ -90,7 +90,7 @@ def test_api_reference_documents_optional_capability_contracts() -> None:
     content = render_api_reference()
 
     assert "optional endpoint as unsupported" in content
-    assert "target is omitted from an otherwise valid response" in content
+    assert "without the requested target field in the response" in content
     assert "optional target endpoint is unsupported" in content
 
 

{python_duco_connectivity-0.10.0 → python_duco_connectivity-0.11.0}/tests/test_client.py

@@ -3794,16 +3794,20 @@ async def test_get_bypass_supply_temperature_target_returns_converted_values(
     }
 
 
-async def test_get_bypass_supply_temperature_target_returns_none_when_not_reported() -> None:
-    """Missing bypass targets should return None instead of failing."""
+async def test_get_bypass_supply_temperature_target_raises_when_not_reported() -> None:
+    """Missing bypass targets should fail for parameter-specific helper reads."""
     mock_response = _response(json_payload={"HeatRecovery": {"Bypass": {}}})
 
     async with aiohttp.ClientSession() as session:
         client = DucoClient(session=session, host="192.0.2.94")
-        with patch.object(session, "request", _request(mock_response)):
-            payload = await client.async_get_bypass_supply_temperature_target(1)
-
-    assert payload is None
+        with (
+            patch.object(session, "request", _request(mock_response)),
+            pytest.raises(
+                DucoError,
+                match=re.escape("Expected TempSupTgtZone1 in /config response"),
+            ),
+        ):
+            await client.async_get_bypass_supply_temperature_target(1)
 
 
 async def test_get_bypass_supply_temperature_target_raises_when_unsupported() -> None: