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

{python_bsblan-3.1.4 → python_bsblan-3.1.6}/.github/LICENSE.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright (c) 2023-2024 Willem-Jan L. van Rootselaar
+Copyright (c) 2023-2026 Willem-Jan L. van Rootselaar
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{python_bsblan-3.1.4 → python_bsblan-3.1.6}/.github/renovate.json

@@ -4,6 +4,7 @@
   "rebaseWhen": "behind-base-branch",
   "dependencyDashboard": true,
   "labels": ["dependencies", "no-stale"],
+  "platformAutomerge": true,
   "lockFileMaintenance": {
     "enabled": true,
     "automerge": true
@@ -11,16 +12,17 @@
   "commitMessagePrefix": "⬆️",
   "packageRules": [
     {
-      "matchManagers": ["poetry"],
+      "matchManagers": ["uv"],
       "addLabels": ["python"]
     },
     {
-      "matchManagers": ["poetry"],
+      "matchManagers": ["uv"],
       "matchDepTypes": ["dev"],
       "rangeStrategy": "pin"
     },
     {
-      "matchManagers": ["poetry"],
+      "description": "Automerge minor/patch Python updates (after CI passes)",
+      "matchManagers": ["uv"],
       "matchUpdateTypes": ["minor", "patch"],
       "automerge": true
     },
@@ -40,9 +42,16 @@
       "rangeStrategy": "pin"
     },
     {
+      "description": "Automerge minor/patch GitHub Actions updates (after CI passes)",
       "matchManagers": ["github-actions"],
       "matchUpdateTypes": ["minor", "patch"],
       "automerge": true
+    },
+    {
+      "description": "Don't automerge major GitHub Actions updates",
+      "matchManagers": ["github-actions"],
+      "matchUpdateTypes": ["major"],
+      "automerge": false
     }
   ]
 }

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

@@ -0,0 +1,24 @@
+---
+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]' &&
+      github.actor_id == '29139614' &&
+      github.event.pull_request.head.repo.full_name == github.repository
+    steps:
+      # yamllint disable-line rule:line-length
+      - uses: hmarr/auto-approve-action@f0939ea97e9205ef24d872e76833fa908a770363 # v4.0.0

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

@@ -19,6 +19,6 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Initialize CodeQL
-        uses: github/codeql-action/init@v3.31.6
+        uses: github/codeql-action/init@v3.31.9
       - name: 🚀 Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v3.31.6
+        uses: github/codeql-action/analyze@v3.31.9

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

@@ -4,7 +4,9 @@ name: Linting
 # yamllint disable-line rule:truthy
 on:
   push:
+    branches: [main]
   pull_request:
+    branches: [main]
   workflow_dispatch:
 
 env:
@@ -18,7 +20,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -38,7 +40,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -60,7 +62,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -104,7 +106,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -124,7 +126,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -144,7 +146,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}

{python_bsblan-3.1.4 → python_bsblan-3.1.6}/.github/workflows/lock.yaml

@@ -12,7 +12,7 @@ jobs:
     name: 🔒 Lock closed issues and PRs
     runs-on: ubuntu-latest
     steps:
-      - uses: dessant/lock-threads@v5.0.1
+      - uses: dessant/lock-threads@v6.0.0
         with:
           github-token: ${{ github.token }}
           issue-inactive-days: "30"

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

@@ -24,7 +24,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}

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

@@ -4,7 +4,9 @@ name: Testing
 # yamllint disable-line rule:truthy
 on:
   push:
+    branches: [main]
   pull_request:
+    branches: [main]
   workflow_dispatch:
 
 env:
@@ -21,7 +23,7 @@ jobs:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ matrix.python }}
@@ -34,7 +36,7 @@ jobs:
       - name: 🚀 Run pytest
         run: uv run pytest --cov=bsblan tests
       - name: ⬆️ Upload coverage artifact
-        uses: actions/upload-artifact@v5.0.0
+        uses: actions/upload-artifact@v6.0.0
         with:
           name: coverage-${{ matrix.python }}
           include-hidden-files: true
@@ -49,9 +51,9 @@ jobs:
         with:
           fetch-depth: 0
       - name: ⬇️ Download coverage data
-        uses: actions/download-artifact@v6.0.0
+        uses: actions/download-artifact@v7.0.0
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -66,7 +68,7 @@ jobs:
           uv run coverage combine coverage*/.coverage*
           uv run coverage xml -i
       - name: 🚀 Upload coverage report
-        uses: codecov/codecov-action@v5.5.1
+        uses: codecov/codecov-action@v5.5.2
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
       - name: SonarCloud Scan

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

@@ -4,21 +4,25 @@ name: Typing
 # yamllint disable-line rule:truthy
 on:
   push:
+    branches: [main]
   pull_request:
+    branches: [main]
   workflow_dispatch:
 
 env:
   DEFAULT_PYTHON: "3.13"
 
 jobs:
-  mypy:
-    name: mypy
+  ty:
+    name: ty
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
     steps:
       - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v6.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -28,5 +32,5 @@ jobs:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install dependencies
         run: uv sync --dev
-      - name: 🚀 Run mypy
-        run: uv run mypy examples src tests
+      - name: 🚀 Run ty
+        run: uv run ty check examples src tests

python_bsblan-3.1.6/.nvmrc

@@ -0,0 +1 @@
+24.12.0

{python_bsblan-3.1.4 → python_bsblan-3.1.6}/.pre-commit-config.yaml

@@ -83,11 +83,11 @@ repos:
         types: [text]
         entry: uv run end-of-file-fixer
         stages: [pre-commit, pre-push, manual]
-      - id: mypy
-        name: 🆎 Static type checking using mypy
+      - id: ty
+        name: 🆎 Static type checking using ty
         language: system
         types: [python]
-        entry: uv run mypy
+        entry: uv run ty check
         require_serial: true
       - id: no-commit-to-branch
         name: 🛑 Don't commit to main branch

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-bsblan
-Version: 3.1.4
+Version: 3.1.6
 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
@@ -48,7 +48,7 @@ Asynchronous Python client for BSBLan.
 
 ## About
 
-This package allows you to control and monitor an BSBLan device
+This package allows you to control and monitor a BSBLan device
 programmatically. It is mainly created to allow third-party programs to automate
 the behavior of [BSBLan][bsblanmodule].
 
@@ -121,9 +121,9 @@ async def main() -> None:
         print("\nSetting temperature to 18°C")
         await bsblan.thermostat(target_temperature="18")
 
-        # Set HVAC mode
+        # Set HVAC mode (using raw integer: 0=off, 1=auto, 2=eco, 3=heat)
         print("Setting HVAC mode to heat")
-        await bsblan.thermostat(hvac_mode="heat")
+        await bsblan.thermostat(hvac_mode=3)
 
         # Get and print sensor information
         sensor: Sensor = await bsblan.sensor()
@@ -211,7 +211,7 @@ check [the contributor's page][contributors].
 
 MIT License
 
-Copyright (c) 2023-2025 WJ van Rootselaar
+Copyright (c) 2023-2026 WJ van Rootselaar
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -243,9 +243,7 @@ SOFTWARE.
 [keepchangelog]: http://keepachangelog.com/en/1.0.0/
 [license-shield]: https://img.shields.io/badge/license-MIT-blue.svg
 [liudger]: https://github.com/liudger
-[maintenance-shield]: https://img.shields.io/maintenance/yes/2025.svg
-[poetry]: https://python-poetry.org
-[poetry-install]: https://python-poetry.org/docs/#installation
+[maintenance-shield]: https://img.shields.io/maintenance/yes/2026.svg
 [uv]: https://docs.astral.sh/uv/
 [uv-install]: https://docs.astral.sh/uv/getting-started/installation/
 [pre-commit]: https://pre-commit.com/

{python_bsblan-3.1.4 → python_bsblan-3.1.6}/README.md

@@ -16,7 +16,7 @@ Asynchronous Python client for BSBLan.
 
 ## About
 
-This package allows you to control and monitor an BSBLan device
+This package allows you to control and monitor a BSBLan device
 programmatically. It is mainly created to allow third-party programs to automate
 the behavior of [BSBLan][bsblanmodule].
 
@@ -89,9 +89,9 @@ async def main() -> None:
         print("\nSetting temperature to 18°C")
         await bsblan.thermostat(target_temperature="18")
 
-        # Set HVAC mode
+        # Set HVAC mode (using raw integer: 0=off, 1=auto, 2=eco, 3=heat)
         print("Setting HVAC mode to heat")
-        await bsblan.thermostat(hvac_mode="heat")
+        await bsblan.thermostat(hvac_mode=3)
 
         # Get and print sensor information
         sensor: Sensor = await bsblan.sensor()
@@ -179,7 +179,7 @@ check [the contributor's page][contributors].
 
 MIT License
 
-Copyright (c) 2023-2025 WJ van Rootselaar
+Copyright (c) 2023-2026 WJ van Rootselaar
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -211,9 +211,7 @@ SOFTWARE.
 [keepchangelog]: http://keepachangelog.com/en/1.0.0/
 [license-shield]: https://img.shields.io/badge/license-MIT-blue.svg
 [liudger]: https://github.com/liudger
-[maintenance-shield]: https://img.shields.io/maintenance/yes/2025.svg
-[poetry]: https://python-poetry.org
-[poetry-install]: https://python-poetry.org/docs/#installation
+[maintenance-shield]: https://img.shields.io/maintenance/yes/2026.svg
 [uv]: https://docs.astral.sh/uv/
 [uv-install]: https://docs.astral.sh/uv/getting-started/installation/
 [pre-commit]: https://pre-commit.com/

{python_bsblan-3.1.4 → python_bsblan-3.1.6}/examples/control.py

@@ -21,6 +21,7 @@ from bsblan import (
     BSBLANConfig,
     Device,
     DeviceTime,
+    HeatingCircuitStatus,
     HotWaterConfig,
     HotWaterSchedule,
     HotWaterState,
@@ -29,6 +30,7 @@ from bsblan import (
     SetHotWaterParam,
     State,
     StaticState,
+    get_hvac_action_category,
 )
 from bsblan.models import DHWTimeSwitchPrograms
 
@@ -66,6 +68,31 @@ def print_attributes(title: str, attributes: dict[str, str]) -> None:
         print(f"{label}: {value}")
 
 
+def get_hvac_action_name(status_code: int) -> str:
+    """Map BSB-LAN parameter 8000 status code to a human-readable HVAC action.
+
+    BSB-LAN parameter 8000 ("Status heating circuit 1") returns vendor-specific
+    status codes. This function maps those codes to simplified HVAC action states
+    compatible with Home Assistant and other automation systems.
+
+    Args:
+        status_code: The raw status code from parameter 8000 (hvac_action.value).
+
+    Returns:
+        str: Human-readable HVAC action name. Returns "idle" for unmapped codes.
+
+    Example:
+        >>> state = await bsblan.state()
+        >>> if state.hvac_action is not None:
+        ...     action = get_hvac_action_name(state.hvac_action.value)
+        ...     print(f"Current HVAC action: {action}")
+
+    """
+    # Use the new enum-based approach
+    category = get_hvac_action_category(status_code)
+    return category.name.lower()
+
+
 async def print_state(state: State) -> None:
     """Print the current state of the BSBLan device.
 
@@ -73,8 +100,29 @@ async def print_state(state: State) -> None:
         state (State): The current state of the BSBLan device.
 
     """
+    # Get the HVAC action - both the raw value and mapped action name
+    hvac_action_desc = await get_attribute(state.hvac_action, "desc", "Unknown Action")
+    hvac_action_value = await get_attribute(state.hvac_action, "value", "N/A")
+
+    # Map the raw status code to a simplified action name using the new enum approach
+    hvac_action_mapped = "N/A"
+    status_name = "N/A"
+    if hvac_action_value != "N/A":
+        try:
+            status_code = int(hvac_action_value)
+            # Get the category (heating, cooling, etc.)
+            hvac_action_mapped = get_hvac_action_name(status_code)
+            # Get the specific status name from the enum (if known)
+            status = HeatingCircuitStatus.from_value(status_code)
+            status_name = status.name if status else "UNKNOWN"
+        except (ValueError, TypeError):
+            hvac_action_mapped = "unknown"
+
     attributes = {
-        "HVAC Action": await get_attribute(state.hvac_action, "desc", "Unknown Action"),
+        "HVAC Action (raw value)": str(hvac_action_value),
+        "HVAC Action (device desc)": hvac_action_desc,
+        "HVAC Action (status name)": status_name,
+        "HVAC Action (category)": hvac_action_mapped,
         "HVAC Mode": await get_attribute(state.hvac_mode, "desc", "Unknown Mode"),
         "Current Temperature": await get_attribute(
             state.current_temperature, "value", "N/A"

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

@@ -1,6 +1,6 @@
 [project]
 name = "python-bsblan"
-version = "3.1.4"
+version = "3.1.6"
 description = "Asynchronous Python client for BSBLAN API"
 authors = [
     {name = "Willem-Jan van Rootselaar", email = "liudgervr@gmail.com"}
@@ -178,27 +178,27 @@ build-backend = "hatchling.build"
 dev = [
     "aresponses==3.0.0",
     "bandit==1.9.2",
-    "black==25.11.0",
+    "black==25.12.0",
     "blacken-docs==1.20.0",
     "codespell==2.4.1",
     "covdefaults==2.3.0",
-    "coverage==7.12.0",
+    "coverage==7.13.1",
     "darglint==1.8.1",
     "flake8==7.3.0",
-    "flake8-simplify==0.22.0",
+    "flake8-simplify==0.30.0",
     # 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.19.0",
-    "pre-commit==4.5.0",
+    "isort==7.0.0",
+    "ty==0.0.8",
+    "pre-commit==4.5.1",
     "pre-commit-hooks==6.0.0",
-    "pylint==3.3.9",
+    "pylint==4.0.4",
     "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.8",
+    "ruff==0.14.10",
     "safety==3.7.0",
     "vulture==2.14",
     "yamllint==1.37.1",

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

@@ -1,6 +1,11 @@
 """Asynchronous Python client for BSBLAN."""
 
 from .bsblan import BSBLAN, BSBLANConfig
+from .constants import (
+    HeatingCircuitStatus,
+    HVACActionCategory,
+    get_hvac_action_category,
+)
 from .exceptions import BSBLANAuthError, BSBLANConnectionError, BSBLANError
 from .models import (
     DaySchedule,
@@ -32,6 +37,8 @@ __all__ = [
     "Device",
     "DeviceTime",
     "EntityInfo",
+    "HVACActionCategory",
+    "HeatingCircuitStatus",
     "HotWaterConfig",
     "HotWaterSchedule",
     "HotWaterState",
@@ -41,4 +48,5 @@ __all__ = [
     "State",
     "StaticState",
     "TimeSlot",
+    "get_hvac_action_category",
 ]