lifx-async 4.7.0__tar.gz → 4.7.2__tar.gz

{lifx_async-4.7.0 → lifx_async-4.7.2}/.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.0 → lifx_async-4.7.2}/.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.0 → lifx_async-4.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lifx-async
-Version: 4.7.0
+Version: 4.7.2
 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.0 → lifx_async-4.7.2}/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.0 → lifx_async-4.7.2}/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.0 → lifx_async-4.7.2}/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.0 → lifx_async-4.7.2}/docs/changelog.md

@@ -2,6 +2,27 @@
 
 <!-- version list -->
 
+## 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
+
+- **devices**: Add length parameter to copy_frame_buffer()
+  ([`6a74690`](https://github.com/Djelibeybi/lifx-async/commit/6a746904665d38545e534829c2c690a61e48da54))
+
+
 ## v4.7.0 (2025-12-13)
 
 ### Features

{lifx_async-4.7.0 → lifx_async-4.7.2}/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.0 → lifx_async-4.7.2}/pyproject.toml

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

{lifx_async-4.7.0 → lifx_async-4.7.2}/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.0 → lifx_async-4.7.2}/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__)
 
 

{lifx_async-4.7.0 → lifx_async-4.7.2}/src/lifx/devices/matrix.py

@@ -699,6 +699,7 @@ class MatrixLight(Light):
         source_fb: int = 1,
         target_fb: int = 0,
         duration: float = 0.0,
+        length: int = 1,
     ) -> None:
         """Copy frame buffer (for tiles with >64 zones).
 
@@ -710,6 +711,7 @@ class MatrixLight(Light):
             source_fb: Source frame buffer index (usually 1)
             target_fb: Target frame buffer index (usually 0)
             duration: time in seconds to transition if target_fb is 0
+            length: Number of tiles to update starting from tile_index (default 1)
 
         Example:
             >>> # For 16x8 tile (128 zones):
@@ -739,12 +741,18 @@ class MatrixLight(Light):
             >>> await matrix.copy_frame_buffer(
             ...     tile_index=0, source_fb=1, target_fb=0, duration=2.0
             ... )
+
+            >>> # For a chain of 5 tiles, update all simultaneously:
+            >>> await matrix.copy_frame_buffer(
+            ...     tile_index=0, source_fb=1, target_fb=0, length=5
+            ... )
         """
         _LOGGER.debug(
-            "Copying frame buffer %d -> %d for tile %d on %s",
+            "Copying frame buffer %d -> %d for tile %d (length=%d) on %s",
             source_fb,
             target_fb,
             tile_index,
+            length,
             self.label or self.serial,
         )
 
@@ -761,7 +769,7 @@ class MatrixLight(Light):
         await self.connection.send_packet(
             packets.Tile.CopyFrameBuffer(
                 tile_index=tile_index,
-                length=1,
+                length=length,
                 src_fb_index=source_fb,
                 dst_fb_index=target_fb,
                 src_x=0,

{lifx_async-4.7.0 → lifx_async-4.7.2}/tests/test_devices/test_matrix.py

@@ -373,6 +373,37 @@ class TestMatrixLight:
             assert copied_colors[0].saturation == 1.0
             assert copied_colors[0].brightness == 1.0
 
+    async def test_copy_frame_buffer_with_length(self, emulator_devices) -> None:
+        """Test copy_frame_buffer() with explicit length parameter."""
+        matrix = emulator_devices[6]
+        async with matrix:
+            chain = await matrix.get_device_chain()
+            tile = chain[0]
+
+            # Set pattern on temp buffer (fb_index=1)
+            blue_colors = [Colors.BLUE] * 64
+            await matrix.set64(
+                tile_index=0,
+                length=1,
+                x=0,
+                y=0,
+                width=tile.width,
+                duration=0,
+                colors=blue_colors,
+                fb_index=1,
+            )
+
+            # Copy with explicit length=1 (same as default behavior)
+            await matrix.copy_frame_buffer(
+                tile_index=0, source_fb=1, target_fb=0, length=1
+            )
+
+            # Verify the copy worked
+            copied_colors = await matrix.get64()
+            assert copied_colors[0].hue == 240  # Blue
+            assert copied_colors[0].saturation == 1.0
+            assert copied_colors[0].brightness == 1.0
+
     async def test_set_effect_without_palette(self, emulator_devices) -> None:
         """Test setting effect without a palette (palette_count=0)."""
         matrix = emulator_devices[6]

{lifx_async-4.7.0 → lifx_async-4.7.2}/tests/test_devices/test_state_hev.py

@@ -217,6 +217,7 @@ class TestHevLightStateManagement:
         assert hev_light._state is None
         await hev_light.refresh_state()  # type: ignore
         assert isinstance(hev_light.state, HevLightState)
+        await hev_light.close()
 
 
 class TestHevAcknowledgementBasedStateUpdates:

{lifx_async-4.7.0 → lifx_async-4.7.2}/tests/test_devices/test_state_infrared.py

@@ -149,6 +149,7 @@ class TestInfraredLightStateManagement:
         assert infrared_light._state is None
         await infrared_light.refresh_state()  # type: ignore
         assert isinstance(infrared_light.state, InfraredLightState)
+        await infrared_light.close()
 
 
 class TestInfraredAcknowledgementBasedStateUpdates:

{lifx_async-4.7.0 → lifx_async-4.7.2}/uv.lock

@@ -337,7 +337,7 @@ wheels = [
 
 [[package]]
 name = "lifx-async"
-version = "4.7.0"
+version = "4.7.2"
 source = { editable = "." }
 
 [package.dev-dependencies]