lifx-async 4.7.1__tar.gz → 4.7.3__tar.gz

{lifx_async-4.7.1 → lifx_async-4.7.3}/.github/workflows/ci.yml

@@ -96,7 +96,7 @@ jobs:
 
     - name: Upload coverage to Codecov
       if: matrix.os == 'ubuntu-latest'
-      uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5
+      uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de # v5
       with:
         env_vars: OS,PYTHON
         fail_ci_if_error: false
@@ -107,7 +107,7 @@ jobs:
 
     - name: Upload test results to Codecov
       if: matrix.os == 'ubuntu-latest'
-      uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5
+      uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de # v5
       with:
         env_vars: OS,PYTHON
         fail_ci_if_error: false
@@ -147,7 +147,7 @@ jobs:
       run: uv run --frozen pytest
 
     - name: Upload coverage to Codecov
-      uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5
+      uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de # v5
       with:
         fail_ci_if_error: false
         name: pytest-code-coverage-main
@@ -156,7 +156,7 @@ jobs:
         verbose: true
 
     - name: Upload test results to Codecov
-      uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5
+      uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de # v5
       with:
         fail_ci_if_error: false
         name: pytest-test-results-main
@@ -239,7 +239,7 @@ jobs:
 
     - name: Upload Distribution Artifacts
       if: github.event_name != 'workflow_dispatch'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
+      uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6
       with:
         name: distribution-artifacts
         path: dist
@@ -287,7 +287,7 @@ jobs:
 
     - name: Download Build Artifacts from workflow
       if: github.event_name != 'workflow_dispatch'
-      uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
+      uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7
       id: artifact-download
       with:
         name: distribution-artifacts

{lifx_async-4.7.1 → lifx_async-4.7.3}/.github/workflows/docs.yml

@@ -49,7 +49,7 @@ jobs:
 
     - name: Upload docs artifact
       if: github.event_name == 'pull_request'
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
+      uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6
       with:
         name: docs
         path: site/

{lifx_async-4.7.1 → lifx_async-4.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lifx-async
-Version: 4.7.1
+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.1 → lifx_async-4.7.3}/docs/api/devices.md

@@ -3,6 +3,87 @@
 Device classes provide direct control over LIFX devices. All device classes support async context
 managers for automatic resource cleanup.
 
+## State and Info Classes
+
+Device state and information dataclasses returned by device methods.
+
+### DeviceState
+
+Base device state dataclass returned by `Device.state`.
+
+::: lifx.devices.base.DeviceState
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
+### DeviceVersion
+
+Device version information returned by `Device.get_version()`.
+
+::: lifx.devices.base.DeviceVersion
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
+### DeviceInfo
+
+Device runtime information returned by `Device.get_info()`.
+
+::: lifx.devices.base.DeviceInfo
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
+### WifiInfo
+
+WiFi module information returned by `Device.get_wifi_info()`.
+
+::: lifx.devices.base.WifiInfo
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
+### FirmwareInfo
+
+Firmware version information returned by `Device.get_host_firmware()` and `Device.get_wifi_firmware()`.
+
+::: lifx.devices.base.FirmwareInfo
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
+### CollectionInfo
+
+Location and group collection information returned by `Device.get_location()` and `Device.get_group()`.
+
+::: lifx.devices.base.CollectionInfo
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
+### DeviceCapabilities
+
+Device capabilities from product registry, available via `Device.capabilities`.
+
+::: lifx.devices.base.DeviceCapabilities
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
 ## Base Device
 
 The `Device` class provides common operations available on all LIFX devices.
@@ -29,6 +110,17 @@ The `Light` class provides color control and effects for standard LIFX lights.
       filters:
         - "!^_"
 
+### LightState
+
+Light device state dataclass returned by `Light.state`.
+
+::: lifx.devices.light.LightState
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
 ## HEV Light
 
 The `HevLight` class extends `Light` with anti-bacterial cleaning cycle control for LIFX HEV devices.
@@ -42,6 +134,17 @@ The `HevLight` class extends `Light` with anti-bacterial cleaning cycle control
       filters:
         - "!^_"
 
+### HevLightState
+
+HEV light device state dataclass returned by `HevLight.state`.
+
+::: lifx.devices.hev.HevLightState
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
 ## Infrared Light
 
 The `InfraredLight` class extends `Light` with infrared LED control for night vision on LIFX A19 + Night Vision devices.
@@ -55,6 +158,17 @@ The `InfraredLight` class extends `Light` with infrared LED control for night vi
       filters:
         - "!^_"
 
+### InfraredLightState
+
+Infrared light device state dataclass returned by `InfraredLight.state`.
+
+::: lifx.devices.infrared.InfraredLightState
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
 ## MultiZone Light
 
 The `MultiZoneLight` class controls LIFX strips and beams with multiple color zones.
@@ -68,6 +182,30 @@ The `MultiZoneLight` class controls LIFX strips and beams with multiple color zo
       filters:
         - "!^_"
 
+### MultiZoneLightState
+
+MultiZone light device state dataclass returned by `MultiZoneLight.state`.
+
+::: lifx.devices.multizone.MultiZoneLightState
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
+### MultiZoneEffect
+
+Configuration dataclass for multizone effects (MOVE). Used with `MultiZoneLight.set_effect()` and returned by `MultiZoneLight.get_effect()`.
+
+::: lifx.devices.multizone.MultiZoneEffect
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+      filters:
+        - "!^_"
+
 ## Matrix Light
 
 The `MatrixLight` class controls LIFX matrix devices (tiles, candle, path) with 2D zone control.
@@ -81,6 +219,43 @@ The `MatrixLight` class controls LIFX matrix devices (tiles, candle, path) with
       filters:
         - "!^_"
 
+### MatrixLightState
+
+Matrix light device state dataclass returned by `MatrixLight.state`.
+
+::: lifx.devices.matrix.MatrixLightState
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
+### TileInfo
+
+Information dataclass for a single tile in the device chain. Returned as part of `MatrixLightState.chain`.
+
+::: lifx.devices.matrix.TileInfo
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+      filters:
+        - "!^_"
+
+### MatrixEffect
+
+Configuration dataclass for matrix effects (MORPH, FLAME, SKY). Used with `MatrixLight.set_effect()` and returned by `MatrixLight.get_effect()`.
+
+::: lifx.devices.matrix.MatrixEffect
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+      filters:
+        - "!^_"
+
 ## Ceiling Light
 
 The `CeilingLight` class extends `MatrixLight` with independent control over uplight and downlight components for LIFX Ceiling fixtures.

{lifx_async-4.7.1 → lifx_async-4.7.3}/docs/api/high-level.md

@@ -34,6 +34,32 @@ recommended entry points for most users.
       members_order: source
       show_if_no_docstring: false
 
+## Organizational Groupings
+
+Dataclasses for organizing devices by location or group. Returned by `DeviceGroup.organize_by_location()` and `DeviceGroup.organize_by_group()`.
+
+### LocationGrouping
+
+Location-based device grouping returned by `DeviceGroup.organize_by_location()`.
+
+::: lifx.api.LocationGrouping
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
+### GroupGrouping
+
+Group-based device grouping returned by `DeviceGroup.organize_by_group()`.
+
+::: lifx.api.GroupGrouping
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
 ## Examples
 
 ### Simple Discovery

{lifx_async-4.7.1 → lifx_async-4.7.3}/docs/api/network.md

@@ -18,6 +18,17 @@ Functions for discovering LIFX devices on the local network.
       heading_level: 3
       members_order: source
 
+### DiscoveryResponse
+
+Response dataclass from custom discovery broadcasts (using packets other than GetService).
+
+::: lifx.network.discovery.DiscoveryResponse
+    options:
+      show_root_heading: true
+      heading_level: 4
+      members_order: source
+      show_if_no_docstring: false
+
 ## UDP Transport
 
 Low-level UDP transport for sending and receiving LIFX protocol messages.

{lifx_async-4.7.1 → lifx_async-4.7.3}/docs/changelog.md

@@ -2,6 +2,27 @@
 
 <!-- version list -->
 
+## v4.7.3 (2025-12-16)
+
+### Bug Fixes
+
+- **devices**: Capture component colors before set_power turns off light
+  ([`a99abee`](https://github.com/Djelibeybi/lifx-async/commit/a99abeeeb4f6cad1e49410204b8e7a567765b3ed))
+
+
+## v4.7.2 (2025-12-16)
+
+### Bug Fixes
+
+- **api**: Close device connections in DeviceGroup context manager
+  ([`054bfee`](https://github.com/Djelibeybi/lifx-async/commit/054bfee88e548d38c1e7c49277d3bb334b55adcc))
+
+### Documentation
+
+- **api**: Add dataclass documentation and improve navigation
+  ([`c859c87`](https://github.com/Djelibeybi/lifx-async/commit/c859c8711335bdf5357412ccf4364075ce0df535))
+
+
 ## v4.7.1 (2025-12-13)
 
 ### Bug Fixes

{lifx_async-4.7.1 → lifx_async-4.7.3}/mkdocs.yml

@@ -25,19 +25,16 @@ theme:
       icon: material/brightness-4
       name: Switch to light mode
   features:
-  - navigation.instant
   - navigation.tracking
   - navigation.tabs
   - navigation.tabs.sticky
   - navigation.sections
-  - navigation.expand
   - navigation.path
   - navigation.indexes
+  - navigation.top
   - toc.follow
-  - toc.integrate
   - search.suggest
   - search.highlight
-  - search.share
   - content.code.copy
   - content.code.annotate
   - content.tabs.link

{lifx_async-4.7.1 → lifx_async-4.7.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lifx-async"
-version = "4.7.1"
+version = "4.7.3"
 description = "A modern, type-safe, async Python library for controlling LIFX lights"
 readme = "README.md"
 requires-python = ">=3.11"

{lifx_async-4.7.1 → lifx_async-4.7.3}/src/lifx/api.py

@@ -126,8 +126,9 @@ class DeviceGroup:
         exc_val: BaseException | None,
         exc_tb: TracebackType | None,
     ) -> None:
-        """Exit async context manager."""
-        pass
+        """Exit async context manager and close all device connections."""
+        for device in self._devices:
+            await device.connection.close()
 
     def __iter__(
         self,

{lifx_async-4.7.1 → lifx_async-4.7.3}/src/lifx/devices/ceiling.py

@@ -23,16 +23,13 @@ import logging
 import time
 from dataclasses import asdict, dataclass
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, cast
+from typing import Any, cast
 
 from lifx.color import HSBK
 from lifx.devices.matrix import MatrixLight, MatrixLightState
 from lifx.exceptions import LifxError
 from lifx.products import get_ceiling_layout, is_ceiling_product
 
-if TYPE_CHECKING:
-    pass
-
 _LOGGER = logging.getLogger(__name__)
 
 
@@ -622,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: