python-roborock 2.58.0__tar.gz → 2.59.0__tar.gz

{python_roborock-2.58.0 → python_roborock-2.59.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-roborock
-Version: 2.58.0
+Version: 2.59.0
 Summary: A package to control Roborock vacuums.
 Project-URL: Repository, https://github.com/humbertogontijo/python-roborock
 Project-URL: Documentation, https://python-roborock.readthedocs.io/

{python_roborock-2.58.0 → python_roborock-2.59.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-roborock"
-version = "2.58.0"
+version = "2.59.0"
 description = "A package to control Roborock vacuums."
 authors = [{ name = "humbertogontijo", email = "humbertogontijo@users.noreply.github.com" }, {name="Lash-L"}, {name="allenporter"}]
 requires-python = ">=3.11, <4"

{python_roborock-2.58.0 → python_roborock-2.59.0}/roborock/devices/channel.py

@@ -22,6 +22,11 @@ class Channel(Protocol):
         """Return true if the channel is connected."""
         ...
 
+    @property
+    def is_local_connected(self) -> bool:
+        """Return true if the channel is connected locally."""
+        ...
+
     async def subscribe(self, callback: Callable[[RoborockMessage], None]) -> Callable[[], None]:
         """Subscribe to messages from the device."""
         ...

{python_roborock-2.58.0 → python_roborock-2.59.0}/roborock/devices/device.py

@@ -87,6 +87,16 @@ class RoborockDevice(ABC, TraitsMixin):
         """Return whether the device is connected."""
         return self._channel.is_connected
 
+    @property
+    def is_local_connected(self) -> bool:
+        """Return whether the device is connected locally.
+
+        This can be used to determine if the device is reachable over a local
+        network connection, as opposed to a cloud connection. This is useful
+        for adjusting behavior like polling frequency.
+        """
+        return self._channel.is_local_connected
+
     async def connect(self) -> None:
         """Connect to the device using the appropriate protocol channel."""
         if self._unsub:

{python_roborock-2.58.0 → python_roborock-2.59.0}/roborock/devices/local_channel.py

@@ -56,6 +56,11 @@ class LocalChannel(Channel):
         """Check if the channel is currently connected."""
         return self._is_connected
 
+    @property
+    def is_local_connected(self) -> bool:
+        """Check if the channel is currently connected locally."""
+        return self._is_connected
+
     async def connect(self) -> None:
         """Connect to the device."""
         if self._is_connected:

{python_roborock-2.58.0 → python_roborock-2.59.0}/roborock/devices/mqtt_channel.py

@@ -40,6 +40,11 @@ class MqttChannel(Channel):
         """
         return self._mqtt_session.connected
 
+    @property
+    def is_local_connected(self) -> bool:
+        """Return true if the channel is connected locally."""
+        return False
+
     @property
     def _publish_topic(self) -> str:
         """Topic to send commands to the device."""

{python_roborock-2.58.0 → python_roborock-2.59.0}/roborock/devices/traits/v1/command.py

@@ -14,7 +14,7 @@ class CommandTrait:
         """
         self._rpc_channel = None
 
-    async def send(self, command: RoborockCommand, params: dict[str, Any] | None = None) -> Any:
+    async def send(self, command: RoborockCommand | str, params: dict[str, Any] | None = None) -> Any:
         """Send a command to the device."""
         if not self._rpc_channel:
             raise ValueError("Device trait in invalid state")