Compare commits
	
		
			3 Commits
		
	
	
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
| 00ac6912e2 | |||
| 0f630e854e | |||
| 1ef5f7a64d | 
							
								
								
									
										22
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										22
									
								
								README.md
									
									
									
									
									
								
							| @ -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 | ||||
| [](https://pypi.org/project/pyhOn) | ||||
| [](https://pypi.org/project/pyhOn) | ||||
| [](https://www.python.org/) | ||||
| [](https://github.com/Andre0512/pyhOn/blob/main/LICENCE) | ||||
| [](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! | ||||
|  | ||||
|  | ||||
| @ -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
									
								
							
							
						
						
									
										7
									
								
								pyhon/appliances/wm.py
									
									
									
									
									
										Normal 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 | ||||
| @ -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 | ||||
|  | ||||
| @ -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}") | ||||
|  | ||||
							
								
								
									
										17
									
								
								setup.py
									
									
									
									
									
								
							
							
						
						
									
										17
									
								
								setup.py
									
									
									
									
									
								
							| @ -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', | ||||
|  | ||||
		Reference in New Issue
	
	Block a user
	