Metadata-Version: 2.4
Name: visionpluspython
Version: 1.1.0
Summary: Python API wrapper for Watts Vision+ smart heating system
Author-email: Théo BRILLAND <theo.brilland@wattswater.com>, Devender VERMA <devender.verma@wattswater.com>, Seweryn SIREK <ssi@spyro-soft.com>
License: MIT
Project-URL: Homepage, https://github.com/Watts-Digital/visionpluspython
Project-URL: Documentation, https://github.com/Watts-Digital/visionpluspython
Project-URL: Repository, https://github.com/Watts-Digital/visionpluspython
Project-URL: Bug Tracker, https://github.com/Watts-Digital/visionpluspython/issues
Project-URL: Changelog, https://github.com/Watts-Digital/visionpluspython/blob/main/README.md#changelog
Keywords: watts,vision,plus,smart,heating,thermostat,home automation,iot
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Home Automation
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp<4.0.0,>=3.8.0
Requires-Dist: PyJWT>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Requires-Dist: build>=0.10.0; extra == "dev"
Dynamic: license-file

# visionpluspython

[![PyPI version](https://badge.fury.io/py/visionpluspython.svg)](https://badge.fury.io/py/visionpluspython)
[![Python Support](https://img.shields.io/pypi/pyversions/visionpluspython.svg)](https://pypi.org/project/visionpluspython/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A Python API wrapper for Watts Vision+ smart home system, providing easy Home Assistant integration with thermostats and switches.

## Features

- **OAuth2 authentication** - Secure token-based authentication with automatic refresh
- **Device discovery** - Automatic discovery of all connected devices
- **Thermostat control** - Set temperature, modes, and read current status
- **Switch control** - Control on/off switches

## Installation

### From PyPI (recommended)

```bash
pip install visionpluspython
```

## Supported Device Types

### Thermostat
Control and monitor Watts heating devices.

**Available thermostat modes:**
- `PROGRAM` - Follow programmed schedule
- `COMFORT` - Comfort mode
- `ECO` - Energy saving mode
- `OFF` - Turn off heating
- `DEFROST` - Defrost mode
- `TIMER` - Timer mode

### Switch
Control Watts switch (on/off) devices

## Requirements

- Python 3.9+
- aiohttp >= 3.8.0

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Changelog

### 1.1.0 (2026-03-20)
- Add HVAC state to the API response
- Fix serialization issue when API does not return all device fields
- Use field default factory for available thermostat modes

### 1.0.2 (2025-12-17)
- Add strict typing

### 1.0.1 (2025-09-29)
- Use generic auth method
- Add GitHub workflows for release and publishing to PyPI

### 1.0.0 (2025-08-01)
- Initial release
- OAuth2 authentication support
- Device discovery and control
- Thermostat and switch support