python-izone 1.3.4__tar.gz → 1.3.6__tar.gz

{python_izone-1.3.4 → python_izone-1.3.6}/.github/workflows/main.yml

@@ -23,8 +23,10 @@ jobs:
           cache-suffix: build
       - name: Install dependencies
         run: uv sync --frozen --all-extras --group dev
-      - name: Lint with Pylint
-        run: uv run pylint pizone
+      - name: Lint with Ruff
+        run: |
+          uv run ruff check pizone tests
+          uv run ruff format --check pizone tests
       - name: Type check with mypy
         run: uv run mypy pizone
       - name: Test with pytest

python_izone-1.3.6/.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.21
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format

python_izone-1.3.6/.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+  "recommendations": [
+    "charliermarsh.ruff",
+    "ms-python.python",
+    "ms-python.mypy-type-checker"
+  ]
+}

python_izone-1.3.6/.vscode/settings.json

@@ -0,0 +1,34 @@
+{
+    "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
+    "python.testing.pytestEnabled": true,
+    "python.globalModuleInstallation": false,
+    "[python]": {
+        "editor.defaultFormatter": "charliermarsh.ruff",
+        "editor.formatOnSave": true,
+        "editor.codeActionsOnSave": {
+            "source.fixAll.ruff": "explicit",
+            "source.organizeImports.ruff": "explicit"
+        }
+    },
+    "ruff.enable": true,
+    "ruff.nativeServer": "on",
+    "ruff.configurationPreference": "filesystemFirst",
+    "ruff.interpreter": ["${workspaceFolder}/.venv/bin/python"],
+    "python.analysis.typeCheckingMode": "off",
+    "cursorpyright.analysis.typeCheckingMode": "off",
+    "pylint.enabled": false,
+    "mypy-type-checker.interpreter": ["${workspaceFolder}/.venv/bin/python"],
+    "mypy-type-checker.args": ["--config-file=${workspaceFolder}/pyproject.toml"],
+    "cSpell.words": [
+        "inetaddrs",
+        "inetaddr",
+        "ifaddresses",
+        "rescan",
+        "pizone",
+        "ipower",
+        "COOLDOWN",
+        "coro",
+        "datagram",
+        "fanout"
+    ]
+}

{python_izone-1.3.4 → python_izone-1.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-izone
-Version: 1.3.4
+Version: 1.3.6
 Summary: A python interface to the iZone airconditioner controller
 Project-URL: Homepage, https://github.com/Swamp-Ig/pizone
 Author-email: Penny Wood <pypl@ninjateaparty.com>
@@ -68,7 +68,8 @@ The iZone Ethernet interface is documented in
 Individual commands:
 
 - `uv run pytest tests/`
-- `uv run pylint pizone`
+- `uv run ruff check pizone tests`
+- `uv run ruff format pizone tests`
 - `uv run mypy pizone`
 - `uv build`
 

{python_izone-1.3.4 → python_izone-1.3.6}/README.md

@@ -42,7 +42,8 @@ The iZone Ethernet interface is documented in
 Individual commands:
 
 - `uv run pytest tests/`
-- `uv run pylint pizone`
+- `uv run ruff check pizone tests`
+- `uv run ruff format pizone tests`
 - `uv run mypy pizone`
 - `uv build`
 

python_izone-1.3.6/docs/release-notes/v1.3.5.md

@@ -0,0 +1,85 @@
+# Release notes — v1.3.5
+
+Released 2026-07-17.
+
+**Compare range:** https://github.com/Swamp-Ig/pizone/compare/v1.3.4...v1.3.5
+
+This is a **pre-release**. It includes work toward a better Home Assistant
+integration (stored bridge IP, improved discovery, and cleaner refresh
+timing), plus reliability fixes you can use today. Home Assistant still uses
+the same library entry points as 1.3.4. The older API remains available; a
+future major release will remove it in favour of the new discovery and refresh
+API below.
+
+## Summary
+
+Since v1.3.4:
+
+- HTTP connections are closed after each GET, which greatly reduces stalls on
+  some iZone bridges ([home-assistant/core#176536](https://github.com/home-assistant/core/issues/176536))
+- A new discovery and refresh API is available for integrators (the older API
+  still works for now)
+- iPower monitoring is off unless you opt in with `ENABLE_POWER = True`
+- Bridges that are not paired to an air conditioner (UID `000000000`) are
+  ignored or rejected instead of showing up as broken controllers
+
+## Bridge connection reliability
+
+Some ASH bridges misbehave when HTTP connections are reused. This release:
+
+- Sends `Connection: close` on every HTTP GET (polling and discovery probes)
+- Closes TCP connections after each request when the library creates its own
+  aiohttp session
+
+This reduces how often the bridge stops responding. It does not fix every
+hub-side stall; replacing faulty hardware may still be needed.
+
+## New discovery and refresh API (optional for now)
+
+Integrators can adopt a clearer model without background poll loops inside the
+library:
+
+- `create_discovery()` with callbacks when a controller is found or its IP
+  changes
+- `discover_by_host`, `discover_by_uid`, `discover_all` to find bridges on the
+  network
+- `create_controller(uid, host)` to connect to a known bridge
+- `refresh_all`, `refresh_system`, `refresh_zones`, and related methods so the
+  caller controls when to poll
+
+The previous API (`discovery()`, `fetch_controller`, `Listener`, and so on)
+still works and is what Home Assistant uses today.
+
+## iPower opt-in
+
+`ENABLE_POWER` now defaults to `False`. Power monitor HTTP traffic only runs
+after you set `pizone.ENABLE_POWER = True` before creating or refreshing a
+controller. This avoids extra requests on bridges that advertise iPower but are
+not set up for it. The default may change if more field data shows power
+monitoring is reliable enough to enable by default.
+
+## Unpaired bridges
+
+Wireless ASH bridges with no AC paired report device UID `000000000`. The
+library now:
+
+- Ignores them during passive UDP discovery
+- Raises `UnpairedBridgeError` if you try to connect to that UID on purpose
+- Refuses to cache them after an IP lookup
+
+Paired bridges that temporarily report fault-shaped settings (AC off, reboot,
+and so on) are unchanged: they keep their real UID and show as disconnected
+until the AC data recovers.
+
+## Other changes
+
+- UDP `CHANGED_*` notifications are recognized and ignored (no spurious refresh)
+- Discovery verifies bridge identity over HTTP before trusting UDP replies
+- Development tooling moved to Ruff for lint and format
+
+## Home Assistant
+
+If you maintain the iZone integration or test against this library, pin
+`python-izone==1.3.5` for the connection reuse fix on the current integration
+code path. The new discovery API is included for upcoming integration work but
+is not required for a version bump alone.

python_izone-1.3.6/docs/release-notes/v1.3.6.md

@@ -0,0 +1,98 @@
+# Release notes — v1.3.6
+
+Released 2026-07-19.
+
+**Compare range:** https://github.com/Swamp-Ig/pizone/compare/v1.3.5...v1.3.6
+
+This is a **pre-release** for integrators (especially Home Assistant Phase 2
+work). It is not aimed at end users as a standalone upgrade. Prefer waiting for
+a future stable line unless you are developing against the new discovery API.
+
+## Since v1.3.5
+
+- Discovery scan wait (`SCAN_TIMEOUT`) reduced from 20s to 5s
+- `close()` waits until the UDP transport has finished tearing down before
+  returning, so a following `create_discovery()` can rebind `:7005` immediately
+  (fixes delete → HomeKit rediscovery `EADDRINUSE` races)
+- Failed `create_discovery` / `start_discovery` no longer leaves a sticky
+  process singleton that blocked retries until process restart
+- `PLACEHOLDER_DEVICE_UID` is no longer exported from the public package API
+  (`UnpairedBridgeError` remains the supported signal)
+
+Everything from v1.3.5 below still applies.
+
+## Summary (since v1.3.4)
+
+- HTTP connections are closed after each GET, which greatly reduces stalls on
+  some iZone bridges ([home-assistant/core#176536](https://github.com/home-assistant/core/issues/176536))
+- A new discovery and refresh API is available for integrators (the older API
+  still works for now)
+- iPower monitoring is off unless you opt in with `ENABLE_POWER = True`
+- Bridges that are not paired to an air conditioner (UID `000000000`) are
+  ignored or rejected instead of showing up as broken controllers
+- Faster discovery scans and reliable UDP close → recreate (this release)
+
+## Bridge connection reliability
+
+Some ASH bridges misbehave when HTTP connections are reused. This release
+line:
+
+- Sends `Connection: close` on every HTTP GET (polling and discovery probes)
+- Closes TCP connections after each request when the library creates its own
+  aiohttp session
+
+This reduces how often the bridge stops responding. It does not fix every
+hub-side stall; replacing faulty hardware may still be needed.
+
+## New discovery and refresh API (optional for now)
+
+Integrators can adopt a clearer model without background poll loops inside the
+library:
+
+- `create_discovery()` with callbacks when a controller is found or its IP
+  changes
+- `discover_by_host`, `discover_by_uid`, `discover_all` to find bridges on the
+  network
+- `create_controller(uid, host)` to connect to a known bridge
+- `refresh_all`, `refresh_system`, `refresh_zones`, and related methods so the
+  caller controls when to poll
+
+`close()` on the discovery service now waits for UDP teardown so the next
+`create_discovery()` can bind the discovery port again without racing the OS
+socket release.
+
+The previous API (`discovery()`, `fetch_controller`, `Listener`, and so on)
+still works.
+
+## iPower opt-in
+
+`ENABLE_POWER` now defaults to `False`. Power monitor HTTP traffic only runs
+after you set `pizone.ENABLE_POWER = True` before creating or refreshing a
+controller. This avoids extra requests on bridges that advertise iPower but are
+not set up for it. The default may change if more field data shows power
+monitoring is reliable enough to enable by default.
+
+## Unpaired bridges
+
+Wireless ASH bridges with no AC paired report device UID `000000000`. The
+library now:
+
+- Ignores them during passive UDP discovery
+- Raises `UnpairedBridgeError` if you try to connect to that UID on purpose
+- Refuses to cache them after an IP lookup
+
+Paired bridges that temporarily report fault-shaped settings (AC off, reboot,
+and so on) are unchanged: they keep their real UID and show as disconnected
+until the AC data recovers.
+
+## Other changes
+
+- UDP `CHANGED_*` notifications are recognized and ignored (no spurious refresh)
+- Discovery verifies bridge identity over HTTP before trusting UDP replies
+- Development tooling moved to Ruff for lint and format
+
+## Home Assistant
+
+Pin `python-izone==1.3.6` when adopting the Phase 2 discovery / coordinator
+runtime. This pre-release is intended for that integration work, not as a
+general end-user library upgrade on the legacy path alone.

python_izone-1.3.6/pizone/__init__.py

@@ -0,0 +1,77 @@
+"""Interface to the iZone air conditioner controller.
+
+Prefer :func:`~pizone.discovery.create_discovery` or
+:func:`~pizone.discovery.discovery` to obtain a discovery service, then create
+or discover :class:`~pizone.controller.Controller` instances through that
+service. Zones and power monitors are owned by their controller.
+
+Synchronous property reads return cached device data and do not raise
+:exc:`ConnectionError`. Async command and refresh methods perform HTTP I/O and
+raise :exc:`ConnectionError` when the device cannot be reached. They raise
+:exc:`~pizone.exceptions.ControllerCommandError` when the device responds but
+rejects the request (``{ERROR...}`` body or HTTP 4xx).
+
+Layered connection state on :class:`~pizone.controller.Controller`:
+
+- :attr:`~pizone.controller.Controller.bridge_connected` — ASH bridge HTTP transport
+- :attr:`~pizone.controller.Controller.connected` — bridge plus valid iZone AC data
+- :attr:`~pizone.power.Power.connected` — power monitor I/O (when enabled)
+
+Power support is off by default. Enable at runtime before create/refresh when
+the consumer needs iPower (for example future Home Assistant power entities)::
+
+    import pizone
+    pizone.ENABLE_POWER = True
+"""
+
+import sys
+from types import ModuleType
+from typing import Any
+
+from . import power as power_mod
+from .controller import Controller
+from .discovery import DiscoveryService, Listener, create_discovery, discovery
+from .exceptions import ControllerCommandError, ResponseDecodeError, UnpairedBridgeError
+from .power import BatteryLevel, Power, PowerChannel, PowerDevice, PowerGroup
+from .types import ControllerEndpoint
+from .zone import Zone
+
+
+def __getattr__(name: str) -> Any:
+    if name == "ENABLE_POWER":
+        return power_mod.ENABLE_POWER
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+class _PizoneModule(ModuleType):
+    """Allow ``pizone.ENABLE_POWER = True`` to update :mod:`pizone.power`."""
+
+    @property
+    def ENABLE_POWER(self) -> bool:
+        return power_mod.ENABLE_POWER
+
+    @ENABLE_POWER.setter
+    def ENABLE_POWER(self, value: bool) -> None:
+        power_mod.ENABLE_POWER = bool(value)
+
+
+sys.modules[__name__].__class__ = _PizoneModule
+
+__all__ = [
+    "ENABLE_POWER",
+    "BatteryLevel",
+    "Controller",
+    "ControllerCommandError",
+    "ControllerEndpoint",
+    "DiscoveryService",
+    "Listener",
+    "Power",
+    "PowerChannel",
+    "PowerDevice",
+    "PowerGroup",
+    "ResponseDecodeError",
+    "UnpairedBridgeError",
+    "Zone",
+    "create_discovery",
+    "discovery",
+]

python_izone-1.3.6/pizone/const.py

@@ -0,0 +1,4 @@
+"""Shared constants for pizone."""
+
+# Exact AirStreamDeviceUId when an ASH bridge has no paired AC (desk evidence).
+PLACEHOLDER_DEVICE_UID = "000000000"