homecom-alt 1.0.0__tar.gz

homecom_alt-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 serbanb11
+
+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.

homecom_alt-1.0.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE README.md
+include requirements.txt
+include requirements-test.txt

homecom_alt-1.0.0/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.1
+Name: homecom_alt
+Version: 1.0.0
+Summary: Python wrapper for controlling devices managed by HomeCom Easy APP.
+Home-page: https://github.com/serbanb11/homecom-alt
+Author: serbanb11
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# homecom-alt
+
+Python wrapper for controlling devices managed by HomeCom Easy APP.
+
+## How to use package
+[Check example.py](example.py)
+
+or
+
+```python
+"""An example of using HomeCom alt package."""
+import asyncio
+import logging
+
+from aiohttp import ClientConnectorError, ClientError, ClientSession
+
+from homecom_alt import (
+    ApiError,
+    AuthFailedError,
+    ConnectionOptions,
+    InvalidSensorDataError,
+    HomeComAlt,
+    BHCDevice,
+)
+
+logging.basicConfig(level=logging.DEBUG)
+
+USERNAME = "user"
+PASSWORD = "password"
+
+def print_status(data: BHCDevice):
+    print("firmware: {data.firmware}")
+    print("notifications: {data.notifications}")
+    for ref in data.stardard_functions:
+        normalized_id = ref["id"].split("/", 2)[-1]
+
+        match normalized_id:
+            case "operationMode":
+                print(f"operationMode current_value: {ref["value"]}, allowed_values: {ref["allowedValues"]}")
+            case "acControl":
+                print(f"acControl current_value: {ref["value"]}, allowed_values: {ref["allowedValues"]}")
+            case "fanSpeed":
+                print(f"fanSpeed current_value: {ref["value"]}, allowed_values: {ref["allowedValues"]}")
+            case "airFlowHorizontal":
+                print(f"airFlowHorizontal current_value: {ref["value"]}, allowed_values: {ref["allowedValues"]}")
+            case "airFlowVertical":
+                print(f"airFlowVertical current_value: {ref["value"]}, allowed_values: {ref["allowedValues"]}")
+            case "temperatureSetpoint":
+                print(f"temperatureSetpoint current_value: {ref["value"]}{ref["unitOfMeasure"]}")
+                print(f"temperatureSetpoint min_value: {ref["minValue"]} max_value: {ref["maxValue"]}")
+            case "roomTemperature":
+                print(f"roomTemperature current_value: {ref["value"]}{ref["unitOfMeasure"]}")
+            case _:
+                pass
+
+    for ref in data.advanced_functions:
+        normalized_id = ref["id"].split("/", 2)[-1]
+
+        match normalized_id:
+            case "airPurificationMode":
+                print(f"plasmacluster current_value: {ref["value"]}")
+            case "fullPowerMode":
+                print(f"boost current_value: {ref["value"]}")
+            case "ecoMode":
+                print(f"eco mode current_value: {ref["value"]}")
+            case "timers/on":
+                print(f"timer turn on current_value: {ref["value"]} {ref["unitOfMeasure"]}")
+                print(f"timer turn on min_value: {ref["minValue"]} max_value: {ref["maxValue"]}")
+            case "timers/off":
+                print(f"timer turn off current_value: {ref["value"]} {ref["unitOfMeasure"]}")
+                print(f"timer turn off min_value: {ref["minValue"]} max_value: {ref["maxValue"]}")
+            case _:
+                pass
+
+    for ref in data.switch_programs:
+        normalized_id = ref["id"].split("/", 2)[-1]
+
+        match normalized_id:
+            case "switchPrograms/enabled":
+                print(f"programs current_value: {ref["value"]}")
+            case "switchPrograms/activeProgram":
+                print(f"program current_value: {ref["value"]}, allowed_values: {ref["allowedValues"]}")
+            case _:
+                pass
+
+async def main():
+    """Run main function."""
+    options = ConnectionOptions(username=USERNAME, password=PASSWORD)
+
+    async with ClientSession() as websession:
+        bhc = await HomeComAlt.create(websession, options)
+
+        try:
+            data: dict[str, BHCDevice] = {}
+            device_ids: list[str] = []
+            # get devices synced with homecom easy
+            devices = await bhc.async_get_devices()
+            # get status for each device discovered
+            for device in await devices:
+                print(f"Device={device["deviceId"]}, type={device["deviceType"]}")
+                device_ids.append(device["deviceId"])
+            while True:
+                device_id = input(f"Enter the device you want to control: {', '.join(device_ids)}")
+                if device_id not in device_ids:
+                    print("device_id not in the list of devices")
+                    continue
+                data: BHCDevice = await bhc.async_update(device_id)
+                print_status(data)
+                break
+
+loop = asyncio.new_event_loop()
+loop.run_until_complete(main())
+loop.close()
+
+```

homecom_alt-1.0.0/README.md

@@ -0,0 +1,115 @@
+# homecom-alt
+
+Python wrapper for controlling devices managed by HomeCom Easy APP.
+
+## How to use package
+[Check example.py](example.py)
+
+or
+
+```python
+"""An example of using HomeCom alt package."""
+import asyncio
+import logging
+
+from aiohttp import ClientConnectorError, ClientError, ClientSession
+
+from homecom_alt import (
+    ApiError,
+    AuthFailedError,
+    ConnectionOptions,
+    InvalidSensorDataError,
+    HomeComAlt,
+    BHCDevice,
+)
+
+logging.basicConfig(level=logging.DEBUG)
+
+USERNAME = "user"
+PASSWORD = "password"
+
+def print_status(data: BHCDevice):
+    print("firmware: {data.firmware}")
+    print("notifications: {data.notifications}")
+    for ref in data.stardard_functions:
+        normalized_id = ref["id"].split("/", 2)[-1]
+
+        match normalized_id:
+            case "operationMode":
+                print(f"operationMode current_value: {ref["value"]}, allowed_values: {ref["allowedValues"]}")
+            case "acControl":
+                print(f"acControl current_value: {ref["value"]}, allowed_values: {ref["allowedValues"]}")
+            case "fanSpeed":
+                print(f"fanSpeed current_value: {ref["value"]}, allowed_values: {ref["allowedValues"]}")
+            case "airFlowHorizontal":
+                print(f"airFlowHorizontal current_value: {ref["value"]}, allowed_values: {ref["allowedValues"]}")
+            case "airFlowVertical":
+                print(f"airFlowVertical current_value: {ref["value"]}, allowed_values: {ref["allowedValues"]}")
+            case "temperatureSetpoint":
+                print(f"temperatureSetpoint current_value: {ref["value"]}{ref["unitOfMeasure"]}")
+                print(f"temperatureSetpoint min_value: {ref["minValue"]} max_value: {ref["maxValue"]}")
+            case "roomTemperature":
+                print(f"roomTemperature current_value: {ref["value"]}{ref["unitOfMeasure"]}")
+            case _:
+                pass
+
+    for ref in data.advanced_functions:
+        normalized_id = ref["id"].split("/", 2)[-1]
+
+        match normalized_id:
+            case "airPurificationMode":
+                print(f"plasmacluster current_value: {ref["value"]}")
+            case "fullPowerMode":
+                print(f"boost current_value: {ref["value"]}")
+            case "ecoMode":
+                print(f"eco mode current_value: {ref["value"]}")
+            case "timers/on":
+                print(f"timer turn on current_value: {ref["value"]} {ref["unitOfMeasure"]}")
+                print(f"timer turn on min_value: {ref["minValue"]} max_value: {ref["maxValue"]}")
+            case "timers/off":
+                print(f"timer turn off current_value: {ref["value"]} {ref["unitOfMeasure"]}")
+                print(f"timer turn off min_value: {ref["minValue"]} max_value: {ref["maxValue"]}")
+            case _:
+                pass
+
+    for ref in data.switch_programs:
+        normalized_id = ref["id"].split("/", 2)[-1]
+
+        match normalized_id:
+            case "switchPrograms/enabled":
+                print(f"programs current_value: {ref["value"]}")
+            case "switchPrograms/activeProgram":
+                print(f"program current_value: {ref["value"]}, allowed_values: {ref["allowedValues"]}")
+            case _:
+                pass
+
+async def main():
+    """Run main function."""
+    options = ConnectionOptions(username=USERNAME, password=PASSWORD)
+
+    async with ClientSession() as websession:
+        bhc = await HomeComAlt.create(websession, options)
+
+        try:
+            data: dict[str, BHCDevice] = {}
+            device_ids: list[str] = []
+            # get devices synced with homecom easy
+            devices = await bhc.async_get_devices()
+            # get status for each device discovered
+            for device in await devices:
+                print(f"Device={device["deviceId"]}, type={device["deviceType"]}")
+                device_ids.append(device["deviceId"])
+            while True:
+                device_id = input(f"Enter the device you want to control: {', '.join(device_ids)}")
+                if device_id not in device_ids:
+                    print("device_id not in the list of devices")
+                    continue
+                data: BHCDevice = await bhc.async_update(device_id)
+                print_status(data)
+                break
+
+loop = asyncio.new_event_loop()
+loop.run_until_complete(main())
+loop.close()
+
+```