Metadata-Version: 2.2
Name: moehlenhoff-alpha2
Version: 1.4.0
Summary: Python client for the Moehlenhoff Alpha2 underfloor heating system
Author-email: Jan Schneider <oss@janschneider.net>
Project-URL: Homepage, https://github.com/j-a-n/python-moehlenhoff-alpha2
Project-URL: Repository, https://github.com/j-a-n/python-moehlenhoff-alpha2
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: aiohttp
Requires-Dist: xmltodict

# python-moehlenhoff-alpha2

Python client for the Moehlenhoff Alpha2 underfloor heating system

## Vendor documentation

- https://www.ezr-portal.de/backend/documents.php?d=Alpha2_XML_Schnittstellen_Informationen.zip

## Installation

Moehlenhoff Alpha2 can be installed from PyPI using `pip` or your package manager of choice:

```bash
pip install moehlenhoff-alpha2
```

## Usage example

```python
import asyncio
from moehlenhoff_alpha2 import Alpha2Base

async def main():
    base = Alpha2Base("192.168.1.1")
    await base.update_data()
    # Set current date and time in base
    await base.set_datetime()
    # Increase the temperature of heatarea by 0.2 degrees
    heat_area = list(base.heat_areas)[0]
    t_target = heat_area["T_TARGET"] + 0.2
    await base.update_heat_area(heat_area["ID"], {"T_TARGET": t_target})

asyncio.run(main())
```

## Development

Get [uv](https://docs.astral.sh/uv/)

```
# Install project dependencies
poetry sync

# Run tests
ALPHA2_BASE_ADDRESS=<address> uv run pytest --tb=short -o junit_family=xunit2 --junitxml=testreport.xml --cov-append --cov moehlenhoff_alpha2 --cov-report term --cov-report xml -v tests
```