Compare commits

..

3 Commits

Author SHA1 Message Date
00ac6912e2 Fixed setting wrong current value 2023-03-05 19:03:03 +01:00
0f630e854e Read out connection 2023-03-05 18:46:51 +01:00
1ef5f7a64d Add badges 2023-03-04 22:38:43 +01:00
6 changed files with 61 additions and 11 deletions

View File

@ -1,13 +1,24 @@
**This python package is unofficial and is not related in any way to Haier. It was developed by reversed engineered requests and can stop working at anytime!**
# pyhOn
[![PyPI - Status](https://img.shields.io/pypi/status/pyhOn)](https://pypi.org/project/pyhOn)
[![PyPI](https://img.shields.io/pypi/v/pyhOn?color=blue)](https://pypi.org/project/pyhOn)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pyhOn)](https://www.python.org/)
[![PyPI - License](https://img.shields.io/pypi/l/pyhOn)](https://github.com/Andre0512/pyhOn/blob/main/LICENCE)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/pyhOn)](https://pypistats.org/packages/pyhOn)
Control your Haier appliances with python!
The idea behind this library is, to make the use of all available commands as simple as possible.
## Installation
```bash
pip install pyhOn
```
### Quick overview
To get an idea of what is possible, use the commandline-tool `pyhOn`. This lists all available options of the appliances from your Haier Account.
To get an idea of what is possible, use the commandline-tool `pyhOn`. This command requests all available options of connected appliances from the hOn api of your Haier Account.
```commandline
$ pyhOn --user example@mail.com --password pass123
========== Waschmaschine ==========
========== WM - Waschmaschine ==========
commands:
pauseProgram: pauseProgram command
resumeProgram: resumeProgram command
@ -20,7 +31,6 @@ data:
antiAllergyStatus: 0
...
```
The claim is, to see everything what you can see in your hOn app and to execute everything you can execute there.
## Python-API
### List devices
@ -67,7 +77,11 @@ async with HonConnection(USER, PASSWORD) as hon:
## Tested devices
- Haier Washing Machine HW90
_Unfortunately I don't have any more haier appliances_
_Unfortunately I don't have any more Haier appliances..._
## Usage example
This library is used for the custom [HomeAssistant Integration "Haier hOn"](https://github.com/Andre0512/hOn).
## Contribution
Any kind of contribution is welcome!

View File

@ -55,7 +55,7 @@ async def main():
password = getpass("Password for hOn account: ")
async with HonConnection(user, password) as hon:
for device in hon.devices:
print("=" * 10, device.nick_name, "=" * 10)
print("=" * 10, device.appliance_type_name, "-", device.nick_name, "=" * 10)
pretty_print({"commands": device.commands})
pretty_print({"data": device.data})

7
pyhon/appliances/wm.py Normal file
View File

@ -0,0 +1,7 @@
class Appliance:
def __init__(self, data):
self._data = data
def get(self):
self._data["connected"] = self._data["lastConnEvent.category"] == "CONNECTED"
return self._data

View File

@ -1,9 +1,14 @@
import importlib
from pprint import pprint
from pyhon.commands import HonCommand
class HonDevice:
def __init__(self, connector, appliance):
self._appliance = appliance
for values in self._appliance.pop("attributes"):
self._appliance[values["parName"]] = values["parValue"]
self._connector = connector
self._appliance_model = {}
@ -123,6 +128,10 @@ class HonDevice:
def statistics(self):
return self._statistics
@property
def appliance(self):
return self._appliance
async def load_commands(self):
raw = await self._connector.load_commands(self)
self._appliance_model = raw.pop("applianceModel")
@ -160,6 +169,8 @@ class HonDevice:
data = await self._connector.load_attributes(self)
for name, values in data.get("shadow").get("parameters").items():
self._attributes[name] = values["parNewVal"]
for name, value in data.get("lastConnEvent").items():
self._attributes[f"lastConnEvent.{name}"] = value
async def load_statistics(self):
self._statistics = await self._connector.load_statistics(self)
@ -169,4 +180,9 @@ class HonDevice:
@property
def data(self):
return self.attributes | self.parameters | self._appliance | self._statistics
result = self.attributes | self.parameters | self.appliance | self._statistics
try:
extra = importlib.import_module(f'appliances.{self.appliance_type_name.lower()}')
return result | extra.Appliance(result).get()
except ModuleNotFoundError:
return result

View File

@ -76,7 +76,7 @@ class HonParameterRange(HonParameter):
@value.setter
def value(self, value):
if self._min <= value <= self._max and not value % self._step:
self._value = self._value
self._value = value
else:
raise ValueError(f"Allowed: min {self._min} max {self._max} step {self._step}")
@ -102,7 +102,7 @@ class HonParameterEnum(HonParameter):
@value.setter
def value(self, value):
if value in self.values:
self._value = self._value
self._value = value
else:
raise ValueError(f"Allowed values {self._value}")
@ -123,4 +123,4 @@ class HonParameterProgram(HonParameterEnum):
if value in self.values:
self._command.set_program(value)
else:
raise ValueError(f"Allowed values {self._value}")
raise ValueError(f"Allowed values {self._values}")

View File

@ -7,18 +7,31 @@ with open("README.md", "r") as f:
setup(
name="pyhOn",
version="0.2.1",
version="0.2.4",
author="Andre Basche",
description="Control hOn devices with python",
long_description=long_description,
long_description_content_type='text/markdown',
url="https://github.com/Andre0512/pyh0n",
project_urls={
"GitHub": "https://github.com/Andre0512/pyhOn",
"PyPI": "https://pypi.org/project/pyhOn",
},
license="MIT",
platforms="any",
packages=find_packages(),
include_package_data=True,
python_requires=">=3.10",
install_requires=["aiohttp"],
classifiers=[
"Development Status :: 3 - Alpha",
"Environment :: Console",
"License :: OSI Approved :: MIT License",
"Natural Language :: English",
"Operating System :: OS Independent",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Topic :: Software Development :: Libraries :: Python Modules",
],
entry_points={
'console_scripts': [
'pyhOn = pyhon.__main__:start',