python-bsblan 4.1.0b2__tar.gz → 4.2.0__tar.gz

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/.github/workflows/codeql.yaml

@@ -11,14 +11,19 @@ on:
   schedule:
     - cron: "30 1 * * 0"
 
+permissions:
+  actions: read
+  contents: read
+  security-events: write
+
 jobs:
   codeql:
     name: Scanning
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v6.0.1
+        uses: actions/checkout@v6.0.2
       - name: 🏗 Initialize CodeQL
-        uses: github/codeql-action/init@v4.31.9
+        uses: github/codeql-action/init@v4.32.2
       - name: 🚀 Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v4.31.9
+        uses: github/codeql-action/analyze@v4.32.2

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/.github/workflows/labels.yaml

@@ -10,13 +10,17 @@ on:
       - .github/labels.yml
   workflow_dispatch:
 
+permissions:
+  contents: read
+  issues: write
+
 jobs:
   labels:
     name: ♻️ Sync labels
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v6.0.1
+        uses: actions/checkout@v6.0.2
       - name: 🚀 Run Label Syncer
         uses: micnncim/action-label-syncer@v1.3.0
         env:

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/.github/workflows/linting.yaml

@@ -9,6 +9,9 @@ on:
     branches: [main]
   workflow_dispatch:
 
+permissions:
+  contents: read
+
 env:
   DEFAULT_PYTHON: "3.13"
 
@@ -18,14 +21,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v6.0.1
+        uses: actions/checkout@v6.0.2
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.1.0
+        uses: actions/setup-python@v6.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install Python dependencies
@@ -38,14 +41,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v6.0.1
+        uses: actions/checkout@v6.0.2
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.1.0
+        uses: actions/setup-python@v6.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install Python dependencies
@@ -60,14 +63,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v6.0.1
+        uses: actions/checkout@v6.0.2
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.1.0
+        uses: actions/setup-python@v6.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install Python dependencies
@@ -104,14 +107,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v6.0.1
+        uses: actions/checkout@v6.0.2
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.1.0
+        uses: actions/setup-python@v6.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install Python dependencies
@@ -124,14 +127,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v6.0.1
+        uses: actions/checkout@v6.0.2
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.1.0
+        uses: actions/setup-python@v6.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install Python dependencies
@@ -144,20 +147,20 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v6.0.1
+        uses: actions/checkout@v6.0.2
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.1.0
+        uses: actions/setup-python@v6.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install Python dependencies
         run: uv sync --dev
       - name: 🏗 Set up Node.js
-        uses: actions/setup-node@v6.1.0
+        uses: actions/setup-node@v6.2.0
         with:
           node-version-file: ".nvmrc"
           cache: "npm"

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/.github/workflows/lock.yaml

@@ -7,6 +7,10 @@ on:
     - cron: "0 9 * * *"
   workflow_dispatch:
 
+permissions:
+  issues: write
+  pull-requests: write
+
 jobs:
   lock:
     name: 🔒 Lock closed issues and PRs

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/.github/workflows/pr-labels.yaml

@@ -11,6 +11,9 @@ on:
       - synchronize
   workflow_call:
 
+permissions:
+  pull-requests: read
+
 jobs:
   pr_labels:
     name: Verify

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/.github/workflows/release-drafter.yaml

@@ -23,13 +23,18 @@ on:
           - alpha
           - rc
 
+permissions:
+  contents: write
+  issues: read
+  pull-requests: read
+
 jobs:
   update_release_draft:
     name: ✏️ Draft release
     runs-on: ubuntu-latest
     steps:
       - name: 🚀 Run Release Drafter
-        uses: release-drafter/release-drafter@v6.1.0
+        uses: release-drafter/release-drafter@v6.2.0
         with:
           prerelease: ${{ github.event.inputs.prerelease == 'true' }}
           prerelease-identifier: ${{ github.event.inputs.prerelease_identifier }}

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/.github/workflows/release.yaml

@@ -22,14 +22,14 @@ jobs:
       id-token: write
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v6.0.1
+        uses: actions/checkout@v6.0.2
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.1.0
+        uses: actions/setup-python@v6.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install dependencies

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/.github/workflows/stale.yaml

@@ -7,6 +7,10 @@ on:
     - cron: "0 8 * * *"
   workflow_dispatch:
 
+permissions:
+  issues: write
+  pull-requests: write
+
 jobs:
   stale:
     name: 🧹 Clean up stale issues and PRs

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/.github/workflows/tests.yaml

@@ -9,6 +9,11 @@ on:
     branches: [main]
   workflow_dispatch:
 
+permissions:
+  actions: write
+  contents: read
+  pull-requests: read
+
 env:
   DEFAULT_PYTHON: "3.13"
 
@@ -21,14 +26,14 @@ jobs:
         python: ["3.12", "3.13", "3.14"]
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v6.0.1
+        uses: actions/checkout@v6.0.2
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ matrix.python }}
         id: python
-        uses: actions/setup-python@v6.1.0
+        uses: actions/setup-python@v6.2.0
         with:
           python-version: ${{ matrix.python }}
       - name: 🏗 Install dependencies
@@ -47,7 +52,7 @@ jobs:
     needs: pytest
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v6.0.1
+        uses: actions/checkout@v6.0.2
         with:
           fetch-depth: 0
       - name: ⬇️ Download coverage data
@@ -58,7 +63,7 @@ jobs:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.1.0
+        uses: actions/setup-python@v6.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install dependencies

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/.github/workflows/typing.yaml

@@ -20,14 +20,14 @@ jobs:
       contents: read
     steps:
       - name: ⤵️ Check out code from GitHub
-        uses: actions/checkout@v6.0.1
+        uses: actions/checkout@v6.0.2
       - name: 🏗 Set up uv
         uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@v6.1.0
+        uses: actions/setup-python@v6.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
       - name: 🏗 Install dependencies

python_bsblan-4.2.0/.nvmrc

@@ -0,0 +1 @@
+24.13.1

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-bsblan
-Version: 4.1.0b2
+Version: 4.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-4.1.0b2 → python_bsblan-4.2.0}/examples/control.py

@@ -177,8 +177,8 @@ async def print_device_info(device: Device, info: Info) -> None:
     )
 
     attributes = {
-        "Device Name": device.name if device.name else "N/A",
-        "Version": device.version if device.version else "N/A",
+        "Device Name": device.name or "N/A",
+        "Version": device.version or "N/A",
         "Device Identification": device_identification,
     }
     print_attributes("Device Information", attributes)

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/package-lock.json

@@ -12,13 +12,13 @@
         "url-parse": "1.5.10"
       },
       "devDependencies": {
-        "prettier": "3.7.4"
+        "prettier": "3.8.1"
       }
     },
     "node_modules/prettier": {
-      "version": "3.7.4",
-      "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.7.4.tgz",
-      "integrity": "sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA==",
+      "version": "3.8.1",
+      "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.8.1.tgz",
+      "integrity": "sha512-UOnG6LftzbdaHZcKoPFtOcCKztrQ57WkHDeRD9t/PTQtmT0NHSeWWepj6pS0z/N7+08BHFDQVUrfmfMRcZwbMg==",
       "dev": true,
       "license": "MIT",
       "bin": {

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/package.json

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

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-bsblan"
-version = "4.1.0-beta.2"
+version = "4.2.0"
 description = "Asynchronous Python client for BSBLAN API"
 authors = [
     {name = "Willem-Jan van Rootselaar", email = "liudgervr@gmail.com"}
@@ -177,19 +177,19 @@ build-backend = "hatchling.build"
 [dependency-groups]
 dev = [
     "aresponses==3.0.0",
-    "bandit==1.9.2",
-    "black==25.12.0",
+    "bandit==1.9.3",
+    "black==26.1.0",
     "blacken-docs==1.20.0",
     "codespell==2.4.1",
     "covdefaults==2.3.0",
-    "coverage==7.13.1",
+    "coverage==7.13.4",
     "darglint==1.8.1",
     "flake8==7.3.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==7.0.0",
-    "ty==0.0.11",
+    "ty==0.0.16",
     "pre-commit==4.5.1",
     "pre-commit-hooks==6.0.0",
     "pylint==4.0.4",
@@ -198,9 +198,9 @@ dev = [
     "pytest-cov==7.0.0",
     "pytest-xdist>=3.8.0",
     "pyupgrade==3.21.2",
-    "ruff==0.14.11",
+    "ruff==0.15.0",
     "safety==3.7.0",
     "vulture==2.14",
-    "yamllint==1.37.1",
+    "yamllint==1.38.0",
     "zeroconf>=0.148.0",
 ]

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/src/bsblan/__init__.py

@@ -2,6 +2,8 @@
 
 from .bsblan import BSBLAN, BSBLANConfig
 from .constants import (
+    UNIT_DEVICE_CLASS_MAP,
+    UNIT_STATE_CLASS_MAP,
     HeatingCircuitStatus,
     HVACActionCategory,
     get_hvac_action_category,
@@ -27,6 +29,8 @@ from .models import (
 
 __all__ = [
     "BSBLAN",
+    "UNIT_DEVICE_CLASS_MAP",
+    "UNIT_STATE_CLASS_MAP",
     "BSBLANAuthError",
     "BSBLANConfig",
     "BSBLANConnectionError",

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/src/bsblan/constants.py

@@ -415,6 +415,77 @@ EMPTY_INCLUDE_LIST_ERROR_MSG: Final[str] = (
 # Handle both ASCII and Unicode degree symbols
 TEMPERATURE_UNITS = {"°C", "°F", "°C", "°F", "°C", "°F"}
 
+# HA-compatible device class mapping from BSB-LAN units
+# Maps unit strings (incl. HTML-encoded variants)
+# to HA SensorDeviceClass values
+UNIT_DEVICE_CLASS_MAP: Final[dict[str, str]] = {
+    # Temperature
+    "°C": "temperature",
+    "°F": "temperature",
+    "°C": "temperature",
+    "°F": "temperature",
+    "°C": "temperature",
+    "°F": "temperature",
+    # Energy
+    "kWh": "energy",
+    "MWh": "energy",
+    "Wh": "energy",
+    # Power
+    "kW": "power",
+    "W": "power",
+    # Pressure
+    "bar": "pressure",
+    "Pa": "pressure",
+    "hPa": "pressure",
+    # Voltage
+    "V": "voltage",
+    # Current
+    "A": "current",
+    "mA": "current",
+    # Frequency
+    "Hz": "frequency",
+    # Volume flow rate
+    "l/min": "volume_flow_rate",
+    "l/h": "volume_flow_rate",
+    # Duration
+    "h": "duration",
+    "min": "duration",
+    "s": "duration",
+    # Percentage
+    "%": "power_factor",
+}
+
+# HA-compatible state class mapping from BSB-LAN units
+# Maps unit strings to HA SensorStateClass values
+UNIT_STATE_CLASS_MAP: Final[dict[str, str]] = {
+    # Energy counters are always total_increasing
+    "kWh": "total_increasing",
+    "MWh": "total_increasing",
+    "Wh": "total_increasing",
+    # All other numeric measurements
+    "°C": "measurement",
+    "°F": "measurement",
+    "°C": "measurement",
+    "°F": "measurement",
+    "°C": "measurement",
+    "°F": "measurement",
+    "kW": "measurement",
+    "W": "measurement",
+    "bar": "measurement",
+    "Pa": "measurement",
+    "hPa": "measurement",
+    "V": "measurement",
+    "A": "measurement",
+    "mA": "measurement",
+    "Hz": "measurement",
+    "l/min": "measurement",
+    "l/h": "measurement",
+    "%": "measurement",
+    "h": "measurement",
+    "min": "measurement",
+    "s": "measurement",
+}
+
 # Hot Water Parameter Groups
 # Essential parameters for frequent monitoring
 HOT_WATER_ESSENTIAL_PARAMS: Final[set[str]] = {

{python_bsblan-4.1.0b2 → python_bsblan-4.2.0}/src/bsblan/models.py

@@ -11,7 +11,11 @@ from typing import Any, Final
 
 from mashumaro.mixins.json import DataClassJSONMixin
 
-from bsblan.constants import TEMPERATURE_UNITS
+from bsblan.constants import (
+    TEMPERATURE_UNITS,
+    UNIT_DEVICE_CLASS_MAP,
+    UNIT_STATE_CLASS_MAP,
+)
 
 # Maximum number of time slots per day supported by BSB-LAN
 MAX_TIME_SLOTS_PER_DAY: Final[int] = 3
@@ -225,6 +229,8 @@ class EntityInfo(DataClassJSONMixin):
         readonly: Whether the value is read-only.
         readwrite: Whether the value is read-write.
         precision: Optional precision for numeric values.
+        data_type_name: BSB-LAN data type name (e.g., "TEMP", "ENUM").
+        data_type_family: BSB-LAN data type family (e.g., "VALS", "ENUM").
 
     """
 
@@ -237,6 +243,8 @@ class EntityInfo(DataClassJSONMixin):
     readonly: int = field(default=0)
     readwrite: int = field(default=0)
     precision: float | None = field(default=None)
+    data_type_name: str = field(default="", metadata={"alias": "dataType_name"})
+    data_type_family: str = field(default="", metadata={"alias": "dataType_family"})
 
     def __post_init__(self) -> None:
         """Convert values based on data_type after initialization."""
@@ -312,6 +320,45 @@ class EntityInfo(DataClassJSONMixin):
         """
         return self.desc if self.data_type == DataType.ENUM else None
 
+    @property
+    def suggested_device_class(self) -> str | None:
+        """Suggest HA SensorDeviceClass based on unit and data type.
+
+        Only PLAIN_NUMBER data types are considered sensor-like values.
+        Returns None for ENUM, TIME, WEEKDAY, STRING, and other
+        non-numeric types even if they carry a unit.
+
+        Returns:
+            str | None: The suggested HA device class (e.g., "temperature",
+                "energy", "power"), or None if no mapping exists or the
+                data type is not numeric.
+
+        """
+        if self.data_type != DataType.PLAIN_NUMBER:
+            return None
+        return UNIT_DEVICE_CLASS_MAP.get(self.unit)
+
+    @property
+    def suggested_state_class(self) -> str | None:
+        """Suggest HA SensorStateClass based on unit and data type.
+
+        Only PLAIN_NUMBER data types are considered sensor-like values.
+        Returns None for ENUM, TIME, WEEKDAY, STRING, and other
+        non-numeric types even if they carry a unit.
+
+        Energy counters (kWh, MWh, Wh) are mapped to "total_increasing",
+        while other numeric measurements use "measurement".
+
+        Returns:
+            str | None: The suggested HA state class (e.g., "measurement",
+                "total_increasing"), or None if the data type is not
+                numeric or no mapping exists.
+
+        """
+        if self.data_type != DataType.PLAIN_NUMBER:
+            return None
+        return UNIT_STATE_CLASS_MAP.get(self.unit)
+
 
 @dataclass
 class SetHotWaterParam: