python-bsblan 5.2.0__tar.gz → 6.0.0__tar.gz

{python_bsblan-5.2.0 → python_bsblan-6.0.0}/.github/workflows/codeql.yaml

@@ -27,6 +27,6 @@ jobs:
         with:
           persist-credentials: false
       - name: 🏗 Initialize CodeQL
-        uses: github/codeql-action/init@95e58e9a2cdfd71adc6e0353d5c52f41a045d225 # v4.35.2
+        uses: github/codeql-action/init@9e0d7b8d25671d64c341c19c0152d693099fb5ba # v4.35.5
       - name: 🚀 Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@95e58e9a2cdfd71adc6e0353d5c52f41a045d225 # v4.35.2
+        uses: github/codeql-action/analyze@9e0d7b8d25671d64c341c19c0152d693099fb5ba # v4.35.5

{python_bsblan-5.2.0 → python_bsblan-6.0.0}/.github/workflows/dependency-review.yaml

@@ -18,4 +18,4 @@ jobs:
           persist-credentials: false
       - name: 👀 Dependency review
         # yamllint disable-line rule:line-length
-        uses: actions/dependency-review-action@2031cfc080254a8a887f58cffee85186f0e49e48 # v4.9.0
+        uses: actions/dependency-review-action@a1d282b36b6f3519aa1f3fc636f609c47dddb294 # v5.0.0

{python_bsblan-5.2.0 → python_bsblan-6.0.0}/.github/workflows/docs.yaml

@@ -27,7 +27,7 @@ jobs:
         with:
           persist-credentials: false
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}

{python_bsblan-5.2.0 → python_bsblan-6.0.0}/.github/workflows/linting.yaml

@@ -25,7 +25,7 @@ jobs:
         with:
           persist-credentials: false
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -49,7 +49,7 @@ jobs:
         with:
           persist-credentials: false
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}

{python_bsblan-5.2.0 → python_bsblan-6.0.0}/.github/workflows/release-drafter.yaml

@@ -36,7 +36,7 @@ jobs:
     steps:
       - name: 🚀 Run Release Drafter
         # yamllint disable-line rule:line-length
-        uses: release-drafter/release-drafter@5de93583980a40bd78603b6dfdcda5b4df377b32 # v7.2.0
+        uses: release-drafter/release-drafter@c2e2804cc59f45f57076a99af580d0fedb697927 # v7.3.0
         with:
           prerelease: ${{ github.event.inputs.prerelease == 'true' }}
           prerelease-identifier: ${{ github.event.inputs.prerelease_identifier }}

{python_bsblan-5.2.0 → python_bsblan-6.0.0}/.github/workflows/release.yaml

@@ -29,7 +29,7 @@ jobs:
         with:
           persist-credentials: false
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           enable-cache: false
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}

{python_bsblan-5.2.0 → python_bsblan-6.0.0}/.github/workflows/scorecard.yml

@@ -66,6 +66,6 @@ jobs:
       # Upload the results to GitHub's code scanning dashboard (optional).
       - name: "Upload to code-scanning"
         # yamllint disable-line rule:line-length
-        uses: github/codeql-action/upload-sarif@95e58e9a2cdfd71adc6e0353d5c52f41a045d225 # v4.35.2
+        uses: github/codeql-action/upload-sarif@9e0d7b8d25671d64c341c19c0152d693099fb5ba # v4.35.5
         with:
           sarif_file: results.sarif

{python_bsblan-5.2.0 → python_bsblan-6.0.0}/.github/workflows/tests.yaml

@@ -33,7 +33,7 @@ jobs:
         with:
           persist-credentials: false
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ matrix.python }}
@@ -68,7 +68,7 @@ jobs:
       - name: ⬇️ Download coverage data
         uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
       - name: 🏗 Set up uv
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}
@@ -84,7 +84,7 @@ jobs:
           uv run python -m coverage xml -i
       - name: 🚀 Upload coverage report
         if: env.HAS_CODECOV_TOKEN == 'true'
-        uses: codecov/codecov-action@57e3a136b779b570ffcdbf80b3bdc90e7fab3de2 # v6.0.0
+        uses: codecov/codecov-action@e79a6962e0d4c0c17b229090214935d2e33f8354 # v6.0.1
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
       - name: ℹ️ Skip Codecov upload (missing token)
@@ -93,7 +93,7 @@ jobs:
       - name: SonarQube Cloud Scan
         if: env.HAS_SONAR_TOKEN == 'true' && (github.event_name != 'pull_request' || !github.event.pull_request.head.repo.fork)
         # yamllint disable-line rule:line-length
-        uses: SonarSource/sonarqube-scan-action@299e4b793aaa83bf2aba7c9c14bedbb485688ec4 # v7.1.0
+        uses: SonarSource/sonarqube-scan-action@59db25f34e16620e48ab4bb9e4a5dce155cb5432 # v8.0
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}

{python_bsblan-5.2.0 → python_bsblan-6.0.0}/.github/workflows/typing.yaml

@@ -27,7 +27,7 @@ jobs:
           persist-credentials: false
       - name: 🏗 Set up uv
         # yamllint disable-line rule:line-length
-        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
           enable-cache: true
       - name: 🏗 Set up Python ${{ env.DEFAULT_PYTHON }}

python_bsblan-6.0.0/.nvmrc

@@ -0,0 +1 @@
+24.15.0

{python_bsblan-5.2.0 → python_bsblan-6.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-bsblan
-Version: 5.2.0
+Version: 6.0.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-5.2.0 → python_bsblan-6.0.0}/docs/api/client.md

@@ -10,6 +10,8 @@ The main entry point for interacting with BSB-LAN devices.
       members:
         - __init__
         - initialize
+        - device_info
+        - supports_time_sync
         - get_available_circuits
         - state
         - sensor

{python_bsblan-5.2.0 → python_bsblan-6.0.0}/docs/getting-started.md

@@ -63,6 +63,42 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
+## PPS bus support
+
+PPS bus devices are detected from the device metadata returned by BSB-LAN. The
+client provides minimal climate support for PPS devices through the same climate
+methods used by BSB/LPB devices.
+
+Supported PPS climate operations:
+
+- `state()` for `hvac_mode`, `target_temperature`, and `current_temperature`
+- `static_values()` for `min_temp` and `max_temp`
+- `thermostat()` for target temperature and HVAC mode
+- `get_available_circuits()`, which returns `[1]` when the single PPS
+  climate circuit is available, otherwise `[]`; PPS devices only ever expose
+  circuit `1`
+
+PPS devices currently have these limitations:
+
+- Only circuit `1` is supported.
+- `time()` and `set_time()` are not supported for PPS devices.
+- `thermostat(hvac_mode=2)` is not supported on PPS devices. Valid PPS modes
+    are `0` (off), `1` (auto), and `3` (heat/manual).
+- Hot water and schedule helpers are intended for BSB/LPB devices.
+
+Check `supports_time_sync` before showing or calling time synchronization in
+applications:
+
+```python
+async with BSBLAN(config) as client:
+    device = client.device_info or await client.device()
+    print(f"Bus type: {device.bus or 'unknown'}")
+
+    if client.supports_time_sync:
+        device_time = await client.time()
+        print(device_time.time.value)
+```
+
 ## Hot water control
 
 ```python

{python_bsblan-5.2.0 → python_bsblan-6.0.0}/examples/control.py

@@ -68,6 +68,16 @@ def print_attributes(title: str, attributes: dict[str, str]) -> None:
         print(f"{label}: {value}")
 
 
+def format_yes_no(*, value: bool) -> str:
+    """Format a boolean as a readable yes/no value."""
+    return "yes" if value else "no"
+
+
+def format_optional(value: Any) -> str:
+    """Format optional device metadata for display."""
+    return "N/A" if value is None else str(value)
+
+
 def get_hvac_action_name(status_code: int) -> str:
     """Map BSB-LAN parameter 8000 status code to a human-readable HVAC action.
 
@@ -180,6 +190,11 @@ async def print_device_info(device: Device, info: Info) -> None:
         "Device Name": device.name or "N/A",
         "Version": device.version or "N/A",
         "Device Identification": device_identification,
+        "Bus Type": format_optional(device.bus),
+        "Bus Writable Flag": format_optional(device.buswritable),
+        "Bus Address": format_optional(device.busaddr),
+        "Bus Destination": format_optional(device.busdest),
+        "Supports Time Sync": format_yes_no(value=device.supports_time_sync),
     }
     print_attributes("Device Information", attributes)
 
@@ -319,6 +334,11 @@ async def main() -> None:
 
     # Initialize BSBLAN with the configuration object
     async with BSBLAN(config) as bsblan:
+        # Get and print device and general info, including bus metadata
+        device: Device = bsblan.device_info or await bsblan.device()
+        info: Info = await bsblan.info()
+        await print_device_info(device, info)
+
         # Get and print state
         state: State = await bsblan.state()
         await print_state(state)
@@ -335,14 +355,12 @@ async def main() -> None:
         sensor: Sensor = await bsblan.sensor()
         await print_sensor(sensor)
 
-        # Get and print device and general info
-        device: Device = await bsblan.device()
-        info: Info = await bsblan.info()
-        await print_device_info(device, info)
-
         # Get and print device time
-        device_time: DeviceTime = await bsblan.time()
-        await print_device_time(device_time)
+        if bsblan.supports_time_sync:
+            device_time: DeviceTime = await bsblan.time()
+            await print_device_time(device_time)
+        else:
+            print("\nDevice time is not available for this bus type")
 
         # Get and print static state
         static_state: StaticState = await bsblan.static_values()
@@ -375,13 +393,15 @@ async def main() -> None:
         await bsblan.set_hot_water(SetHotWaterParam(dhw_time_programs=dhw_programs))
 
         # Example: Set device time
-        print("\nSetting device time to current system time")
-        # Get current local system time and format it for BSB-LAN (DD.MM.YYYY HH:MM:SS)
-        # Note: Using local time intentionally for this demo to sync BSB-LAN
-        current_time = datetime.now().replace(microsecond=0)  # noqa: DTZ005 - Demo uses local time
-        formatted_time = current_time.strftime("%d.%m.%Y %H:%M:%S")
-        print(f"Current system time: {formatted_time}")
-        await bsblan.set_time(formatted_time)
+        if bsblan.supports_time_sync:
+            print("\nSetting device time to current system time")
+            # Get current local system time and format it for BSB-LAN.
+            current_time = datetime.now().replace(microsecond=0)  # noqa: DTZ005
+            formatted_time = current_time.strftime("%d.%m.%Y %H:%M:%S")
+            print(f"Current system time: {formatted_time}")
+            await bsblan.set_time(formatted_time)
+        else:
+            print("\nSkipping device time sync for this bus type")
 
 
 if __name__ == "__main__":

{python_bsblan-5.2.0 → python_bsblan-6.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-bsblan"
-version = "5.2.0"
+version = "6.0.0"
 description = "Asynchronous Python client for BSBLAN API"
 authors = [
     {name = "Willem-Jan van Rootselaar", email = "liudgervr@gmail.com"}
@@ -185,18 +185,18 @@ build-backend = "hatchling.build"
 dev = [
     "aresponses==3.0.0",
     "bandit==1.9.4",
-    "black==26.3.1",
+    "black==26.5.1",
     "blacken-docs==1.20.0",
     "codespell==2.4.2",
     "covdefaults==2.3.0",
-    "coverage==7.13.5",
+    "coverage==7.14.0",
     "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==8.0.1",
-    "ty==0.0.32",
+    "ty==0.0.38",
     "prek>=0.3.3",
     "pre-commit-hooks==6.0.0",
     "pylint==4.0.5",
@@ -205,7 +205,7 @@ dev = [
     "pytest-cov==7.1.0",
     "pytest-xdist>=3.8.0",
     "pyupgrade==3.21.2",
-    "ruff==0.15.11",
+    "ruff==0.15.13",
     "safety==3.7.0",
     "vulture==2.16",
     "yamllint==1.38.0",