python-izone 1.2.10__tar.gz → 1.3.1__tar.gz

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

@@ -0,0 +1,57 @@
+name: CI
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    strategy:
+      matrix:
+        python-version: ["3.14"]
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - name: Install uv
+        uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache-suffix: build
+      - 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
+
+  coverage:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install uv
+        uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+        with:
+          python-version: "3.14"
+          cache-suffix: coverage
+      - 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@v7
+        if: always()
+        with:
+          name: coverage-html
+          path: htmlcov/

{python_izone-1.2.10 → python_izone-1.3.1}/.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

python_izone-1.3.1/.python-version

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

python_izone-1.3.1/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: python-izone
+Version: 1.3.1
+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.1/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.1/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",
+]