ucapi-framework 1.9.0b2__tar.gz → 1.9.0b3__tar.gz

{ucapi_framework-1.9.0b2 → ucapi_framework-1.9.0b3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ucapi-framework
-Version: 1.9.0b2
+Version: 1.9.0b3
 Summary: ucapi framework that provides core functionality for building integrations.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{ucapi_framework-1.9.0b2 → ucapi_framework-1.9.0b3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ucapi-framework"
-version = "1.9.0b2"
+version = "1.9.0b3"
 description = "ucapi framework that provides core functionality for building integrations."
 readme = "README.md"
 requires-python = ">=3.11"

{ucapi_framework-1.9.0b2 → ucapi_framework-1.9.0b3}/ucapi_framework/device.py

@@ -119,6 +119,26 @@ class BaseDeviceInterface(ABC):
         """
         return self._driver
 
+    def push_update(self) -> None:
+        """
+        Notify the framework that this device's state has changed.
+
+        Emits ``DeviceEvents.UPDATE`` with no payload. Any entity that has called
+        ``subscribe_to_device()`` will have its ``sync_state()`` method invoked
+        automatically in response.
+
+        This is the recommended way to trigger state propagation when using the
+        coordinator pattern::
+
+            async def _poll(self):
+                self.volume = await self._fetch_volume()
+                self.push_update()
+
+        For the legacy attribute-routing pattern, emit ``DeviceEvents.UPDATE``
+        directly with ``entity_id`` and an ``update`` dict instead.
+        """
+        self.events.emit(DeviceEvents.UPDATE)
+
     def update_config(self, **kwargs) -> bool:
         """
         Update device configuration attributes and persist changes.

{ucapi_framework-1.9.0b2 → ucapi_framework-1.9.0b3}/ucapi_framework.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ucapi-framework
-Version: 1.9.0b2
+Version: 1.9.0b3
 Summary: ucapi framework that provides core functionality for building integrations.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown