lifx-async 4.9.0__tar.gz → 5.0.0__tar.gz

{lifx_async-4.9.0 → lifx_async-5.0.0}/.github/workflows/ci.yml

@@ -40,7 +40,7 @@ jobs:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@681c641aba71e4a1c380be3ab5e12ad51f415867 # v7
+      uses: astral-sh/setup-uv@61cb8a9741eeb8a550a1b8544337180c0fc8476b # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -82,7 +82,7 @@ jobs:
         python-version: ${{ matrix.python-version }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@681c641aba71e4a1c380be3ab5e12ad51f415867 # v7
+      uses: astral-sh/setup-uv@61cb8a9741eeb8a550a1b8544337180c0fc8476b # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ matrix.python-version }}
@@ -134,7 +134,7 @@ jobs:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@681c641aba71e4a1c380be3ab5e12ad51f415867   # v7
+      uses: astral-sh/setup-uv@61cb8a9741eeb8a550a1b8544337180c0fc8476b   # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -198,7 +198,7 @@ jobs:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@681c641aba71e4a1c380be3ab5e12ad51f415867 # v7
+      uses: astral-sh/setup-uv@61cb8a9741eeb8a550a1b8544337180c0fc8476b # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}

{lifx_async-4.9.0 → lifx_async-5.0.0}/.github/workflows/docs.yml

@@ -35,7 +35,7 @@ jobs:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@681c641aba71e4a1c380be3ab5e12ad51f415867 # v7
+      uses: astral-sh/setup-uv@61cb8a9741eeb8a550a1b8544337180c0fc8476b # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -69,7 +69,7 @@ jobs:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@681c641aba71e4a1c380be3ab5e12ad51f415867 # v7
+      uses: astral-sh/setup-uv@61cb8a9741eeb8a550a1b8544337180c0fc8476b # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -97,7 +97,7 @@ jobs:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@681c641aba71e4a1c380be3ab5e12ad51f415867 # v7
+      uses: astral-sh/setup-uv@61cb8a9741eeb8a550a1b8544337180c0fc8476b # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}

{lifx_async-4.9.0 → lifx_async-5.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lifx-async
-Version: 4.9.0
+Version: 5.0.0
 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>
@@ -11,6 +11,7 @@ Classifier: Framework :: Pytest
 Classifier: Intended Audience :: Developers
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
@@ -18,7 +19,7 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
-Requires-Python: >=3.11
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 
 # lifx-async

{lifx_async-4.9.0 → lifx_async-5.0.0}/docs/changelog.md

@@ -2,6 +2,19 @@
 
 <!-- version list -->
 
+## v5.0.0 (2026-01-12)
+
+### Features
+
+- Add Python 3.10 support
+  ([`7c39131`](https://github.com/Djelibeybi/lifx-async/commit/7c391314305bb856d8bbcd23a5e481b729a5ad04))
+
+### Breaking Changes
+
+- Batch operations now raise first exception immediately (asyncio.gather behavior) instead of
+  collecting all exceptions into an ExceptionGroup (TaskGroup behavior).
+
+
 ## v4.9.0 (2025-12-30)
 
 ### Features

{lifx_async-4.9.0 → lifx_async-5.0.0}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "lifx-async"
-version = "4.9.0"
+version = "5.0.0"
 description = "A modern, type-safe, async Python library for controlling LIFX lights"
 readme = "README.md"
-requires-python = ">=3.11"
+requires-python = ">=3.10"
 dependencies = []
 license = "UPL-1.0"
 license-files = ["LICENSE"]
@@ -19,6 +19,7 @@ classifiers = [
     "Intended Audience :: Developers",
     "Natural Language :: English",
     "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
@@ -31,7 +32,7 @@ classifiers = [
 [dependency-groups]
 dev = [
     "hatchling>=1.27.0",
-    "lifx-emulator-core>=3.0.3",
+    "lifx-emulator-core>=3.1.0",
     "mkdocs-git-revision-date-localized-plugin>=1.4.7",
     "mkdocs-llmstxt>=0.4.0",
     "mkdocs-material>=9.6.22",
@@ -44,6 +45,7 @@ dev = [
     "pytest-sugar>=1.1.1",
     "pyyaml>=6.0.3",
     "ruff>=0.14.2",
+    "typing-extensions>=4.15.0",
 ]
 
 [build-system]
@@ -56,7 +58,7 @@ packages = ["src/lifx"]
 [tool.ruff]
 line-length = 88
 indent-width = 4
-target-version = "py311"
+target-version = "py310"
 
 [tool.ruff.format]
 quote-style = "double"
@@ -72,10 +74,11 @@ ignore = []
 "src/lifx/{protocol,products}/generator.py" = ["E501"]
 "src/lifx/protocol/packets.py" = ["E501"]
 "src/lifx/products/registry.py" = ["E501"]
+"benchmarks/*.py" = ["E501"]
 
 [tool.pyright]
 typeCheckingMode = "standard"
-pythonVersion = "3.11"
+pythonVersion = "3.10"
 include = ["src"]
 exclude = [
     "**/__pycache__",

{lifx_async-4.9.0 → lifx_async-5.0.0}/src/lifx/api.py

@@ -198,9 +198,7 @@ class DeviceGroup:
             await group.set_power(True, duration=1.0)
             ```
         """
-        async with asyncio.TaskGroup() as tg:
-            for light in self.lights:
-                tg.create_task(light.set_power(on, duration))
+        await asyncio.gather(*(light.set_power(on, duration) for light in self.lights))
 
     async def set_color(self, color: HSBK, duration: float = 0.0) -> None:
         """Set color for all Light devices in the group.
@@ -218,9 +216,9 @@ class DeviceGroup:
             await group.set_color(HSBK.from_rgb(255, 0, 0), duration=2.0)
             ```
         """
-        async with asyncio.TaskGroup() as tg:
-            for light in self.lights:
-                tg.create_task(light.set_color(color, duration))
+        await asyncio.gather(
+            *(light.set_color(color, duration) for light in self.lights)
+        )
 
     async def set_brightness(self, brightness: float, duration: float = 0.0) -> None:
         """Set brightness for all Light devices in the group.
@@ -238,9 +236,9 @@ class DeviceGroup:
             await group.set_brightness(0.5, duration=1.0)
             ```
         """
-        async with asyncio.TaskGroup() as tg:
-            for light in self.lights:
-                tg.create_task(light.set_brightness(brightness, duration))
+        await asyncio.gather(
+            *(light.set_brightness(brightness, duration) for light in self.lights)
+        )
 
     async def pulse(
         self, color: HSBK, period: float = 1.0, cycles: float = 1.0
@@ -261,9 +259,9 @@ class DeviceGroup:
             await group.pulse(Colors.RED, period=1.0, cycles=1.0)
             ```
         """
-        async with asyncio.TaskGroup() as tg:
-            for light in self.lights:
-                tg.create_task(light.pulse(color, period, cycles))
+        await asyncio.gather(
+            *(light.pulse(color, period, cycles) for light in self.lights)
+        )
 
     # Location and Group Organization Methods
 
@@ -280,14 +278,13 @@ class DeviceGroup:
         )
 
         # Fetch all location info concurrently
-        tasks: dict[str, asyncio.Task[CollectionInfo | None]] = {}
-        async with asyncio.TaskGroup() as tg:
-            for device in self._devices:
-                tasks[device.serial] = tg.create_task(device.get_location())
+        location_results = await asyncio.gather(
+            *(device.get_location() for device in self._devices)
+        )
 
-        results: list[tuple[Device, CollectionInfo | None]] = []
-        for device in self._devices:
-            results.append((device, tasks[device.serial].result()))
+        results: list[tuple[Device, CollectionInfo | None]] = list(
+            zip(self._devices, location_results)
+        )
 
         # Group by location UUID
         for device, location_info in results:
@@ -332,15 +329,14 @@ class DeviceGroup:
         # Collect group info from all devices concurrently
         group_data: dict[str, list[tuple[Device, CollectionInfo]]] = defaultdict(list)
 
-        tasks: dict[str, asyncio.Task[CollectionInfo | None]] = {}
-        async with asyncio.TaskGroup() as tg:
-            for device in self._devices:
-                tasks[device.serial] = tg.create_task(device.get_group())
-
         # Fetch all group info concurrently
-        results: list[tuple[Device, CollectionInfo | None]] = []
-        for device in self._devices:
-            results.append((device, tasks[device.serial].result()))
+        group_results = await asyncio.gather(
+            *(device.get_group() for device in self._devices)
+        )
+
+        results: list[tuple[Device, CollectionInfo | None]] = list(
+            zip(self._devices, group_results)
+        )
 
         # Group by group UUID
         for device, group_info in results:
@@ -712,18 +708,20 @@ class DeviceGroup:
             await group.apply_theme(evening, power_on=True, duration=1.0)
             ```
         """
-        async with asyncio.TaskGroup() as tg:
+        await asyncio.gather(
             # Apply theme to all lights
-            for light in self.lights:
-                tg.create_task(light.apply_theme(theme, power_on, duration))
-
+            *(light.apply_theme(theme, power_on, duration) for light in self.lights),
             # Apply theme to all multizone lights
-            for multizone in self.multizone_lights:
-                tg.create_task(multizone.apply_theme(theme, power_on, duration))
-
+            *(
+                multizone.apply_theme(theme, power_on, duration)
+                for multizone in self.multizone_lights
+            ),
             # Apply theme to all matrix light devices
-            for matrix in self.matrix_lights:
-                tg.create_task(matrix.apply_theme(theme, power_on, duration))
+            *(
+                matrix.apply_theme(theme, power_on, duration)
+                for matrix in self.matrix_lights
+            ),
+        )
 
     def invalidate_metadata_cache(self) -> None:
         """Clear all cached location and group metadata.

{lifx_async-4.9.0 → lifx_async-5.0.0}/src/lifx/devices/base.py

@@ -9,7 +9,7 @@ import time
 import uuid
 from dataclasses import dataclass, field
 from math import floor, log10
-from typing import TYPE_CHECKING, Generic, Self, TypeVar, cast
+from typing import TYPE_CHECKING, Generic, TypeVar, cast
 
 from lifx.const import (
     DEFAULT_MAX_RETRIES,
@@ -26,6 +26,8 @@ from lifx.protocol import packets
 from lifx.protocol.models import Serial
 
 if TYPE_CHECKING:
+    from typing_extensions import Self
+
     from lifx.devices import (
         CeilingLight,
         HevLight,
@@ -681,12 +683,13 @@ class Device(Generic[StateT]):
     async def _setup(self) -> None:
         """Populate device capabilities, state and metadata."""
         await self._ensure_capabilities()
-        async with asyncio.TaskGroup() as tg:
-            tg.create_task(self.get_host_firmware())
-            tg.create_task(self.get_wifi_firmware())
-            tg.create_task(self.get_label())
-            tg.create_task(self.get_location())
-            tg.create_task(self.get_group())
+        await asyncio.gather(
+            self.get_host_firmware(),
+            self.get_wifi_firmware(),
+            self.get_label(),
+            self.get_location(),
+            self.get_group(),
+        )
 
     async def get_mac_address(self) -> str:
         """Calculate and return the MAC address for this device."""
@@ -1669,21 +1672,21 @@ class Device(Generic[StateT]):
 
         # Fetch semi-static and volatile state in parallel
         # get_color returns color, power, and label in one request
-        async with asyncio.TaskGroup() as tg:
-            label_task = tg.create_task(self.get_label())
-            power_task = tg.create_task(self.get_power())
-            host_fw_task = tg.create_task(self.get_host_firmware())
-            wifi_fw_task = tg.create_task(self.get_wifi_firmware())
-            location_task = tg.create_task(self.get_location())
-            group_task = tg.create_task(self.get_group())
-
-        # Extract results
-        label = label_task.result()
-        power = power_task.result()
-        host_firmware = host_fw_task.result()
-        wifi_firmware = wifi_fw_task.result()
-        location_info = location_task.result()
-        group_info = group_task.result()
+        (
+            label,
+            power,
+            host_firmware,
+            wifi_firmware,
+            location_info,
+            group_info,
+        ) = await asyncio.gather(
+            self.get_label(),
+            self.get_power(),
+            self.get_host_firmware(),
+            self.get_wifi_firmware(),
+            self.get_location(),
+            self.get_group(),
+        )
 
         # Get MAC address (already calculated in get_host_firmware)
         mac_address = await self.get_mac_address()

{lifx_async-4.9.0 → lifx_async-5.0.0}/src/lifx/devices/hev.py

@@ -119,10 +119,11 @@ class HevLight(Light):
     async def _setup(self) -> None:
         """Populate HEV light capabilities, state and metadata."""
         await super()._setup()
-        async with asyncio.TaskGroup() as tg:
-            tg.create_task(self.get_hev_config())
-            tg.create_task(self.get_hev_cycle())
-            tg.create_task(self.get_last_hev_result())
+        await asyncio.gather(
+            self.get_hev_config(),
+            self.get_hev_cycle(),
+            self.get_last_hev_result(),
+        )
 
     async def get_hev_cycle(self) -> HevCycleState:
         """Get current HEV cycle state.
@@ -413,12 +414,10 @@ class HevLight(Light):
         await super().refresh_state()
 
         # Fetch all HEV light state
-        async with asyncio.TaskGroup() as tg:
-            hev_cycle_task = tg.create_task(self.get_hev_cycle())
-            hev_result_task = tg.create_task(self.get_last_hev_result())
-
-        hev_cycle = hev_cycle_task.result()
-        hev_result = hev_result_task.result()
+        hev_cycle, hev_result = await asyncio.gather(
+            self.get_hev_cycle(),
+            self.get_last_hev_result(),
+        )
 
         self._state.hev_cycle = hev_cycle
         self._state.hev_result = hev_result
@@ -440,14 +439,11 @@ class HevLight(Light):
 
         # Fetch semi-static and volatile state in parallel
         # get_color returns color, power, and label in one request
-        async with asyncio.TaskGroup() as tg:
-            hev_cycle_task = tg.create_task(self.get_hev_cycle())
-            hev_config_task = tg.create_task(self.get_hev_config())
-            hev_result_task = tg.create_task(self.get_last_hev_result())
-
-        hev_cycle = hev_cycle_task.result()
-        hev_config = hev_config_task.result()
-        hev_result = hev_result_task.result()
+        hev_cycle, hev_config, hev_result = await asyncio.gather(
+            self.get_hev_cycle(),
+            self.get_hev_config(),
+            self.get_last_hev_result(),
+        )
 
         # Create state instance with HEV fields
         self._state = HevLightState.from_light_state(

{lifx_async-4.9.0 → lifx_async-5.0.0}/src/lifx/devices/light.py

@@ -964,19 +964,19 @@ class Light(Device[LightState]):
         # Fetch semi-static and volatile state in parallel
         # get_color returns color, power, and label in one request
         try:
-            async with asyncio.TaskGroup() as tg:
-                color_task = tg.create_task(self.get_color())
-                host_fw_task = tg.create_task(self.get_host_firmware())
-                wifi_fw_task = tg.create_task(self.get_wifi_firmware())
-                location_task = tg.create_task(self.get_location())
-                group_task = tg.create_task(self.get_group())
-
-            # Extract results
-            color, power, label = color_task.result()
-            host_firmware = host_fw_task.result()
-            wifi_firmware = wifi_fw_task.result()
-            location_info = location_task.result()
-            group_info = group_task.result()
+            (
+                (color, power, label),
+                host_firmware,
+                wifi_firmware,
+                location_info,
+                group_info,
+            ) = await asyncio.gather(
+                self.get_color(),
+                self.get_host_firmware(),
+                self.get_wifi_firmware(),
+                self.get_location(),
+                self.get_group(),
+            )
 
             # Get MAC address (already calculated in get_host_firmware)
             mac_address = await self.get_mac_address()
@@ -1003,7 +1003,7 @@ class Light(Device[LightState]):
 
             return self._state
 
-        except* LifxTimeoutError:
+        except LifxTimeoutError:
             raise LifxTimeoutError(f"Error initializing state for {self.serial}")
-        except* LifxError:
+        except LifxError:
             raise LifxError(f"Error initializing state for {self.serial}")

{lifx_async-4.9.0 → lifx_async-5.0.0}/src/lifx/devices/multizone.py

@@ -969,12 +969,10 @@ class MultiZoneLight(Light):
         """
         await super().refresh_state()
 
-        async with asyncio.TaskGroup() as tg:
-            zones_task = tg.create_task(self.get_all_color_zones())
-            effect_task = tg.create_task(self.get_effect())
-
-        zones = zones_task.result()
-        effect = effect_task.result()
+        zones, effect = await asyncio.gather(
+            self.get_all_color_zones(),
+            self.get_effect(),
+        )
 
         self._state.zones = zones
         self._state.effect = effect.effect_type
@@ -994,12 +992,10 @@ class MultiZoneLight(Light):
         """
         light_state = await super()._initialize_state()
 
-        async with asyncio.TaskGroup() as tg:
-            zones_task = tg.create_task(self.get_all_color_zones())
-            effect_task = tg.create_task(self.get_effect())
-
-        zones = zones_task.result()
-        effect = effect_task.result()
+        zones, effect = await asyncio.gather(
+            self.get_all_color_zones(),
+            self.get_effect(),
+        )
 
         self._state = MultiZoneLightState.from_light_state(
             light_state=light_state, zones=zones, effect=effect.effect_type

{lifx_async-4.9.0 → lifx_async-5.0.0}/src/lifx/effects/base.py

@@ -85,22 +85,26 @@ class LIFXEffect(ABC):
         if self.power_on:
             needs_power_on = False
 
-            async def power_on_if_needed(light: Light) -> None:
-                """Power on a single light if it's currently off."""
-                nonlocal needs_power_on
+            async def power_on_if_needed(light: Light) -> bool:
+                """Power on a single light if it's currently off.
+
+                Returns True if the light was powered on.
+                """
                 is_on = await light.get_power()
                 if not is_on:
-                    needs_power_on = True
                     # Get startup color for this light
                     startup_color = await self.from_poweroff_hsbk(light)
                     # Set color immediately, then power on
                     await light.set_color(startup_color, duration=0)
                     await light.set_power(True, duration=POWER_ON_TRANSITION_DURATION)
+                    return True
+                return False
 
             # Power on all lights concurrently
-            async with asyncio.TaskGroup() as tg:
-                for light in self.participants:
-                    tg.create_task(power_on_if_needed(light))
+            results = await asyncio.gather(
+                *(power_on_if_needed(light) for light in self.participants)
+            )
+            needs_power_on = any(results)
 
             # Wait for power transition to complete if any lights were powered on
             if needs_power_on:

{lifx_async-4.9.0 → lifx_async-5.0.0}/src/lifx/effects/colorloop.py

@@ -353,17 +353,11 @@ class EffectColorloop(LIFXEffect):
             )
 
         # Fetch colors for all lights concurrently
-        colors: list[HSBK] = [None] * len(self.participants)  # type: ignore
-
-        async with asyncio.TaskGroup() as tg:
-            for idx, light in enumerate(self.participants):
-
-                async def fetch_and_store(index: int, device: Light) -> None:
-                    colors[index] = await get_color_for_light(device)
-
-                tg.create_task(fetch_and_store(idx, light))
+        colors = await asyncio.gather(
+            *(get_color_for_light(light) for light in self.participants)
+        )
 
-        return colors
+        return list(colors)
 
     async def from_poweroff_hsbk(self, _light: Light) -> HSBK:
         """Return startup color when light is powered off.