python-roborock 5.7.0__py3-none-any.whl → 5.8.0__py3-none-any.whl

{python_roborock-5.7.0.dist-info → python_roborock-5.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-roborock
-Version: 5.7.0
+Version: 5.8.0
 Summary: A package to control Roborock vacuums.
 Project-URL: Repository, https://github.com/python-roborock/python-roborock
 Project-URL: Documentation, https://python-roborock.readthedocs.io/
@@ -21,7 +21,7 @@ Requires-Dist: click-shell~=2.1
 Requires-Dist: click>=8
 Requires-Dist: construct<3,>=2.10.57
 Requires-Dist: paho-mqtt<3.0.0,>=1.6.1
-Requires-Dist: protobuf<7,>=6.31.1
+Requires-Dist: protobuf<8,>=6.31.1
 Requires-Dist: pycryptodomex~=3.18; sys_platform == 'darwin'
 Requires-Dist: pycryptodome~=3.18
 Requires-Dist: pyrate-limiter<5,>=4.0.0

{python_roborock-5.7.0.dist-info → python_roborock-5.8.0.dist-info}/RECORD

@@ -5,7 +5,7 @@ roborock/cli.py,sha256=tCxPgdBBME1ZlOgU9_-Y4i7EXC_le1amW9spFqW7fmk,50628
 roborock/const.py,sha256=fWpgUPrCgLnaXmncgjCLZET-t7wHWQlpyzV8qHtTjb4,2860
 roborock/device_features.py,sha256=uhzhVbiltYybGZGzRTpmnizmILIOeY9cavwn8gzpXWM,35879
 roborock/diagnostics.py,sha256=YIc7BhC6Cy6W2a6hykvfSRPG8NpLrPZCc_7jTX2Zdho,5091
-roborock/exceptions.py,sha256=2zvuNrtrnrkYXNcwIWvE2Liv_01bJIwgxenHHmliUck,2608
+roborock/exceptions.py,sha256=t2YvfSRMymZPtdPV238itjxVJTaTq5-uBL_EM5FTlfg,3159
 roborock/protocol.py,sha256=eNUL6UGmtSdfsGM1mlYjmorukGGudV45iKXUA7a-Qa8,20193
 roborock/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 roborock/roborock_message.py,sha256=BPDT_uzCeD4L_4LottCMeft1kYmYPoG9ktcqqj0SYhQ,6466
@@ -27,7 +27,7 @@ roborock/data/dyad/dyad_containers.py,sha256=klJD2wV-2McjAoSN8Bthuyeid59L7M8nzSv
 roborock/data/v1/__init__.py,sha256=Lx_D6baZrCMxp57D0NcdiA8rssJ5NnInZwUwrT79XOI,91
 roborock/data/v1/v1_clean_modes.py,sha256=pJBwykCToEKZv9zs11x45Jjq3giUKfp0zibAjQ_LuOQ,7194
 roborock/data/v1/v1_code_mappings.py,sha256=qyCTWxnlyBMy8ZuoCRLR43fyLxjl_b6IfarG-M8GY-8,15251
-roborock/data/v1/v1_containers.py,sha256=yrv5uOdlZ1-iN8GamWajFKk7cpUTEyF8FqLTYoBW-_Y,26291
+roborock/data/v1/v1_containers.py,sha256=UM8hL2xKIx1u_L-tCxjapr0lV69fzxZxIOjxpUf9ASI,26295
 roborock/data/zeo/__init__.py,sha256=VxG5qG4M24DGOq2YAaxownWp6bEfj9DEOgOMHmTpcqY,63
 roborock/data/zeo/zeo_code_mappings.py,sha256=aj-TBjLWzxSBzpBESOtwNeFwD2rv-Jj95RZidO28szA,2319
 roborock/data/zeo/zeo_containers.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -57,9 +57,9 @@ roborock/devices/traits/b01/q7/map.py,sha256=Zrvj8LNctIFksCBoiZVQ1x4hgG3wwp1jqPY
 roborock/devices/traits/b01/q7/map_content.py,sha256=rI21-kMmIgf1TY98HXrWG_4rEEs9qzdYBm7RTU47yN4,3519
 roborock/devices/traits/v1/__init__.py,sha256=BIuc4Vh2aPQg8st2piHltG7mxWcGwgSwOtV1V9ftLSM,14201
 roborock/devices/traits/v1/child_lock.py,sha256=NeaPqcEoBRXvEzKZGonkyINkwCBOK3xa4zSWvJW66kA,1161
-roborock/devices/traits/v1/clean_summary.py,sha256=b0o_U-cGlhp1EwQ7e6SH5WzpshsuDkT2nqe7UWBt5r4,4264
+roborock/devices/traits/v1/clean_summary.py,sha256=2uDl3Tg6H9INf7HTEPPat_PBgodoWeX_ko5MJgWggn8,4625
 roborock/devices/traits/v1/command.py,sha256=2yNyCF_EDPkLE_vK6IN5VB8ZVypwrrwKTByCdQzJs3c,1494
-roborock/devices/traits/v1/common.py,sha256=XDY-14Tx3Kgt0nlzgPXWyWXpFVzFrv4W-jUqEtAiZ_Y,6240
+roborock/devices/traits/v1/common.py,sha256=1KOZImteAABc-pS1l0LGwsWPAIXakj6EYHRAAusVVm4,6602
 roborock/devices/traits/v1/consumeable.py,sha256=63Jpq_z1tAxfLnr_hgEZmQ0IBpdQbbhgeYZBPTUNgmw,1686
 roborock/devices/traits/v1/device_features.py,sha256=VKHs4gc6OJyk7f_-5uc6QdveLC20zzKNSYCt7-jyS0c,3766
 roborock/devices/traits/v1/do_not_disturb.py,sha256=_pJ-DS9r9h9eoTx1MW2MZ0RcrEh9J9gbSUPMQKoMSnE,1661
@@ -70,7 +70,7 @@ roborock/devices/traits/v1/led_status.py,sha256=qUY6GgC-RSXCAKlL2D0_FBO-1xwi2eU3
 roborock/devices/traits/v1/map_content.py,sha256=w_34H6ItiYm98QFOmEDCP0AvTBWAFVuB-uz5rmgBRwI,3175
 roborock/devices/traits/v1/maps.py,sha256=JdOjJCeJ6iAH85pNHKHbVGlD-zOrha9h6XAh7IDeQr8,3468
 roborock/devices/traits/v1/network_info.py,sha256=CX9-ye2Zb_8lAWPGvegXWSOguxMY2K0xO-2OmWmE67o,2291
-roborock/devices/traits/v1/rooms.py,sha256=md1J3h0Vx2UZK_10QlXWuTk1wFEtD7BEEYtFQMP2Zis,4850
+roborock/devices/traits/v1/rooms.py,sha256=o1VEb2OxedhCHxfKYZLhoBBvNZpsVuzqYUUap3DgGrA,5353
 roborock/devices/traits/v1/routines.py,sha256=BfktlpnyDjD2DB3zBDS5BnmjZPE38aHa-wjMontPnik,931
 roborock/devices/traits/v1/smart_wash_params.py,sha256=fAhJpMgUUP1kJcfEAAPeD3anMmCsuX7I1SEoUrUgfjE,504
 roborock/devices/traits/v1/status.py,sha256=F-2WyGv2xT6PM_dD7dyepZ-mvma9dBvNN5F5A1IVEhA,3158
@@ -96,8 +96,8 @@ roborock/protocols/a01_protocol.py,sha256=JCIhUuVNamcENu0gtZR2x8rBz6dpAZLcbA-NQg
 roborock/protocols/b01_q10_protocol.py,sha256=SimfXpQotkEkb58ThZq7xa7fCxPxF-hrpAJcRKI-yZE,3407
 roborock/protocols/b01_q7_protocol.py,sha256=o8repRrxhxknzspsg1K27ds643rs87ilWXbj8RJtOCs,4619
 roborock/protocols/v1_protocol.py,sha256=bSWqNJYL9feHmWch4OxoL6fVZwXf_YOjt3QnvdNsC24,9635
-python_roborock-5.7.0.dist-info/METADATA,sha256=oYDzsKNa6WzIyn3_cMEuFrgl95lRRO4IFneUUABIuxo,4962
-python_roborock-5.7.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-python_roborock-5.7.0.dist-info/entry_points.txt,sha256=EvC1nMqi9ZXKgZnqlNXA33v_3nzgPNjnM0mzWlrehnY,47
-python_roborock-5.7.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-python_roborock-5.7.0.dist-info/RECORD,,
+python_roborock-5.8.0.dist-info/METADATA,sha256=nZkO5gqv23iCmcvNjDPgRJWwv09BRQWC92_lCI3hsoY,4962
+python_roborock-5.8.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+python_roborock-5.8.0.dist-info/entry_points.txt,sha256=EvC1nMqi9ZXKgZnqlNXA33v_3nzgPNjnM0mzWlrehnY,47
+python_roborock-5.8.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+python_roborock-5.8.0.dist-info/RECORD,,

roborock/data/v1/v1_containers.py

@@ -792,7 +792,7 @@ class AppInitStatusLocalInfo(RoborockBase):
 class AppInitStatus(RoborockBase):
     local_info: AppInitStatusLocalInfo
     feature_info: list[int]
-    new_feature_info: int
+    new_feature_info: int = 0
     new_feature_info_str: str = ""
     new_feature_info_2: int | None = None
     carriage_type: int | None = None

roborock/devices/traits/v1/clean_summary.py

@@ -2,6 +2,7 @@ import logging
 
 from roborock.data import CleanRecord, CleanSummaryWithDetail, RoborockBase
 from roborock.devices.traits.v1 import common
+from roborock.exceptions import RoborockParsingException
 from roborock.roborock_typing import RoborockCommand
 from roborock.util import unpack_list
 
@@ -87,4 +88,12 @@ class CleanSummaryTrait(CleanSummaryWithDetail, common.V1TraitMixin):
     async def get_clean_record(self, record_id: int) -> CleanRecord:
         """Load a specific clean record by ID."""
         response = await self.rpc_channel.send_command(RoborockCommand.GET_CLEAN_RECORD, params=[record_id])
-        return self.clean_record_converter.convert(response)
+        try:
+            return self.clean_record_converter.convert(response)
+        except (TypeError, ValueError) as err:
+            raise RoborockParsingException(
+                trait_name=type(self).__name__,
+                command=RoborockCommand.GET_CLEAN_RECORD,
+                payload=response,
+                inner_error=err,
+            ) from err

roborock/devices/traits/v1/common.py

@@ -9,6 +9,7 @@ from dataclasses import fields
 from typing import ClassVar
 
 from roborock.data import RoborockBase
+from roborock.exceptions import RoborockParsingException
 from roborock.protocols.v1_protocol import V1RpcChannel
 from roborock.roborock_typing import RoborockCommand
 
@@ -63,7 +64,7 @@ class V1TraitMixin(ABC):
 
     def __init__(self) -> None:
         """Initialize the V1TraitMixin."""
-        self._rpc_channel = None
+        self._rpc_channel: V1RpcChannel | None = None
 
     @property
     def rpc_channel(self) -> V1RpcChannel:
@@ -75,7 +76,15 @@ class V1TraitMixin(ABC):
     async def refresh(self) -> None:
         """Refresh the contents of this trait."""
         response = await self.rpc_channel.send_command(self.command)
-        new_data = self.converter.convert(response)
+        try:
+            new_data = self.converter.convert(response)
+        except (TypeError, ValueError) as err:
+            raise RoborockParsingException(
+                trait_name=type(self).__name__,
+                command=self.command,
+                payload=response,
+                inner_error=err,
+            ) from err
         merge_trait_values(self, new_data)  # type: ignore[arg-type]
 
 

roborock/devices/traits/v1/rooms.py

@@ -5,6 +5,7 @@ from dataclasses import dataclass
 
 from roborock.data import HomeData, HomeDataRoom, NamedRoomMapping, RoborockBase
 from roborock.devices.traits.v1 import common
+from roborock.exceptions import RoborockParsingException
 from roborock.roborock_typing import RoborockCommand
 from roborock.web_api import UserWebApiClient
 
@@ -94,7 +95,12 @@ class RoomsTrait(Rooms, common.V1TraitMixin):
         """Refresh room mappings and backfill unknown room names from the web API."""
         response = await self.rpc_channel.send_command(self.command)
         if not isinstance(response, list):
-            raise ValueError(f"Unexpected RoomsTrait response format: {response!r}")
+            raise RoborockParsingException(
+                trait_name=type(self).__name__,
+                command=self.command,
+                payload=response,
+                inner_error="Unexpected RoomsTrait response format",
+            )
 
         segment_map = RoomsConverter.extract_segment_map(response)
         # Track all iot ids seen before. Refresh the room list when new ids are found.
@@ -105,8 +111,16 @@ class RoomsTrait(Rooms, common.V1TraitMixin):
                 _LOGGER.debug("Updating rooms: %s", list(updated_rooms))
                 self._home_data.rooms = updated_rooms
             self._discovered_iot_ids.update(new_iot_ids)
+        try:
+            rooms = self.converter.convert(response)
+        except (TypeError, ValueError) as err:
+            raise RoborockParsingException(
+                trait_name=type(self).__name__,
+                command=self.command,
+                payload=response,
+                inner_error=err,
+            ) from err
 
-        rooms = self.converter.convert(response)
         rooms = rooms.with_room_names(self._home_data.rooms_name_map)
         common.merge_trait_values(self, rooms)
 

roborock/exceptions.py

@@ -1,5 +1,8 @@
 """Roborock exceptions."""
 
+from enum import Enum
+from typing import Any
+
 
 class RoborockException(Exception):
     """Class for Roborock exceptions."""
@@ -91,3 +94,14 @@ class RoborockInvalidStatus(RoborockException):
 
 class RoborockUnsupportedFeature(RoborockException):
     """Class for Roborock unsupported feature exceptions."""
+
+
+class RoborockParsingException(RoborockException):
+    """Class for Roborock exceptions when parsing device responses."""
+
+    def __init__(self, trait_name: str, command: Enum | str, payload: Any, inner_error: Exception | str) -> None:
+        cmd_name = command.name if isinstance(command, Enum) else str(command)
+        self.message = (
+            f"Failed to parse {cmd_name} response for {trait_name}. Payload: {payload!r} Error: {inner_error!r}"
+        )
+        super().__init__(self.message)