pysilverline 0.2.1__tar.gz

pysilverline-0.2.1/.gitignore

@@ -0,0 +1,22 @@
+__pycache__/
+*.pyc
+.pytest_cache/
+.coverage
+htmlcov/
+*.egg-info/
+build/
+dist/
+.venv/
+venv/
+.mypy_cache/
+.ruff_cache/
+.snapshots/
+.DS_Store
+
+# Secrets — local credentials for the live device
+access.yaml
+
+# Live-device probe captures (large, host-specific, regenerated as needed)
+tests/fixtures/live_*.json
+tests/fixtures/full_exercise.json
+tests/fixtures/range_probe.json

pysilverline-0.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Christian Reiss
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pysilverline-0.2.1/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: pysilverline
+Version: 0.2.1
+Summary: Async client for Poolex Silverline / Tuya v3.3 pool heat pumps.
+Project-URL: Homepage, https://github.com/christianreiss/ha-silverline
+Project-URL: Issues, https://github.com/christianreiss/ha-silverline/issues
+Author-email: Christian Reiss <email@christian-reiss.de>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: heatpump,home-assistant,poolex,silverline,tuya
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Home Automation
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: cryptography>=41.0
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.23; extra == 'test'
+Requires-Dist: pytest>=8; extra == 'test'
+Description-Content-Type: text/markdown
+
+# pysilverline
+
+Async client for **Poolex Silverline / Tuya v3.3** pool heat pumps. Speaks the
+local Tuya protocol (TCP/6668, AES-128-ECB) directly — no cloud, no Smart Life
+account at runtime.
+
+This package is the I/O layer underneath the
+[`poolex_silverline`](https://github.com/christianreiss/ha-silverline) Home
+Assistant integration but works standalone too.
+
+## Install
+
+```bash
+pip install pysilverline
+```
+
+## Use
+
+```python
+import asyncio
+from pysilverline import SilverlineClient
+
+async def main():
+    client = SilverlineClient(
+        host="10.0.0.50",
+        device_id="bf1234567890abcdefghij",
+        local_key="0123456789abcdef",
+    )
+    await client.connect()
+    state = await client.get_status()
+    print(state)
+    await client.set_dp(2, 28)        # set target temp to 28 °C
+    await client.set_dp(4, "BoostHeat")
+    await client.disconnect()
+
+asyncio.run(main())
+```
+
+Listen for spontaneous push updates from the device:
+
+```python
+def on_update(state):
+    print("push:", state.mode, state.temp_current)
+
+unsub = client.add_listener(on_update)
+# ... later
+unsub()
+```
+
+## Compatible devices
+
+The Tuya schema is shared across the Poolex Silverline FI family and several
+OEM siblings: Poolex JetLine Selection FI, Steinbach Silent Mini, Brustec BR
+series, Phalén Calidi XP. DPs 1, 2, 3, 4, 13 are confirmed across the family;
+DPs 101–111 are firmware-dependent.
+
+## License
+
+MIT

pysilverline-0.2.1/README.md

@@ -0,0 +1,59 @@
+# pysilverline
+
+Async client for **Poolex Silverline / Tuya v3.3** pool heat pumps. Speaks the
+local Tuya protocol (TCP/6668, AES-128-ECB) directly — no cloud, no Smart Life
+account at runtime.
+
+This package is the I/O layer underneath the
+[`poolex_silverline`](https://github.com/christianreiss/ha-silverline) Home
+Assistant integration but works standalone too.
+
+## Install
+
+```bash
+pip install pysilverline
+```
+
+## Use
+
+```python
+import asyncio
+from pysilverline import SilverlineClient
+
+async def main():
+    client = SilverlineClient(
+        host="10.0.0.50",
+        device_id="bf1234567890abcdefghij",
+        local_key="0123456789abcdef",
+    )
+    await client.connect()
+    state = await client.get_status()
+    print(state)
+    await client.set_dp(2, 28)        # set target temp to 28 °C
+    await client.set_dp(4, "BoostHeat")
+    await client.disconnect()
+
+asyncio.run(main())
+```
+
+Listen for spontaneous push updates from the device:
+
+```python
+def on_update(state):
+    print("push:", state.mode, state.temp_current)
+
+unsub = client.add_listener(on_update)
+# ... later
+unsub()
+```
+
+## Compatible devices
+
+The Tuya schema is shared across the Poolex Silverline FI family and several
+OEM siblings: Poolex JetLine Selection FI, Steinbach Silent Mini, Brustec BR
+series, Phalén Calidi XP. DPs 1, 2, 3, 4, 13 are confirmed across the family;
+DPs 101–111 are firmware-dependent.
+
+## License
+
+MIT

pysilverline-0.2.1/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pysilverline"
+version = "0.2.1"
+description = "Async client for Poolex Silverline / Tuya v3.3 pool heat pumps."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.13"
+authors = [{ name = "Christian Reiss", email = "email@christian-reiss.de" }]
+keywords = ["tuya", "poolex", "silverline", "heatpump", "home-assistant"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Home Automation",
+    "Typing :: Typed",
+]
+dependencies = ["cryptography>=41.0"]
+
+[project.optional-dependencies]
+test = ["pytest>=8", "pytest-asyncio>=0.23"]
+
+[project.urls]
+Homepage = "https://github.com/christianreiss/ha-silverline"
+Issues = "https://github.com/christianreiss/ha-silverline/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pysilverline"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+addopts = "-p no:homeassistant -p no:pytest_homeassistant_custom_component -p no:pytest-homeassistant-custom-component -p no:syrupy"
+
+[tool.mypy]
+strict = true
+python_version = "3.13"
+files = ["src/pysilverline"]

pysilverline-0.2.1/src/pysilverline/__init__.py

@@ -0,0 +1,30 @@
+"""Async client for Poolex Silverline / Tuya v3.3 pool heat pumps."""
+
+from __future__ import annotations
+
+from . import const
+from .client import SilverlineClient
+from .discovery import DiscoveryInfo, discover, discover_once
+from .exceptions import (
+    CannotConnect,
+    InvalidAuth,
+    ProtocolError,
+    SilverlineError,
+)
+from .models import DeviceInfo, DeviceState
+
+__all__ = [
+    "CannotConnect",
+    "DeviceInfo",
+    "DeviceState",
+    "DiscoveryInfo",
+    "InvalidAuth",
+    "ProtocolError",
+    "SilverlineClient",
+    "SilverlineError",
+    "const",
+    "discover",
+    "discover_once",
+]
+
+__version__ = "0.2.1"