python-swidget 1.4.11__tar.gz → 1.4.13__tar.gz

{python_swidget-1.4.11 → python_swidget-1.4.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-swidget
-Version: 1.4.11
+Version: 1.4.13
 Summary: Python API for Swidget smart devices
 Home-page: https://github.com/swidget/python-swidget
 License: GPL-3.0-or-later

{python_swidget-1.4.11 → python_swidget-1.4.13}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "python-swidget"
-version = "1.4.11"
+version = "1.4.13"
 description = "Python API for Swidget smart devices"
 license = "GPL-3.0-or-later"
 authors = ["Swidget"]

{python_swidget-1.4.11 → python_swidget-1.4.13}/swidget/swidgetdevice.py

@@ -381,6 +381,18 @@ class SwidgetDevice:
         self.device_config = DeviceConfiguration(config)
         self._last_update = int(time.time())
 
+    async def set_device_config(self, updates: Dict[str, Any]) -> None:
+        """POST a partial device_config update.
+
+        The firmware accepts a sparse dict mirroring the full config tree
+        (only the changed leaves), so callers should pass the same nested
+        shape ``get_device_config()`` returns. After the POST succeeds the
+        local cache is refreshed so reads see the new value immediately.
+        """
+        _LOGGER.debug("SwidgetDevice.set_device_config(%s) called", updates)
+        await self.make_http_request("POST", "device_config", json_payload=updates)
+        await self.get_device_config()
+
     async def get_summary(self) -> None:
         """Get a summary of the device over HTTP."""
         _LOGGER.debug("SwidgetDevice.get_summary() called")
@@ -889,6 +901,49 @@ class SwidgetDevice:
             return True
         return False
 
+    @property
+    def rtsp_enabled(self) -> Optional[bool]:
+        """Return whether the video insert's RTSP server is enabled.
+
+        Returns None when the config hasn't been fetched yet or the path
+        isn't present (non-video insert, or older firmware that omits the
+        key). Callers should treat None as "unknown" rather than False.
+        """
+        try:
+            return bool(
+                self.device_config.config["insert"]["components"]["video"]["rtsp"][
+                    "enable"
+                ]
+            )
+        except (KeyError, TypeError):
+            return None
+
+    async def set_rtsp_enabled(self, enabled: bool) -> None:
+        """Enable or disable the video insert's RTSP server."""
+        await self.set_device_config(
+            {"insert": {"components": {"video": {"rtsp": {"enable": bool(enabled)}}}}}
+        )
+
+    @property
+    def rtsp_stream_source(self) -> Optional[str]:
+        """Return the device's RTSP URL, or None when unavailable.
+
+        Path ``/ph264`` is fixed by firmware; the port comes from device
+        config. None if RTSP is disabled, the insert isn't video, or the
+        config hasn't been loaded yet.
+        """
+        if self.rtsp_enabled is not True:
+            return None
+        try:
+            port = int(
+                self.device_config.config["insert"]["components"]["video"]["rtsp"][
+                    "port"
+                ]
+            )
+        except (KeyError, TypeError, ValueError):
+            return None
+        return f"rtsp://{self.ip_address}:{port}/ph264"
+
     async def __aenter__(self) -> "SwidgetDevice":
         """Initialize and connect the Swidget Websocket client."""
         await self.connect()