python-bsblan 3.1.2__tar.gz → 3.1.4__tar.gz

python_bsblan-3.1.4/.github/workflows/auto-approve-renovate.yml

@@ -0,0 +1,20 @@
+---
+name: Auto-approve Renovate PRs
+
+# yamllint disable-line rule:truthy
+on:
+  pull_request_target:
+    types:
+      - opened
+      - synchronize
+      - reopened
+
+permissions:
+  pull-requests: write
+
+jobs:
+  auto-approve:
+    runs-on: ubuntu-latest
+    if: github.actor == 'renovate[bot]'
+    steps:
+      - uses: hmarr/auto-approve-action@v4

{python_bsblan-3.1.2 → python_bsblan-3.1.4}/.github/workflows/codeql.yaml

@@ -17,7 +17,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
       - name: 🏗 Initialize CodeQL
         uses: github/codeql-action/init@v3.31.6
       - name: 🚀 Perform CodeQL Analysis

{python_bsblan-3.1.2 → python_bsblan-3.1.4}/.github/workflows/labels.yaml

@@ -16,7 +16,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
       - name: 🚀 Run Label Syncer
         uses: micnncim/action-label-syncer@v1.3.0
         env:

{python_bsblan-3.1.2 → python_bsblan-3.1.4}/.github/workflows/linting.yaml

@@ -16,14 +16,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v6
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.0.0
+        uses: actions/setup-python@v6.1.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install Python dependencies
@@ -36,14 +36,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v6
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.0.0
+        uses: actions/setup-python@v6.1.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install Python dependencies
@@ -58,14 +58,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v6
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.0.0
+        uses: actions/setup-python@v6.1.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install Python dependencies
@@ -102,14 +102,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v6
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.0.0
+        uses: actions/setup-python@v6.1.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install Python dependencies
@@ -122,14 +122,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v6
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.0.0
+        uses: actions/setup-python@v6.1.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install Python dependencies
@@ -142,20 +142,20 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v6
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.0.0
+        uses: actions/setup-python@v6.1.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install Python dependencies
         run: uv sync --dev
       - name: 🏗 Set up Node.js
-        uses: actions/setup-node@v4.4.0
+        uses: actions/setup-node@v6.1.0
         with:
           node-version-file: ".nvmrc"
           cache: "npm"

{python_bsblan-3.1.2 → python_bsblan-3.1.4}/.github/workflows/release.yaml

@@ -22,14 +22,14 @@ jobs:
       id-token: write
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v6
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.0.0
+        uses: actions/setup-python@v6.1.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install dependencies
@@ -48,7 +48,7 @@ jobs:
           verbose: true
           print-hash: true
       - name: ✍️ Sign published artifacts
-        uses: sigstore/gh-action-sigstore-python@v3.1.0
+        uses: sigstore/gh-action-sigstore-python@v3.2.0
         with:
           inputs: ./dist/*.tar.gz ./dist/*.whl
           release-signing-artifacts: false

{python_bsblan-3.1.2 → python_bsblan-3.1.4}/.github/workflows/stale.yaml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: 🚀 Run stale
-        uses: actions/stale@v10.1.0
+        uses: actions/stale@v10.1.1
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           days-before-stale: 30

{python_bsblan-3.1.2 → python_bsblan-3.1.4}/.github/workflows/tests.yaml

@@ -19,14 +19,14 @@ jobs:
         python: ["3.12", "3.13", "3.14"]
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v6
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ matrix.python }}
         id: python
-        uses: actions/setup-python@v6.0.0
+        uses: actions/setup-python@v6.1.0
         with:
           python-version: ${{ matrix.python }}
       - name: 🏗 Install dependencies
@@ -34,7 +34,7 @@ jobs:
       - name: 🚀 Run pytest
         run: uv run pytest --cov=bsblan tests
       - name: ⬆️ Upload coverage artifact
-        uses: actions/upload-artifact@v4.6.2
+        uses: actions/upload-artifact@v5.0.0
         with:
           name: coverage-${{ matrix.python }}
           include-hidden-files: true
@@ -45,18 +45,18 @@ jobs:
     needs: pytest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
         with:
           fetch-depth: 0
       - name: ⬇️ Download coverage data
-        uses: actions/download-artifact@v5.0.0
+        uses: actions/download-artifact@v6.0.0
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v6
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.0.0
+        uses: actions/setup-python@v6.1.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install dependencies

{python_bsblan-3.1.2 → python_bsblan-3.1.4}/.github/workflows/typing.yaml

@@ -16,14 +16,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v5.0.1
+        uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v6
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.0.0
+        uses: actions/setup-python@v6.1.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install dependencies

{python_bsblan-3.1.2 → python_bsblan-3.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-bsblan
-Version: 3.1.2
+Version: 3.1.4
 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-3.1.2 → python_bsblan-3.1.4}/package-lock.json

@@ -12,13 +12,13 @@
         "url-parse": "1.5.10"
       },
       "devDependencies": {
-        "prettier": "3.6.2"
+        "prettier": "3.7.4"
       }
     },
     "node_modules/prettier": {
-      "version": "3.6.2",
-      "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.6.2.tgz",
-      "integrity": "sha512-I7AIg5boAr5R0FFtJ6rCfD+LFsWHp81dolrFD8S79U9tb8Az2nGrJncnMSnys+bpQJfRUzqs9hnA81OAA3hCuQ==",
+      "version": "3.7.4",
+      "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.7.4.tgz",
+      "integrity": "sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA==",
       "dev": true,
       "license": "MIT",
       "bin": {

{python_bsblan-3.1.2 → python_bsblan-3.1.4}/package.json

@@ -9,7 +9,7 @@
   "author": "WJL van Rootselaar <liudgervr@gmail.com>",
   "license": "MIT",
   "devDependencies": {
-    "prettier": "3.6.2"
+    "prettier": "3.7.4"
   },
   "dependencies": {
     "url-parse": "1.5.10"

{python_bsblan-3.1.2 → python_bsblan-3.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-bsblan"
-version = "3.1.2"
+version = "3.1.4"
 description = "Asynchronous Python client for BSBLAN API"
 authors = [
     {name = "Willem-Jan van Rootselaar", email = "liudgervr@gmail.com"}
@@ -71,7 +71,7 @@ exclude_lines = [
 # free to run mypy on Windows, Linux, or macOS and get consistent
 # results.
 platform = "linux"
-python_version = "3.11"
+python_version = "3.12"
 
 # show error messages from unrelated files
 follow_imports = "normal"
@@ -135,7 +135,7 @@ min-similarity-lines = 4  # Minimum lines number of a similarity.
 max-line-length=88
 
 [tool.pytest.ini_options]
-addopts = "--cov"
+addopts = "--cov -n auto"
 asyncio_mode = "auto"
 
 [tool.ruff.lint]
@@ -189,15 +189,16 @@ dev = [
     # hatch is required to support type hinting and proper packaging of the py.typed file.
     "hatch>=1.14.1",
     "isort==6.1.0",
-    "mypy==1.18.2",
+    "mypy==1.19.0",
     "pre-commit==4.5.0",
     "pre-commit-hooks==6.0.0",
     "pylint==3.3.9",
     "pytest>=8.3.5",
     "pytest-asyncio==1.3.0",
     "pytest-cov==7.0.0",
+    "pytest-xdist>=3.8.0",
     "pyupgrade==3.21.2",
-    "ruff==0.14.6",
+    "ruff==0.14.8",
     "safety==3.7.0",
     "vulture==2.14",
     "yamllint==1.37.1",

{python_bsblan-3.1.2 → python_bsblan-3.1.4}/src/bsblan/__init__.py

@@ -3,9 +3,12 @@
 from .bsblan import BSBLAN, BSBLANConfig
 from .exceptions import BSBLANAuthError, BSBLANConnectionError, BSBLANError
 from .models import (
+    DaySchedule,
     Device,
     DeviceTime,
+    DHWSchedule,
     DHWTimeSwitchPrograms,
+    EntityInfo,
     HotWaterConfig,
     HotWaterSchedule,
     HotWaterState,
@@ -14,6 +17,7 @@ from .models import (
     SetHotWaterParam,
     State,
     StaticState,
+    TimeSlot,
 )
 
 __all__ = [
@@ -22,9 +26,12 @@ __all__ = [
     "BSBLANConfig",
     "BSBLANConnectionError",
     "BSBLANError",
+    "DHWSchedule",
     "DHWTimeSwitchPrograms",
+    "DaySchedule",
     "Device",
     "DeviceTime",
+    "EntityInfo",
     "HotWaterConfig",
     "HotWaterSchedule",
     "HotWaterState",
@@ -33,4 +40,5 @@ __all__ = [
     "SetHotWaterParam",
     "State",
     "StaticState",
+    "TimeSlot",
 ]

{python_bsblan-3.1.2 → python_bsblan-3.1.4}/src/bsblan/bsblan.py

@@ -11,6 +11,7 @@ if TYPE_CHECKING:
     from collections.abc import Mapping
 
 import aiohttp
+import backoff
 from aiohttp.hdrs import METH_POST
 from aiohttp.helpers import BasicAuth
 from packaging import version as pkg_version
@@ -29,6 +30,7 @@ from .constants import (
     MAX_VALID_YEAR,
     MIN_VALID_YEAR,
     MULTI_PARAMETER_ERROR_MSG,
+    NO_SCHEDULE_ERROR_MSG,
     NO_STATE_ERROR_MSG,
     SESSION_NOT_INITIALIZED_ERROR_MSG,
     SETTABLE_HOT_WATER_PARAMS,
@@ -45,8 +47,10 @@ from .exceptions import (
     BSBLANVersionError,
 )
 from .models import (
+    DaySchedule,
     Device,
     DeviceTime,
+    DHWSchedule,
     HotWaterConfig,
     HotWaterSchedule,
     HotWaterState,
@@ -409,6 +413,9 @@ class BSBLAN:
     ) -> dict[str, Any]:
         """Handle a request to a BSBLAN device.
 
+        Uses exponential backoff to retry on transient connection errors.
+        Will not retry on authentication errors (401, 403) or not found (404).
+
         Args:
             method (str): The HTTP method to use for the request.
             base_path (str): The base path for the URL.
@@ -420,9 +427,47 @@ class BSBLAN:
             dict[str, Any]: The JSON response from the BSBLAN device.
 
         Raises:
-            BSBLANConnectionError: If there is a connection error.
+            BSBLANConnectionError: If there is a connection error after retries.
+            BSBLANAuthError: If authentication fails (not retried).
             BSBLANError: If there is an error with the request.
 
+        """
+        try:
+            return await self._request_with_retry(method, base_path, data, params)
+        except TimeoutError as e:
+            raise BSBLANConnectionError(BSBLANConnectionError.message_timeout) from e
+        except aiohttp.ClientError as e:
+            raise BSBLANConnectionError(BSBLANConnectionError.message_error) from e
+
+    @backoff.on_exception(
+        backoff.expo,
+        (TimeoutError, aiohttp.ClientError),
+        max_tries=3,
+        max_time=30,
+        giveup=lambda e: isinstance(e, aiohttp.ClientResponseError) and e.status == 404,
+        logger=logger,
+    )
+    async def _request_with_retry(
+        self,
+        method: str,
+        base_path: str,
+        data: dict[str, object] | None,
+        params: Mapping[str, str | int] | str | None,
+    ) -> dict[str, Any]:
+        """Execute HTTP request with retry logic.
+
+        This internal method handles the actual HTTP request and is decorated
+        with backoff for automatic retries on transient failures.
+
+        Args:
+            method: The HTTP method to use.
+            base_path: The base path for the URL.
+            data: The data to send in the request body.
+            params: The query parameters to include.
+
+        Returns:
+            dict[str, Any]: The JSON response from the BSBLAN device.
+
         """
         if self.session is None:
             raise BSBLANError(SESSION_NOT_INITIALIZED_ERROR_MSG)
@@ -443,14 +488,10 @@ class BSBLAN:
                     response.raise_for_status()
                     response_data = cast("dict[str, Any]", await response.json())
                     return self._process_response(response_data, base_path)
-        except TimeoutError as e:
-            raise BSBLANConnectionError(BSBLANConnectionError.message_timeout) from e
         except aiohttp.ClientResponseError as e:
             if e.status in (401, 403):
                 raise BSBLANAuthError from e
-            raise BSBLANConnectionError(BSBLANConnectionError.message_error) from e
-        except aiohttp.ClientError as e:
-            raise BSBLANConnectionError(BSBLANConnectionError.message_error) from e
+            raise
         except (ValueError, UnicodeDecodeError) as e:
             # Handle JSON decode errors and other parsing issues
             error_msg = f"Invalid response format from BSB-LAN device: {e!s}"
@@ -589,9 +630,8 @@ class BSBLAN:
             State: The current state of the BSBLAN device.
 
         Note:
-            The hvac_mode.value is returned as a raw integer from the device.
-            Use HVAC_MODE_DICT from bsblan.constants to convert to string
-            representation (e.g., "off", "auto", "eco", "heat").
+            The hvac_mode.value is returned as a raw integer from the device:
+            0=off, 1=auto, 2=eco, 3=heat.
 
         """
         return await self._fetch_section_data("heating", State)
@@ -677,8 +717,6 @@ class BSBLAN:
             target_temperature (str | None): The target temperature to set.
             hvac_mode (int | None): The HVAC mode to set as raw integer value.
                 Valid values: 0=off, 1=auto, 2=eco, 3=heat.
-                Use HVAC_MODE_DICT_REVERSE from bsblan.constants to convert
-                string names to integers.
 
         """
         await self._initialize_temperature_range()
@@ -930,6 +968,50 @@ class BSBLAN:
         state = self._prepare_hot_water_state(params)
         await self._set_device_state(state)
 
+    async def set_hot_water_schedule(self, schedule: DHWSchedule) -> None:
+        """Set hot water time program schedules.
+
+        This method allows setting weekly DHW schedules using a type-safe
+        interface with TimeSlot and DaySchedule objects.
+
+        Example:
+            schedule = DHWSchedule(
+                monday=DaySchedule(slots=[
+                    TimeSlot(time(6, 0), time(8, 0)),
+                    TimeSlot(time(17, 0), time(21, 0)),
+                ]),
+                tuesday=DaySchedule(slots=[
+                    TimeSlot(time(6, 0), time(8, 0)),
+                ])
+            )
+            await client.set_hot_water_schedule(schedule)
+
+        Args:
+            schedule: DHWSchedule object containing the weekly schedule.
+
+        Raises:
+            BSBLANError: If no schedule is provided.
+
+        """
+        if not schedule.has_any_schedule():
+            raise BSBLANError(NO_SCHEDULE_ERROR_MSG)
+
+        # Invert DHW_TIME_PROGRAM_PARAMS to get day_name -> param_id mapping
+        # Exclude standard_values as it's not a day of the week
+        day_param_map = {
+            v: k for k, v in DHW_TIME_PROGRAM_PARAMS.items() if v != "standard_values"
+        }
+
+        for day_name, param_id in day_param_map.items():
+            day_schedule: DaySchedule | None = getattr(schedule, day_name)
+            if day_schedule is not None:
+                state = {
+                    "Parameter": param_id,
+                    "Value": day_schedule.to_bsblan_format(),
+                    "Type": "1",
+                }
+                await self._set_device_state(state)
+
     def _prepare_hot_water_state(
         self,
         params: SetHotWaterParam,

{python_bsblan-3.1.2 → python_bsblan-3.1.4}/src/bsblan/constants.py

@@ -133,6 +133,7 @@ VALID_HVAC_MODES: Final[set[int]] = {0, 1, 2, 3}
 
 # Error Messages
 NO_STATE_ERROR_MSG: Final[str] = "No state provided."
+NO_SCHEDULE_ERROR_MSG: Final[str] = "No schedule provided."
 VERSION_ERROR_MSG: Final[str] = "Version not supported"
 FIRMWARE_VERSION_ERROR_MSG: Final[str] = "Firmware version not available"
 TEMPERATURE_RANGE_ERROR_MSG: Final[str] = "Temperature range not initialized"