steamloop 1.0.0__tar.gz → 1.2.0__tar.gz

steamloop-1.2.0/PKG-INFO

@@ -0,0 +1,229 @@
+Metadata-Version: 2.4
+Name: steamloop
+Version: 1.2.0
+Summary: Local control for choochoo based thermostats
+Author-email: "J. Nick Koston" <nick@koston.org>
+License-Expression: Apache-2.0
+Project-URL: Bug Tracker, https://github.com/hvaclibs/steamloop/issues
+Project-URL: Changelog, https://github.com/hvaclibs/steamloop/blob/main/CHANGELOG.md
+Project-URL: documentation, https://steamloop.readthedocs.io
+Project-URL: repository, https://github.com/hvaclibs/steamloop
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: orjson>=3.10
+Dynamic: license-file
+
+# steamloop
+
+<p align="center">
+  <a href="https://github.com/hvaclibs/steamloop/actions/workflows/ci.yml?query=branch%3Amain">
+    <img src="https://img.shields.io/github/actions/workflow/status/hvaclibs/steamloop/ci.yml?branch=main&label=CI&logo=github&style=flat-square" alt="CI Status" >
+  </a>
+  <a href="https://steamloop.readthedocs.io">
+    <img src="https://img.shields.io/readthedocs/steamloop.svg?logo=read-the-docs&logoColor=fff&style=flat-square" alt="Documentation Status">
+  </a>
+  <a href="https://codecov.io/gh/hvaclibs/steamloop">
+    <img src="https://img.shields.io/codecov/c/github/hvaclibs/steamloop.svg?logo=codecov&logoColor=fff&style=flat-square" alt="Test coverage percentage">
+  </a>
+</p>
+<p align="center">
+  <a href="https://github.com/astral-sh/uv">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json" alt="uv">
+  </a>
+  <a href="https://github.com/astral-sh/ruff">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
+  </a>
+  <a href="https://github.com/pre-commit/pre-commit">
+    <img src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=flat-square" alt="pre-commit">
+  </a>
+</p>
+<p align="center">
+  <a href="https://pypi.org/project/steamloop/">
+    <img src="https://img.shields.io/pypi/v/steamloop.svg?logo=python&logoColor=fff&style=flat-square" alt="PyPI Version">
+  </a>
+  <img src="https://img.shields.io/pypi/pyversions/steamloop.svg?style=flat-square&logo=python&amp;logoColor=fff" alt="Supported Python versions">
+  <img src="https://img.shields.io/pypi/l/steamloop.svg?style=flat-square" alt="License">
+</p>
+
+---
+
+Async Python library for local control of thermostat devices over mTLS (port 7878).
+
+## Installation
+
+```bash
+pip install steamloop
+```
+
+## CLI
+
+### Pairing
+
+Put the thermostat in pairing mode (Menu > Settings > Network > Advanced Setup > Remote Connection > Pair), then:
+
+```bash
+steamloop 192.168.1.100 --pair
+```
+
+This saves a pairing file in the current directory with the secret key.
+
+### Monitoring
+
+```bash
+steamloop 192.168.1.100
+```
+
+If already paired, you can pass the secret key directly to skip the pairing file:
+
+```bash
+steamloop 192.168.1.100 --key YOUR_SECRET_KEY
+```
+
+Interactive commands: `status`, `heat <temp>`, `cool <temp>`, `mode <off|auto|cool|heat>`, `fan <auto|on|circulate>`, `eheat <on|off>`, `help`.
+
+## Library Usage
+
+```python
+import asyncio
+from steamloop import ThermostatConnection, ZoneMode, FanMode
+
+async def main():
+    conn = ThermostatConnection(
+        "192.168.1.100",
+        secret_key="your-secret-key-from-pairing",
+    )
+    async with conn:
+        # State is populated automatically from thermostat events
+        for zone_id, zone in conn.state.zones.items():
+            print(f"{zone.name}: {zone.indoor_temperature}°F")
+
+        # Send commands (sync — no await needed)
+        conn.set_temperature_setpoint("1", heat_setpoint="72")
+        conn.set_zone_mode("1", ZoneMode.COOL)
+        conn.set_fan_mode(FanMode.AUTO)
+
+asyncio.run(main())
+```
+
+### Pairing Programmatically
+
+`pair()` returns the secret key directly — store it however you like:
+
+```python
+from steamloop import ThermostatConnection
+
+async def pair(ip: str) -> str:
+    conn = ThermostatConnection(ip, secret_key="")
+    try:
+        await conn.connect()
+        ssk = await conn.pair()
+        return ssk["secret_key"]  # store in a database, config entry, etc.
+    finally:
+        await conn.disconnect()
+```
+
+Or use the built-in file helpers to save/load pairing data to disk:
+
+```python
+from steamloop import ThermostatConnection, save_pairing, load_pairing
+
+# Save after pairing
+await save_pairing(ip, {
+    "secret_key": secret_key,
+    "device_type": "automation",
+    "device_id": "module",
+})
+
+# Load later
+pairing = await load_pairing(ip)
+conn = ThermostatConnection(ip, secret_key=pairing["secret_key"])
+```
+
+### Event Callbacks
+
+```python
+def on_event(msg):
+    print("Received:", msg)
+
+remove = conn.add_event_callback(on_event)
+# later: remove() to unregister
+```
+
+## Home Assistant Integration
+
+Key design points for using steamloop in a Home Assistant integration:
+
+- **Commands are sync** — `set_zone_mode()`, `set_fan_mode()`, `set_temperature_setpoint()` use `transport.write()` internally, so they won't block the event loop. No `await` needed.
+- **State is always fresh** — the `asyncio.Protocol` receives events via `data_received()` and updates `conn.state` automatically. Just read properties directly.
+- **Auto-reconnect** — after calling `start_background_tasks()`, the connection automatically reconnects with exponential backoff (5s, 10s, 20s, ... up to 5 min).
+- **Event callbacks** — use `add_event_callback()` to trigger `async_write_ha_state()` when the thermostat pushes updates.
+- **Multi-zone** — create one `ClimateEntity` per `conn.state.zones` entry. Zones are populated automatically after login.
+
+## API Reference
+
+### `ThermostatConnection(ip, port=7878, *, secret_key, cert_set=None, device_type="automation", device_id="module")`
+
+| Method                                                                          | Async | Description                                           |
+| ------------------------------------------------------------------------------- | ----- | ----------------------------------------------------- |
+| `connect()`                                                                     | yes   | Establish mTLS connection                             |
+| `login()`                                                                       | yes   | Authenticate with secret key                          |
+| `pair()`                                                                        | yes   | Pair and receive secret key                           |
+| `start_background_tasks()`                                                      | no    | Start heartbeat + auto-reconnect                      |
+| `disconnect()`                                                                  | yes   | Close connection and stop tasks                       |
+| `set_temperature_setpoint(zone_id, *, heat_setpoint, cool_setpoint, hold_type)` | no    | Set zone temperature                                  |
+| `set_zone_mode(zone_id, mode)`                                                  | no    | Set zone HVAC mode                                    |
+| `set_fan_mode(mode)`                                                            | no    | Set fan mode                                          |
+| `set_emergency_heat(enabled)`                                                   | no    | Toggle emergency heat                                 |
+| `add_event_callback(fn)`                                                        | no    | Register event listener (returns unregister callable) |
+
+Supports `async with` for automatic connect/login/disconnect:
+
+```python
+async with ThermostatConnection(ip, secret_key=key) as conn:
+    ...  # connected, logged in, background tasks running
+# automatically disconnected
+```
+
+### Enums
+
+- `ZoneMode` — `OFF`, `AUTO`, `COOL`, `HEAT`
+- `FanMode` — `AUTO`, `ALWAYS_ON`, `CIRCULATE`
+- `HoldType` — `UNDEFINED`, `MANUAL`, `SCHEDULE`, `HOLD`
+
+### State
+
+- `conn.state.zones` — `dict[str, Zone]` with temperature, setpoints, mode per zone
+- `conn.state.fan_mode` — current `FanMode`
+- `conn.state.supported_modes` — `list[ZoneMode]`
+- `conn.state.emergency_heat` / `relative_humidity` / `cooling_active` / `heating_active`
+
+## Contributors
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- prettier-ignore-start -->
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- markdownlint-disable -->
+<!-- markdownlint-enable -->
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+<!-- prettier-ignore-end -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
+
+## Credits
+
+[![Copier](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/copier-org/copier/master/img/badge/badge-grayscale-inverted-border-orange.json)](https://github.com/copier-org/copier)
+
+This package was created with
+[Copier](https://copier.readthedocs.io/) and the
+[browniebroke/pypackage-template](https://github.com/browniebroke/pypackage-template)
+project template.

steamloop-1.2.0/README.md

@@ -0,0 +1,205 @@
+# steamloop
+
+<p align="center">
+  <a href="https://github.com/hvaclibs/steamloop/actions/workflows/ci.yml?query=branch%3Amain">
+    <img src="https://img.shields.io/github/actions/workflow/status/hvaclibs/steamloop/ci.yml?branch=main&label=CI&logo=github&style=flat-square" alt="CI Status" >
+  </a>
+  <a href="https://steamloop.readthedocs.io">
+    <img src="https://img.shields.io/readthedocs/steamloop.svg?logo=read-the-docs&logoColor=fff&style=flat-square" alt="Documentation Status">
+  </a>
+  <a href="https://codecov.io/gh/hvaclibs/steamloop">
+    <img src="https://img.shields.io/codecov/c/github/hvaclibs/steamloop.svg?logo=codecov&logoColor=fff&style=flat-square" alt="Test coverage percentage">
+  </a>
+</p>
+<p align="center">
+  <a href="https://github.com/astral-sh/uv">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json" alt="uv">
+  </a>
+  <a href="https://github.com/astral-sh/ruff">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
+  </a>
+  <a href="https://github.com/pre-commit/pre-commit">
+    <img src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=flat-square" alt="pre-commit">
+  </a>
+</p>
+<p align="center">
+  <a href="https://pypi.org/project/steamloop/">
+    <img src="https://img.shields.io/pypi/v/steamloop.svg?logo=python&logoColor=fff&style=flat-square" alt="PyPI Version">
+  </a>
+  <img src="https://img.shields.io/pypi/pyversions/steamloop.svg?style=flat-square&logo=python&amp;logoColor=fff" alt="Supported Python versions">
+  <img src="https://img.shields.io/pypi/l/steamloop.svg?style=flat-square" alt="License">
+</p>
+
+---
+
+Async Python library for local control of thermostat devices over mTLS (port 7878).
+
+## Installation
+
+```bash
+pip install steamloop
+```
+
+## CLI
+
+### Pairing
+
+Put the thermostat in pairing mode (Menu > Settings > Network > Advanced Setup > Remote Connection > Pair), then:
+
+```bash
+steamloop 192.168.1.100 --pair
+```
+
+This saves a pairing file in the current directory with the secret key.
+
+### Monitoring
+
+```bash
+steamloop 192.168.1.100
+```
+
+If already paired, you can pass the secret key directly to skip the pairing file:
+
+```bash
+steamloop 192.168.1.100 --key YOUR_SECRET_KEY
+```
+
+Interactive commands: `status`, `heat <temp>`, `cool <temp>`, `mode <off|auto|cool|heat>`, `fan <auto|on|circulate>`, `eheat <on|off>`, `help`.
+
+## Library Usage
+
+```python
+import asyncio
+from steamloop import ThermostatConnection, ZoneMode, FanMode
+
+async def main():
+    conn = ThermostatConnection(
+        "192.168.1.100",
+        secret_key="your-secret-key-from-pairing",
+    )
+    async with conn:
+        # State is populated automatically from thermostat events
+        for zone_id, zone in conn.state.zones.items():
+            print(f"{zone.name}: {zone.indoor_temperature}°F")
+
+        # Send commands (sync — no await needed)
+        conn.set_temperature_setpoint("1", heat_setpoint="72")
+        conn.set_zone_mode("1", ZoneMode.COOL)
+        conn.set_fan_mode(FanMode.AUTO)
+
+asyncio.run(main())
+```
+
+### Pairing Programmatically
+
+`pair()` returns the secret key directly — store it however you like:
+
+```python
+from steamloop import ThermostatConnection
+
+async def pair(ip: str) -> str:
+    conn = ThermostatConnection(ip, secret_key="")
+    try:
+        await conn.connect()
+        ssk = await conn.pair()
+        return ssk["secret_key"]  # store in a database, config entry, etc.
+    finally:
+        await conn.disconnect()
+```
+
+Or use the built-in file helpers to save/load pairing data to disk:
+
+```python
+from steamloop import ThermostatConnection, save_pairing, load_pairing
+
+# Save after pairing
+await save_pairing(ip, {
+    "secret_key": secret_key,
+    "device_type": "automation",
+    "device_id": "module",
+})
+
+# Load later
+pairing = await load_pairing(ip)
+conn = ThermostatConnection(ip, secret_key=pairing["secret_key"])
+```
+
+### Event Callbacks
+
+```python
+def on_event(msg):
+    print("Received:", msg)
+
+remove = conn.add_event_callback(on_event)
+# later: remove() to unregister
+```
+
+## Home Assistant Integration
+
+Key design points for using steamloop in a Home Assistant integration:
+
+- **Commands are sync** — `set_zone_mode()`, `set_fan_mode()`, `set_temperature_setpoint()` use `transport.write()` internally, so they won't block the event loop. No `await` needed.
+- **State is always fresh** — the `asyncio.Protocol` receives events via `data_received()` and updates `conn.state` automatically. Just read properties directly.
+- **Auto-reconnect** — after calling `start_background_tasks()`, the connection automatically reconnects with exponential backoff (5s, 10s, 20s, ... up to 5 min).
+- **Event callbacks** — use `add_event_callback()` to trigger `async_write_ha_state()` when the thermostat pushes updates.
+- **Multi-zone** — create one `ClimateEntity` per `conn.state.zones` entry. Zones are populated automatically after login.
+
+## API Reference
+
+### `ThermostatConnection(ip, port=7878, *, secret_key, cert_set=None, device_type="automation", device_id="module")`
+
+| Method                                                                          | Async | Description                                           |
+| ------------------------------------------------------------------------------- | ----- | ----------------------------------------------------- |
+| `connect()`                                                                     | yes   | Establish mTLS connection                             |
+| `login()`                                                                       | yes   | Authenticate with secret key                          |
+| `pair()`                                                                        | yes   | Pair and receive secret key                           |
+| `start_background_tasks()`                                                      | no    | Start heartbeat + auto-reconnect                      |
+| `disconnect()`                                                                  | yes   | Close connection and stop tasks                       |
+| `set_temperature_setpoint(zone_id, *, heat_setpoint, cool_setpoint, hold_type)` | no    | Set zone temperature                                  |
+| `set_zone_mode(zone_id, mode)`                                                  | no    | Set zone HVAC mode                                    |
+| `set_fan_mode(mode)`                                                            | no    | Set fan mode                                          |
+| `set_emergency_heat(enabled)`                                                   | no    | Toggle emergency heat                                 |
+| `add_event_callback(fn)`                                                        | no    | Register event listener (returns unregister callable) |
+
+Supports `async with` for automatic connect/login/disconnect:
+
+```python
+async with ThermostatConnection(ip, secret_key=key) as conn:
+    ...  # connected, logged in, background tasks running
+# automatically disconnected
+```
+
+### Enums
+
+- `ZoneMode` — `OFF`, `AUTO`, `COOL`, `HEAT`
+- `FanMode` — `AUTO`, `ALWAYS_ON`, `CIRCULATE`
+- `HoldType` — `UNDEFINED`, `MANUAL`, `SCHEDULE`, `HOLD`
+
+### State
+
+- `conn.state.zones` — `dict[str, Zone]` with temperature, setpoints, mode per zone
+- `conn.state.fan_mode` — current `FanMode`
+- `conn.state.supported_modes` — `list[ZoneMode]`
+- `conn.state.emergency_heat` / `relative_humidity` / `cooling_active` / `heating_active`
+
+## Contributors
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- prettier-ignore-start -->
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- markdownlint-disable -->
+<!-- markdownlint-enable -->
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+<!-- prettier-ignore-end -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
+
+## Credits
+
+[![Copier](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/copier-org/copier/master/img/badge/badge-grayscale-inverted-border-orange.json)](https://github.com/copier-org/copier)
+
+This package was created with
+[Copier](https://copier.readthedocs.io/) and the
+[browniebroke/pypackage-template](https://github.com/browniebroke/pypackage-template)
+project template.

{steamloop-1.0.0 → steamloop-1.2.0}/pyproject.toml

@@ -4,21 +4,19 @@ requires = [ "setuptools>=77.0.3" ]
 
 [project]
 name = "steamloop"
-version = "1.0.0"
+version = "1.2.0"
 description = "Local control for choochoo based thermostats"
 readme = "README.md"
 license = "Apache-2.0"
 authors = [
   { name = "J. Nick Koston", email = "nick@koston.org" },
 ]
-requires-python = ">=3.10"
+requires-python = ">=3.12"
 classifiers = [
   "Development Status :: 2 - Pre-Alpha",
   "Intended Audience :: Developers",
   "Natural Language :: English",
   "Operating System :: OS Independent",
-  "Programming Language :: Python :: 3.10",
-  "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: 3.14",
@@ -26,19 +24,21 @@ classifiers = [
 ]
 
 dependencies = [
-  "rich>=10",
-  "typer>=0.15,<1",
+  "orjson>=3.10",
 ]
+
 urls."Bug Tracker" = "https://github.com/hvaclibs/steamloop/issues"
 urls.Changelog = "https://github.com/hvaclibs/steamloop/blob/main/CHANGELOG.md"
 urls.documentation = "https://steamloop.readthedocs.io"
 urls.repository = "https://github.com/hvaclibs/steamloop"
-scripts.steamloop = "steamloop.cli:app"
+
+[project.scripts]
+steamloop = "steamloop.cli:main"
 
 [dependency-groups]
 dev = [
   "pytest==9.*",
-  "sybil[pytest]",
+  "pytest-asyncio",
   "coverage",
   "pytest-cov==7.*",
 ]
@@ -50,29 +50,70 @@ docs = [
 ]
 
 [tool.ruff]
+target-version = "py312"
 line-length = 88
 lint.select = [
-  "B",   # flake8-bugbear
-  "D",   # flake8-docstrings
-  "C4",  # flake8-comprehensions
-  "S",   # flake8-bandit
-  "F",   # pyflake
-  "E",   # pycodestyle
-  "W",   # pycodestyle
-  "UP",  # pyupgrade
-  "I",   # isort
-  "RUF", # ruff specific
+  "ASYNC", # async rules
+  "B",     # flake8-bugbear
+  "BLE",   # flake8-blind-except
+  "C",     # complexity + comprehensions
+  "COM818", # Trailing comma on bare tuple prohibited
+  "D",     # flake8-docstrings
+  "DTZ003", # Use datetime.now(tz=) instead of datetime.utcnow()
+  "DTZ004", # Use datetime.fromtimestamp(ts, tz=) instead of datetime.utcfromtimestamp(ts)
+  "E",     # pycodestyle
+  "F",     # pyflakes
+  "FLY",   # flynt
+  "FURB",  # refurb
+  "G",     # flake8-logging-format
+  "I",     # isort
+  "ICN001", # import conventions; {name} should be imported as {asname}
+  "INP",   # flake8-no-pep420
+  "ISC",   # flake8-implicit-str-concat
+  "LOG",   # flake8-logging
+  "N804",  # First argument of a class method should be named cls
+  "N805",  # First argument of a method should be named self
+  "N815",  # Variable {name} in class scope should not be mixedCase
+  "PERF",  # Perflint
+  "PGH",   # pygrep-hooks
+  "PIE",   # flake8-pie
+  "PL",    # pylint
+  "PT",    # flake8-pytest-style
+  "PTH",   # flake8-pathlib
+  "PYI",   # flake8-pyi
+  "RET",   # flake8-return
+  "RSE",   # flake8-raise
+  "RUF",   # ruff specific
+  "S",     # flake8-bandit
+  "SIM",   # flake8-simplify
+  "SLF",   # flake8-self
+  "SLOT",  # flake8-slots
+  "T100",  # Trace found: {name} used
+  "T20",   # flake8-print
+  "TC",    # flake8-type-checking
+  "TID",   # Tidy imports
+  "TRY",   # tryceratops
+  "UP",    # pyupgrade
+  "W",     # pycodestyle
 ]
 lint.ignore = [
-  "D203", # 1 blank line required before class docstring
-  "D212", # Multi-line docstring summary should start at the first line
-  "D100", # Missing docstring in public module
-  "D104", # Missing docstring in public package
-  "D107", # Missing docstring in `__init__`
-  "D401", # First line of docstring should be in imperative mood
+  "D203",    # 1 blank line required before class docstring
+  "D212",    # Multi-line docstring summary should start at the first line
+  "D213",    # Multi-line docstring summary should start at the second line
+  "D100",    # Missing docstring in public module
+  "D104",    # Missing docstring in public package
+  "D107",    # Missing docstring in `__init__`
+  "D401",    # First line of docstring should be in imperative mood
+  "COM812",  # May conflict with the formatter
+  "ISC001",  # May conflict with the formatter
+  "TRY003",  # Avoid specifying long messages outside the exception class
+  "TRY301",  # raise within try — used for exception wrapping
+  "PLR0913", # Too many arguments to function call
+  "PLR0911", # Too many return statements
+  "SIM110",  # Reimplementing builtin — can be slower
 ]
 lint.per-file-ignores."conftest.py" = [ "D100" ]
-lint.per-file-ignores."docs/conf.py" = [ "D100" ]
+lint.per-file-ignores."docs/conf.py" = [ "D100", "INP001" ]
 lint.per-file-ignores."setup.py" = [ "D100" ]
 lint.per-file-ignores."tests/**/*" = [
   "D100",
@@ -80,14 +121,31 @@ lint.per-file-ignores."tests/**/*" = [
   "D102",
   "D103",
   "D104",
+  "INP001",
+  "PLC0415",
+  "PLR2004",
+  "PT011",
+  "PT012",
   "S101",
+  "S105",
+  "S106",
+  "SLF001",
+  "TC002",
+  "TRY003",
+]
+lint.per-file-ignores."src/steamloop/cli.py" = [
+  "C901",    # _handle_command is inherently a command dispatcher
+  "PLR0912", # _handle_command has many branches by design
+  "PLR0915", # _handle_command has many statements by design
+  "PLR2004", # magic values in CLI arg counts are clear
+  "T201",    # print() is the CLI output mechanism
 ]
 lint.isort.known-first-party = [ "steamloop", "tests" ]
 
 [tool.pyproject-fmt]
 max_supported_python = "3.14"
 
-[tool.pytest]
+[tool.pytest.ini_options]
 minversion = "9.0"
 addopts = [
   "-v",
@@ -98,6 +156,7 @@ addopts = [
   "--cov-report=xml"
 ]
 pythonpath = [ "src" ]
+asyncio_mode = "auto"
 
 [tool.coverage]
 run.branch = true

steamloop-1.2.0/src/steamloop/__init__.py

@@ -0,0 +1,31 @@
+"""Local control for thermostat devices over mTLS."""
+
+__version__ = "1.2.0"
+
+from .connection import ThermostatConnection, load_pairing, save_pairing
+from .const import DEFAULT_PORT, FanMode, HoldType, ZoneMode
+from .exceptions import (
+    AuthenticationError,
+    CommandError,
+    PairingError,
+    SteamloopConnectionError,
+    SteamloopError,
+)
+from .models import ThermostatState, Zone
+
+__all__ = [
+    "DEFAULT_PORT",
+    "AuthenticationError",
+    "CommandError",
+    "FanMode",
+    "HoldType",
+    "PairingError",
+    "SteamloopConnectionError",
+    "SteamloopError",
+    "ThermostatConnection",
+    "ThermostatState",
+    "Zone",
+    "ZoneMode",
+    "load_pairing",
+    "save_pairing",
+]

steamloop-1.2.0/src/steamloop/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as ``python -m steamloop``."""
+
+from steamloop.cli import main
+
+main()