python-bsblan 6.1.11__py3-none-any.whl → 6.2.0__py3-none-any.whl

bsblan/bsblan.py

@@ -51,9 +51,10 @@ from .models import (
     State,
     StaticState,
 )
-from .utility import is_param_value_active, validate_time_format
+from .utility import is_param_value_active
 
 if TYPE_CHECKING:
+    from datetime import datetime
     from typing import Self
 
     from aiohttp.client import ClientSession
@@ -862,24 +863,31 @@ class BSBLAN:
         time_data = {"time": data["0"]}
         return DeviceTime.model_validate(time_data)
 
-    async def set_time(self, time_value: str) -> None:
+    async def set_time(self, value: datetime) -> None:
         """Set the time on the BSB-LAN device.
 
         Args:
-            time_value (str): The time value to set in format "DD.MM.YYYY HH:MM:SS"
-                (e.g., "13.08.2025 10:25:55").
+            value (datetime): The local time of the heating system. Its date and
+                time are written as they are, without timezone conversion.
 
         Raises:
-            BSBLANInvalidParameterError: If the time format is invalid.
+            BSBLANInvalidParameterError: If the year is out of range.
+            BSBLANError: If the device does not accept the new time.
 
         """
         await self._ensure_device_metadata()
         self._validate_time_sync_supported()
-        self._validate_time_format(time_value)
+        if not Validation.MIN_YEAR <= value.year <= Validation.MAX_YEAR:
+            msg = f"Invalid year: {value.year}"
+            raise BSBLANInvalidParameterError(msg)
+        # BSB-LAN 4.1 rejects a space between the date and the time
         response = await self._request(
-            base_path="/JS", data=self._set_payload("0", time_value)
+            base_path="/JS",
+            data=self._set_payload("0", value.strftime("%d.%m.%Y_%H:%M:%S")),
         )
         logger.debug("Response for setting time: %s", response)
+        if response.get("0", {}).get("status") != 1:
+            raise BSBLANError(ErrorMsg.TIME_SYNC_FAILED)
 
     async def thermostat(  # noqa: PLR0913  # pylint: disable=too-many-arguments
         self,
@@ -992,21 +1000,6 @@ class BSBLAN:
             circuit,
         )
 
-    def _validate_time_format(self, time_value: str) -> None:
-        """Validate the time format.
-
-        Args:
-            time_value (str): The time value to validate.
-
-        Raises:
-            BSBLANInvalidParameterError: If the time format is invalid.
-
-        """
-        try:
-            validate_time_format(time_value, Validation.MIN_YEAR, Validation.MAX_YEAR)
-        except ValueError as err:
-            raise BSBLANInvalidParameterError(str(err)) from err
-
     def _set_payload(
         self, parameter: str, value: str, type_: str = "1"
     ) -> dict[str, Any]:

bsblan/constants.py

@@ -561,6 +561,7 @@ class ErrorMsg:
     )
     NO_HEATING_SCHEDULE_PARAMS = "No heating schedule parameters available"
     TIME_SYNC_NOT_SUPPORTED = "Time synchronization is not supported by this device"
+    TIME_SYNC_FAILED = "The device did not accept the new time"
     BUS_WRITE_NOT_SUPPORTED = "Writing parameters is not supported by this device"
 
 

bsblan/utility.py

@@ -3,7 +3,6 @@
 from __future__ import annotations
 
 import logging
-import re
 from dataclasses import dataclass, field
 from typing import Any
 
@@ -12,65 +11,6 @@ from .constants import CircuitConfig
 logger = logging.getLogger(__name__)
 
 
-def validate_time_format(
-    time_value: str,
-    min_year: int,
-    max_year: int,
-) -> None:
-    """Validate the BSB-LAN time format.
-
-    Args:
-        time_value: The time value to validate in format DD.MM.YYYY HH:MM:SS.
-        min_year: Minimum valid year.
-        max_year: Maximum valid year.
-
-    Raises:
-        ValueError: If the time format is invalid.
-
-    """
-    # BSB-LAN supports format: DD.MM.YYYY HH:MM:SS (e.g., "13.08.2025 10:25:55")
-    pattern = r"^(\d{2})\.(\d{2})\.(\d{4}) (\d{2}):(\d{2}):(\d{2})$"
-
-    match = re.match(pattern, time_value)
-    if not match:
-        msg = f"Invalid time format: {time_value}. Expected DD.MM.YYYY HH:MM:SS"
-        raise ValueError(msg)
-
-    day, month, year, hour, minute, second = map(int, match.groups())
-
-    # Validate ranges
-    if not (1 <= day <= 31):
-        msg = f"Invalid day: {day}"
-        raise ValueError(msg)
-    if not (1 <= month <= 12):
-        msg = f"Invalid month: {month}"
-        raise ValueError(msg)
-    if not (min_year <= year <= max_year):
-        msg = f"Invalid year: {year}"
-        raise ValueError(msg)
-    if not (0 <= hour <= 23):
-        msg = f"Invalid hour: {hour}"
-        raise ValueError(msg)
-    if not (0 <= minute <= 59):
-        msg = f"Invalid minute: {minute}"
-        raise ValueError(msg)
-    if not (0 <= second <= 59):
-        msg = f"Invalid second: {second}"
-        raise ValueError(msg)
-
-    # Additional validation for days per month
-    if month in (4, 6, 9, 11) and day > 30:
-        msg = f"Invalid day {day} for month {month}"
-        raise ValueError(msg)
-    if month == 2:
-        # Leap year check
-        is_leap = (year % 4 == 0 and year % 100 != 0) or (year % 400 == 0)
-        max_day = 29 if is_leap else 28
-        if day > max_day:
-            msg = f"Invalid day {day} for February in year {year}"
-            raise ValueError(msg)
-
-
 def is_param_value_active(param: dict[str, Any] | None) -> bool:
     """Check whether a parameter payload carries an active value.
 

{python_bsblan-6.1.11.dist-info → python_bsblan-6.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: python-bsblan
-Version: 6.1.11
+Version: 6.2.0
 Summary: Asynchronous Python client for BSBLAN API
 Project-URL: Homepage, https://github.com/liudger/python-bsblan
 Project-URL: Repository, https://github.com/liudger/python-bsblan

{python_bsblan-6.1.11.dist-info → python_bsblan-6.2.0.dist-info}/RECORD

@@ -7,13 +7,13 @@ bsblan/_thermostat.py,sha256=Yl-AM4gJikwSQwcpYH7fHH6I1lEVggnendf28-d0IAE,6520
 bsblan/_transport.py,sha256=qNtV_8uJrfYfHlbaExPln4jCaJxqE5sypq5OHyxG8KE,8266
 bsblan/_validation.py,sha256=w93Hg5sqeJKXOozwWV4Hjh7_aR197tOpHn6LgxL1Pek,17836
 bsblan/_version.py,sha256=hpeIg9JUswHSorY3iSUERcMC1MzwM9Rpdo1wqeh5rc8,2799
-bsblan/bsblan.py,sha256=hyjd2xmK5TjvKzWHf765WEMs3hgTKxpTYu6QTgPewrE,49016
-bsblan/constants.py,sha256=rAiiwy-r9FhR1b118q80O07xeFvBjWqyRBdEj8DUcdM,26309
+bsblan/bsblan.py,sha256=XOzwrThvxT6NQcaKz7BKdpeZPkZRBbgnXd8plcrU-X4,48987
+bsblan/constants.py,sha256=xcL43NpsyrJ6NRJHO2x2iH9J97Dq6DsVsFn-CzpBxoo,26373
 bsblan/exceptions.py,sha256=Z9pXtVc8zhy9FTBkT8leJ1UE9zdOdLHF7pE7C4GjBmg,2795
 bsblan/models.py,sha256=UJbCoVr7_ohtKG5n_jSzoYDzBpl9y4OWj3bqGYRvf_0,23111
 bsblan/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-bsblan/utility.py,sha256=5oD3f84ke_r7pTQN2jjhhgtVjLjq1Ohld3LlHN7m8xg,7421
-python_bsblan-6.1.11.dist-info/METADATA,sha256=zgvdwNLgAk8W5AKXXa9lDMrAFI0YTiVQ_gvo65nJGp4,9586
-python_bsblan-6.1.11.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-python_bsblan-6.1.11.dist-info/licenses/LICENSE.md,sha256=Shv8HPcD1WbZjBPvfb5r3h_cwaPeVaUZMUqU_XQGwGw,1092
-python_bsblan-6.1.11.dist-info/RECORD,,
+bsblan/utility.py,sha256=V5OjZieC6NpQHMKdfrUMJkjSrbrMvpnT7A5k5bQnmgM,5543
+python_bsblan-6.2.0.dist-info/METADATA,sha256=DyrUwQh3bu9ueQKDpOkBipZzpIIAPo1OG-q0bn2ZFt8,9585
+python_bsblan-6.2.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+python_bsblan-6.2.0.dist-info/licenses/LICENSE.md,sha256=Shv8HPcD1WbZjBPvfb5r3h_cwaPeVaUZMUqU_XQGwGw,1092
+python_bsblan-6.2.0.dist-info/RECORD,,