Skip to main content

python-izone

Python library for the iZone air conditioning system.

Used by the Home Assistant iZone integration.

Install

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). Setters raise InvalidValueError before any I/O when a value is out of range, off its step, or not supported by the system or zone. It subclasses both ValueError and AttributeError.

Dependencies

Requires aiohttp>=3.14.1. Home Assistant pins aiohttp==3.14.1; that version includes the HTTP POST coalescing fix (aiohttp#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.

Troubleshooting / issue reports

If Home Assistant can load the iZone integration, prefer Download diagnostics from the integration page.

A bridge is only reported as found once it answers over HTTP. When one replies to discovery but fails that check, the library says why: discover_all() lists it in the result's unverified, and discover_by_host() / discover_by_uid() raise EndpointVerifyError with a VerifyFailure reason (no HTTP reply, unreadable reply, a different UID, or a host name that didn't resolve). Failures during background discovery are logged at debug level on the pizone.discovery logger.

When that is not possible (or you need a live HTTP/UDP survey of the bridge), run the stdlib probe from a machine on the same LAN:

curl -fsSL -o izone_v1_probe.py \
  https://raw.githubusercontent.com/Swamp-Ig/pizone/main/scripts/izone_v1_probe.py
python3 izone_v1_probe.py <bridge-ip> --with-content-type > izone-v1-probe.log

Attach izone-v1-probe.log to the GitHub issue. The CLI host (IP or hostname) and IPv4/IPv6 literals in the log are redacted to **REDACTED** by default (including UDP IP_… payloads); use --show-ips only for local debugging. Stop Home Assistant (or other listeners on UDP 7005) first if the UDP listen step fails to bind.

Development

  1. Install 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 ruff check pizone tests
  • uv run ruff format pizone tests
  • uv run mypy pizone
  • uv build

To run integration tests against a controller on your network:

uv run pytest -m hardware -o addopts=

They bind UDP port 7005, so stop Home Assistant or anything else using iZone discovery on the same machine first.

Metadata

Release files for python-izone 2.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-izone 2.0.0
File Size Uploaded Provenance Actions
python_izone-2.0.0.tar.gz 704.8 kB With provenance Details for python_izone-2.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for python-izone 2.0.0
File Interpreter ABI Platform Actions
python_izone-2.0.0-py3-none-any.whl Python 3 none any Details for python_izone-2.0.0-py3-none-any.whl

Total release size: 758.1 kB

Release files / python_izone-2.0.0.tar.gz

Download URL python_izone-2.0.0.tar.gz
Size 704.8 kB
Tags Source
SHA-256 checksum
How to use checksums
5ad08b82254ef0316ab002aa9162d73a8b4025ca80b9a1ceedfef294a0d54ef6
BLAKE2b-256 checksum
How to use checksums
b9ebc2e02fd499ea26b83df9d434841f36785a77166e26eb1e208d3a4186acbd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

Release files / python_izone-2.0.0-py3-none-any.whl

Download URL python_izone-2.0.0-py3-none-any.whl
Size 53.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c03d2e254a28739d76e49e499979afda85eaf62759eddf3220c160f6e0efed77
BLAKE2b-256 checksum
How to use checksums
c4837bed66ae97f9d6668b1f8335d4452c3ecf61129af67f47a4b9bf34e892e9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

Security for python-izone 2.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for python_izone-2.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.0.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page