python-izone 1.2.9__tar.gz → 1.3.0__tar.gz

python_izone-1.3.0/.github/workflows/main.yml

@@ -0,0 +1,55 @@
+name: CI
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.14"]
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install uv
+        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: uv sync --frozen --all-extras --group dev
+      - name: Lint with Pylint
+        run: uv run pylint pizone
+      - name: Type check with mypy
+        run: uv run mypy pizone
+      - name: Test with pytest
+        run: uv run pytest tests/ -q
+      - name: Build package
+        run: uv build
+      - name: Publish package
+        if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags') && matrix.python-version == '3.14'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+
+  coverage:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+        with:
+          python-version: "3.14"
+      - name: Install dependencies
+        run: uv sync --frozen --all-extras --group dev
+      - name: Test coverage (advisory)
+        run: uv run pytest tests/ -q --cov=pizone --cov-report=term-missing:skip-covered --cov-report=html
+      - name: Upload HTML coverage report
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: coverage-html
+          path: htmlcov/

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

@@ -0,0 +1,6 @@
+repos:
+  - repo: https://github.com/psf/black
+    rev: 25.1.0
+    hooks:
+      - id: black
+        args: [--check, --diff]

{python-izone-1.2.9 → python_izone-1.3.0}/.pylintrc

@@ -21,7 +21,7 @@ analyse-fallback-blocks=no
 # A comma-separated list of package or module names from where C extensions may
 # be loaded. Extensions are loading into the active Python interpreter and may
 # run arbitrary code.
-extension-pkg-allow-list=netifaces
+extension-pkg-allow-list=
 
 # A comma-separated list of package or module names from where C extensions may
 # be loaded. Extensions are loading into the active Python interpreter and may
@@ -82,15 +82,11 @@ persistent=yes
 
 # Minimum Python version to use for version dependent checks. Will default to
 # the version used to run pylint.
-py-version=3.9
+py-version=3.14
 
 # Discover python modules and packages in the file system subtree.
 recursive=no
 
-# When enabled, pylint would attempt to guess common misconfiguration and emit
-# user-friendly hints instead of false-positive error messages.
-suggestion-mode=yes
-
 # Allow loading of arbitrary C extensions. Extensions are imported into the
 # active Python interpreter and may run arbitrary code.
 unsafe-load-any-extension=no
@@ -369,8 +365,8 @@ min-public-methods=2
 [EXCEPTIONS]
 
 # Exceptions that will emit a warning when caught.
-overgeneral-exceptions=BaseException,
-                       Exception
+overgeneral-exceptions=builtins.BaseException,
+                       builtins.Exception
 
 
 [FORMAT]

python_izone-1.3.0/.python-version

@@ -0,0 +1 @@
+3.14

{python-izone-1.2.9 → python_izone-1.3.0}/.vscode/settings.json

@@ -8,7 +8,19 @@
     "python.linting.pylintEnabled": true,
     "python.linting.flake8Enabled": false,
     "python.linting.mypyEnabled": true,
-    "python.pythonPath": "venv\\Scripts\\python.exe",
+    "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
     "python.globalModuleInstallation": false,
-    "python.formatting.provider": "black"
+    "python.formatting.provider": "black",
+    "cSpell.words": [
+        "inetaddrs",
+        "inetaddr",
+        "ifaddresses",
+        "rescan",
+        "pizone",
+        "ipower",
+        "COOLDOWN",
+        "coro",
+        "datagram",
+        "fanout"
+    ]
 }

python_izone-1.3.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: python-izone
+Version: 1.3.0
+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>
+License-Expression: GPL-3.0-or-later
+License-File: licence.txt
+Keywords: IoT,iZone
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Home Automation
+Classifier: Topic :: System :: Hardware
+Requires-Python: >=3.14
+Requires-Dist: aiohttp>=3.14.1
+Requires-Dist: ifaddr>=0.2.0
+Provides-Extra: test
+Requires-Dist: pytest-aio; extra == 'test'
+Requires-Dist: pytest-aiohttp; extra == 'test'
+Requires-Dist: pytest-cov; extra == 'test'
+Requires-Dist: pytest>=6.2.2; extra == 'test'
+Description-Content-Type: text/markdown
+
+# python-izone
+
+Python library for the [iZone](https://izone.com.au/) air conditioning system.
+
+Used by the [Home Assistant iZone integration](https://www.home-assistant.io/integrations/izone/).
+
+## Install
+
+```bash
+pip install python-izone
+```
+
+## Overview
+
+The main entry points are `Controller` and `Zone` for device control, and
+`DiscoveryService` for UDP discovery on the local network.
+
+Synchronous property reads return cached device data and do not raise
+`ConnectionError`. Async command and refresh methods perform HTTP I/O and
+raise `ConnectionError` when the device cannot be reached. They raise
+`ControllerCommandError` when the device responds but rejects the request
+(`{ERROR}` body or HTTP 4xx).
+
+## Dependencies
+
+Requires `aiohttp>=3.14.1`. Home Assistant pins `aiohttp==3.14.1`; that version
+includes the HTTP POST coalescing fix ([aiohttp#10991](https://github.com/aio-libs/aiohttp/pull/10991))
+needed for iZone controllers that read the request in a single operation.
+
+## Protocol documentation
+
+The iZone Ethernet interface is documented in
+[AC-DOC-1401-11_iZoneEthernetInterface.pdf](./AC-DOC-1401-11_iZoneEthernetInterface.pdf).
+
+## Development
+
+1. Install [uv](https://docs.astral.sh/uv/).
+2. `uv sync --all-extras --group dev`
+3. `./scripts/check` — lint, type-check, test, and build (same as CI)
+4. `./scripts/coverage` — test coverage report (advisory; not part of the CI gate)
+
+Individual commands:
+
+- `uv run pytest tests/`
+- `uv run pylint pizone`
+- `uv run mypy pizone`
+- `uv build`
+
+To run integration tests against a controller on your network:
+
+```bash
+uv run pytest tests/test_fullstack.py -m hardware -o addopts=
+```

python_izone-1.3.0/README.md

@@ -0,0 +1,53 @@
+# python-izone
+
+Python library for the [iZone](https://izone.com.au/) air conditioning system.
+
+Used by the [Home Assistant iZone integration](https://www.home-assistant.io/integrations/izone/).
+
+## Install
+
+```bash
+pip install python-izone
+```
+
+## Overview
+
+The main entry points are `Controller` and `Zone` for device control, and
+`DiscoveryService` for UDP discovery on the local network.
+
+Synchronous property reads return cached device data and do not raise
+`ConnectionError`. Async command and refresh methods perform HTTP I/O and
+raise `ConnectionError` when the device cannot be reached. They raise
+`ControllerCommandError` when the device responds but rejects the request
+(`{ERROR}` body or HTTP 4xx).
+
+## Dependencies
+
+Requires `aiohttp>=3.14.1`. Home Assistant pins `aiohttp==3.14.1`; that version
+includes the HTTP POST coalescing fix ([aiohttp#10991](https://github.com/aio-libs/aiohttp/pull/10991))
+needed for iZone controllers that read the request in a single operation.
+
+## Protocol documentation
+
+The iZone Ethernet interface is documented in
+[AC-DOC-1401-11_iZoneEthernetInterface.pdf](./AC-DOC-1401-11_iZoneEthernetInterface.pdf).
+
+## Development
+
+1. Install [uv](https://docs.astral.sh/uv/).
+2. `uv sync --all-extras --group dev`
+3. `./scripts/check` — lint, type-check, test, and build (same as CI)
+4. `./scripts/coverage` — test coverage report (advisory; not part of the CI gate)
+
+Individual commands:
+
+- `uv run pytest tests/`
+- `uv run pylint pizone`
+- `uv run mypy pizone`
+- `uv build`
+
+To run integration tests against a controller on your network:
+
+```bash
+uv run pytest tests/test_fullstack.py -m hardware -o addopts=
+```

python_izone-1.3.0/pizone/__init__.py

@@ -0,0 +1,31 @@
+"""Interface to the iZone air conditioner controller.
+
+Interaction is mostly through the :class:`~pizone.controller.Controller` and
+:class:`~pizone.zone.Zone` classes.
+
+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).
+"""
+
+from .controller import Controller
+from .discovery import DiscoveryService, Listener, discovery
+from .exceptions import ControllerCommandError
+from .power import BatteryLevel, Power, PowerChannel, PowerDevice, PowerGroup
+from .zone import Zone
+
+__all__ = [
+    "Controller",
+    "ControllerCommandError",
+    "Zone",
+    "DiscoveryService",
+    "Listener",
+    "discovery",
+    "Power",
+    "PowerGroup",
+    "PowerDevice",
+    "PowerChannel",
+    "BatteryLevel",
+]