lifx-async 4.7.2__py3-none-any.whl → 4.7.3__py3-none-any.whl

lifx/devices/ceiling.py

@@ -619,6 +619,65 @@ class CeilingLight(MatrixLight):
             determined_colors = await self._determine_downlight_brightness()
             await self.set_downlight_colors(determined_colors, duration)
 
+    async def set_power(self, level: bool | int, duration: float = 0.0) -> None:
+        """Set light power state, capturing component colors before turning off.
+
+        Overrides Light.set_power() to capture the current uplight and downlight
+        colors before turning off the entire light. This allows subsequent calls
+        to turn_uplight_on() or turn_downlight_on() to restore the colors that
+        were active just before the light was turned off.
+
+        The captured colors preserve hue, saturation, and kelvin values even if
+        a component was already off (brightness=0). The brightness will be
+        determined at turn-on time using the standard brightness inference logic.
+
+        Args:
+            level: True/65535 to turn on, False/0 to turn off
+            duration: Transition duration in seconds (default 0.0)
+
+        Raises:
+            ValueError: If integer value is not 0 or 65535
+            LifxDeviceNotFoundError: If device is not connected
+            LifxTimeoutError: If device does not respond
+            LifxUnsupportedCommandError: If device doesn't support this command
+
+        Example:
+            ```python
+            # Turn off entire ceiling light (captures colors for later)
+            await ceiling.set_power(False)
+
+            # Later, turn on just the uplight with its previous color
+            await ceiling.turn_uplight_on()
+
+            # Or turn on just the downlight with its previous colors
+            await ceiling.turn_downlight_on()
+            ```
+        """
+        # Determine if we're turning off
+        if isinstance(level, bool):
+            turning_off = not level
+        elif isinstance(level, int):
+            if level not in (0, 65535):
+                raise ValueError(f"Power level must be 0 or 65535, got {level}")
+            turning_off = level == 0
+        else:
+            raise TypeError(f"Expected bool or int, got {type(level).__name__}")
+
+        # If turning off, capture current colors for both components
+        if turning_off:
+            # Always capture colors - even if brightness is 0, the hue/sat/kelvin
+            # are still useful for turn_on. Brightness will be determined at
+            # turn-on time using the standard inference logic.
+            self._stored_uplight_state = await self.get_uplight_color()
+            self._stored_downlight_state = await self.get_downlight_colors()
+
+            # Persist if enabled
+            if self._state_file:
+                self._save_state_to_file()
+
+        # Call parent to perform actual power change
+        await super().set_power(level, duration)
+
     async def turn_downlight_off(
         self, colors: HSBK | list[HSBK] | None = None, duration: float = 0.0
     ) -> None:

{lifx_async-4.7.2.dist-info → lifx_async-4.7.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lifx-async
-Version: 4.7.2
+Version: 4.7.3
 Summary: A modern, type-safe, async Python library for controlling LIFX lights
 Author-email: Avi Miller <me@dje.li>
 Maintainer-email: Avi Miller <me@dje.li>

{lifx_async-4.7.2.dist-info → lifx_async-4.7.3.dist-info}/RECORD

@@ -6,7 +6,7 @@ lifx/exceptions.py,sha256=pikAMppLn7gXyjiQVWM_tSvXKNh-g366nG_UWyqpHhc,815
 lifx/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lifx/devices/__init__.py,sha256=4b5QtO0EFWxIqN2lUYgM8uLjWyHI5hUcReiF9QCjCGw,1061
 lifx/devices/base.py,sha256=0G2PCJRNeIPkMCIw68x0ijn6gUIwh2jFlex8SN4Hs1Y,63530
-lifx/devices/ceiling.py,sha256=3tHk-SklJNtSYJhnzqxqQKhdDEq9VWzK2mYEjf2P-Xc,33044
+lifx/devices/ceiling.py,sha256=q1aVqnYA0C32-c2J6GaYriaqgam9pKkSvV8IVVsIOf0,35661
 lifx/devices/hev.py,sha256=T5hvt2q_vdgPBvThx_-M7n5pZu9pL0y9Fs3Zz_KL0NM,15588
 lifx/devices/infrared.py,sha256=ePk9qxX_s-hv5gQMvio1Vv8FYiCd68HF0ySbWgSrvuU,8130
 lifx/devices/light.py,sha256=gk92lhViUWINGaxDWbs4qn8Stnn2fGCfRkC5Kk0Q-hI,34087
@@ -42,7 +42,7 @@ lifx/theme/canvas.py,sha256=4h7lgN8iu_OdchObGDgbxTqQLCb-FRKC-M-YCWef_i4,8048
 lifx/theme/generators.py,sha256=nq3Yvntq_h-eFHbmmow3LcAdA_hEbRRaP5mv9Bydrjk,6435
 lifx/theme/library.py,sha256=tKlKZNqJp8lRGDnilWyDm_Qr1vCRGGwuvWVS82anNpQ,21326
 lifx/theme/theme.py,sha256=qMEx_8E41C0Cc6f083XHiAXEglTv4YlXW0UFsG1rQKg,5521
-lifx_async-4.7.2.dist-info/METADATA,sha256=wb8Qr4I_4s40AlDRnG7589cnjZ4wE8SA9orSCizjoyA,2609
-lifx_async-4.7.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-lifx_async-4.7.2.dist-info/licenses/LICENSE,sha256=eBz48GRA3gSiWn3rYZAz2Ewp35snnhV9cSqkVBq7g3k,1832
-lifx_async-4.7.2.dist-info/RECORD,,
+lifx_async-4.7.3.dist-info/METADATA,sha256=SruPlVJQdCTtWKsJHzQDYpgJooaDxgfP2KiVF1XyPZY,2609
+lifx_async-4.7.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+lifx_async-4.7.3.dist-info/licenses/LICENSE,sha256=eBz48GRA3gSiWn3rYZAz2Ewp35snnhV9cSqkVBq7g3k,1832
+lifx_async-4.7.3.dist-info/RECORD,,