Merge pull request #67 from tuya/query-rooms-by-device

feat(home): add query_room_by_device to query a device's room

Author: ritchie-cai

README.md

@@ -32,6 +32,7 @@ With diversified devices and industries, Tuya IoT Development Platform opens bas
 	- send_commands
 - HomeRepository
 	- query_homes
+	- query_room_by_device
 - SceneRepository
 	- query_scenes
 	- trigger_scene
@@ -58,6 +59,7 @@ With diversified devices and industries, Tuya IoT Development Platform opens bas
 | 0.2.8   | Add report_type to device status  #51                  |
 | 0.2.9   | Fix incorrect type hint in DeviceFunction #44 <br/>Add pre-commit workflow #46 <br/>Apply ruff format #47 |
 | 0.2.10  | Make enum mapping lookups case-insensitive #55 <br/>Add ruff-check to pre-commit #56 <br/>Add ApiRequestException for failed API responses #58 <br/>Fix 0.2.9 changelog formatting #59 |
+| 0.2.11  | Add query_room_by_device to query the room a device belongs to |
 
 ## Installation
 

tuya_sharing/home.py

@@ -9,6 +9,13 @@ def __init__(self, id: str, name: str):
         self.name = name
 
 
+class SmartLifeRoom:
+    def __init__(self, id: str, name: str, display_order: int = 0):
+        self.id = id
+        self.name = name
+        self.display_order = display_order
+
+
 class HomeRepository:
     def __init__(self, customer_api: CustomerApi):
         self.api = customer_api
@@ -24,3 +31,15 @@ def query_homes(self) -> list[SmartLifeHome]:
             return _homes
 
         return []
+
+    def query_room_by_device(self, device_id: str) -> SmartLifeRoom | None:
+        response = self.api.get(f"/v1.0/cloud/life/ha/{device_id}/room")
+
+        if response.get("success", False):
+            room = response.get("result")
+            if room:
+                return SmartLifeRoom(
+                    str(room["id"]), room["name"], room.get("displayOrder", 0)
+                )
+
+        return None

tuya_sharing/manager.py

@@ -4,7 +4,7 @@
 
 from .customerapi import CustomerApi, CustomerTokenInfo, SharingTokenListener
 from .device import DeviceRepository, CustomerDevice
-from .home import HomeRepository, SmartLifeHome
+from .home import HomeRepository, SmartLifeHome, SmartLifeRoom
 from .scenes import SceneRepository
 from .user import UserRepository
 from .strategy import strategy
@@ -98,6 +98,9 @@ def refresh_mq(self):
     def send_commands(self, device_id: str, commands: list[dict[str, Any]]):
         return self.device_repository.send_commands(device_id, commands)
 
+    def query_room_by_device(self, device_id: str) -> Optional[SmartLifeRoom]:
+        return self.home_repository.query_room_by_device(device_id)
+
     def get_device_stream_allocate(
         self, device_id: str, stream_type: Literal["flv", "hls", "rtmp", "rtsp"]
     ) -> Optional[str]:

tuya_sharing/version.py

@@ -1,3 +1,3 @@
 """smartlife device sharing sdk version."""
 
-VERSION = "0.2.10"
+VERSION = "0.2.11"