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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lifx-async
-Version: 4.8.0
+Version: 4.9.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>

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

@@ -2,6 +2,22 @@
 
 <!-- version list -->
 
+## v4.9.0 (2025-12-30)
+
+### Features
+
+- **api**: Add HTML named colors and kelvin temperature presets
+  ([`b631d43`](https://github.com/Djelibeybi/lifx-async/commit/b631d43f9ba61db5f77e233a6bc0745bb3fed8b8))
+
+
+## v4.8.1 (2025-12-24)
+
+### Bug Fixes
+
+- Tighten up the URL parsing to be even more specific
+  ([`0222362`](https://github.com/Djelibeybi/lifx-async/commit/0222362ace8d7c8bbbe7d5a50f9fb21b7cb89cd5))
+
+
 ## v4.8.0 (2025-12-20)
 
 ### Features

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

@@ -1,6 +1,6 @@
 [project]
 name = "lifx-async"
-version = "4.8.0"
+version = "4.9.0"
 description = "A modern, type-safe, async Python library for controlling LIFX lights"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -40,6 +40,7 @@ dev = [
     "pytest>=8.4.2",
     "pytest-asyncio>=0.24.0",
     "pytest-cov>=7.0.0",
+    "pytest-retry>=1.7.0",
     "pytest-sugar>=1.1.1",
     "pyyaml>=6.0.3",
     "ruff>=0.14.2",

{lifx_async-4.8.0 → lifx_async-4.9.0}/src/lifx/color.py

@@ -10,9 +10,23 @@ import colorsys
 import math
 
 from lifx.const import (
+    KELVIN_AMBER,
+    KELVIN_BLUE_DAYLIGHT,
+    KELVIN_BLUE_ICE,
+    KELVIN_BLUE_OVERCAST,
+    KELVIN_BRIGHT_DAYLIGHT,
+    KELVIN_CANDLELIGHT,
+    KELVIN_CLOUDY_DAYLIGHT,
     KELVIN_COOL,
+    KELVIN_COOL_DAYLIGHT,
     KELVIN_DAYLIGHT,
+    KELVIN_INCANDESCENT,
     KELVIN_NEUTRAL,
+    KELVIN_NEUTRAL_WARM,
+    KELVIN_NOON_DAYLIGHT,
+    KELVIN_SOFT_DAYLIGHT,
+    KELVIN_SUNSET,
+    KELVIN_ULTRA_WARM,
     KELVIN_WARM,
     MAX_BRIGHTNESS,
     MAX_HUE,
@@ -520,34 +534,220 @@ class HSBK:
 
 # Common color presets
 class Colors:
-    """Common color presets for convenience."""
-
-    # Primary colors
-    RED = HSBK(hue=0, saturation=1.0, brightness=1.0, kelvin=KELVIN_NEUTRAL)
-    ORANGE = HSBK(hue=30, saturation=1.0, brightness=1.0, kelvin=KELVIN_NEUTRAL)
-    YELLOW = HSBK(hue=60, saturation=1.0, brightness=1.0, kelvin=KELVIN_NEUTRAL)
-    GREEN = HSBK(hue=120, saturation=1.0, brightness=1.0, kelvin=KELVIN_NEUTRAL)
-    CYAN = HSBK(hue=180, saturation=1.0, brightness=1.0, kelvin=KELVIN_NEUTRAL)
-    BLUE = HSBK(hue=240, saturation=1.0, brightness=1.0, kelvin=KELVIN_NEUTRAL)
-    PURPLE = HSBK(hue=270, saturation=1.0, brightness=1.0, kelvin=KELVIN_NEUTRAL)
-    MAGENTA = HSBK(hue=300, saturation=1.0, brightness=1.0, kelvin=KELVIN_NEUTRAL)
-    PINK = HSBK(hue=330, saturation=1.0, brightness=1.0, kelvin=KELVIN_NEUTRAL)
-
-    # White variants
-    WHITE_WARM = HSBK(hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_WARM)
-    WHITE_NEUTRAL = HSBK(hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_NEUTRAL)
-    WHITE_COOL = HSBK(hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_COOL)
-    WHITE_DAYLIGHT = HSBK(hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_DAYLIGHT)
-
-    # Pastels
+    """Common color presets for convenience.
+
+    Includes all 140 standard HTML/CSS named colors plus white temperature
+    variants and pastel variations.
+
+    HTML color reference: https://www.w3.org/TR/css-color-3/#svg-color
+    """
+
+    # Off / Black (brightness=0 turns light off or sets zone to black)
+    OFF = HSBK(hue=0, saturation=0.0, brightness=0.0, kelvin=KELVIN_NEUTRAL)
+
+    # HTML Named Colors (alphabetical order)
+    ALICE_BLUE = HSBK.from_rgb(240, 248, 255)
+    ANTIQUE_WHITE = HSBK.from_rgb(250, 235, 215)
+    AQUA = HSBK.from_rgb(0, 255, 255)
+    AQUAMARINE = HSBK.from_rgb(127, 255, 212)
+    AZURE = HSBK.from_rgb(240, 255, 255)
+    BEIGE = HSBK.from_rgb(245, 245, 220)
+    BISQUE = HSBK.from_rgb(255, 228, 196)
+    BLACK = HSBK.from_rgb(0, 0, 0)
+    BLANCHED_ALMOND = HSBK.from_rgb(255, 235, 205)
+    BLUE = HSBK.from_rgb(0, 0, 255)
+    BLUE_VIOLET = HSBK.from_rgb(138, 43, 226)
+    BROWN = HSBK.from_rgb(165, 42, 42)
+    BURLYWOOD = HSBK.from_rgb(222, 184, 135)
+    CADET_BLUE = HSBK.from_rgb(95, 158, 160)
+    CHARTREUSE = HSBK.from_rgb(127, 255, 0)
+    CHOCOLATE = HSBK.from_rgb(210, 105, 30)
+    CORAL = HSBK.from_rgb(255, 127, 80)
+    CORNFLOWER_BLUE = HSBK.from_rgb(100, 149, 237)
+    CORNSILK = HSBK.from_rgb(255, 248, 220)
+    CRIMSON = HSBK.from_rgb(220, 20, 60)
+    CYAN = HSBK.from_rgb(0, 255, 255)
+    DARK_BLUE = HSBK.from_rgb(0, 0, 139)
+    DARK_CYAN = HSBK.from_rgb(0, 139, 139)
+    DARK_GOLDENROD = HSBK.from_rgb(184, 134, 11)
+    DARK_GRAY = HSBK.from_rgb(169, 169, 169)
+    DARK_GREEN = HSBK.from_rgb(0, 100, 0)
+    DARK_GREY = HSBK.from_rgb(169, 169, 169)
+    DARK_KHAKI = HSBK.from_rgb(189, 183, 107)
+    DARK_MAGENTA = HSBK.from_rgb(139, 0, 139)
+    DARK_OLIVE_GREEN = HSBK.from_rgb(85, 107, 47)
+    DARK_ORANGE = HSBK.from_rgb(255, 140, 0)
+    DARK_ORCHID = HSBK.from_rgb(153, 50, 204)
+    DARK_RED = HSBK.from_rgb(139, 0, 0)
+    DARK_SALMON = HSBK.from_rgb(233, 150, 122)
+    DARK_SEA_GREEN = HSBK.from_rgb(143, 188, 143)
+    DARK_SLATE_BLUE = HSBK.from_rgb(72, 61, 139)
+    DARK_SLATE_GRAY = HSBK.from_rgb(47, 79, 79)
+    DARK_SLATE_GREY = HSBK.from_rgb(47, 79, 79)
+    DARK_TURQUOISE = HSBK.from_rgb(0, 206, 209)
+    DARK_VIOLET = HSBK.from_rgb(148, 0, 211)
+    DEEP_PINK = HSBK.from_rgb(255, 20, 147)
+    DEEP_SKY_BLUE = HSBK.from_rgb(0, 191, 255)
+    DIM_GRAY = HSBK.from_rgb(105, 105, 105)
+    DIM_GREY = HSBK.from_rgb(105, 105, 105)
+    DODGER_BLUE = HSBK.from_rgb(30, 144, 255)
+    FIREBRICK = HSBK.from_rgb(178, 34, 34)
+    FLORAL_WHITE = HSBK.from_rgb(255, 250, 240)
+    FOREST_GREEN = HSBK.from_rgb(34, 139, 34)
+    FUCHSIA = HSBK.from_rgb(255, 0, 255)
+    GAINSBORO = HSBK.from_rgb(220, 220, 220)
+    GHOST_WHITE = HSBK.from_rgb(248, 248, 255)
+    GOLD = HSBK.from_rgb(255, 215, 0)
+    GOLDENROD = HSBK.from_rgb(218, 165, 32)
+    GRAY = HSBK.from_rgb(128, 128, 128)
+    GREEN = HSBK.from_rgb(0, 128, 0)
+    GREEN_YELLOW = HSBK.from_rgb(173, 255, 47)
+    GREY = HSBK.from_rgb(128, 128, 128)
+    HONEYDEW = HSBK.from_rgb(240, 255, 240)
+    HOT_PINK = HSBK.from_rgb(255, 105, 180)
+    INDIAN_RED = HSBK.from_rgb(205, 92, 92)
+    INDIGO = HSBK.from_rgb(75, 0, 130)
+    IVORY = HSBK.from_rgb(255, 255, 240)
+    KHAKI = HSBK.from_rgb(240, 230, 140)
+    LAVENDER = HSBK.from_rgb(230, 230, 250)
+    LAVENDER_BLUSH = HSBK.from_rgb(255, 240, 245)
+    LAWN_GREEN = HSBK.from_rgb(124, 252, 0)
+    LEMON_CHIFFON = HSBK.from_rgb(255, 250, 205)
+    LIGHT_BLUE = HSBK.from_rgb(173, 216, 230)
+    LIGHT_CORAL = HSBK.from_rgb(240, 128, 128)
+    LIGHT_CYAN = HSBK.from_rgb(224, 255, 255)
+    LIGHT_GOLDENROD_YELLOW = HSBK.from_rgb(250, 250, 210)
+    LIGHT_GRAY = HSBK.from_rgb(211, 211, 211)
+    LIGHT_GREEN = HSBK.from_rgb(144, 238, 144)
+    LIGHT_GREY = HSBK.from_rgb(211, 211, 211)
+    LIGHT_PINK = HSBK.from_rgb(255, 182, 193)
+    LIGHT_SALMON = HSBK.from_rgb(255, 160, 122)
+    LIGHT_SEA_GREEN = HSBK.from_rgb(32, 178, 170)
+    LIGHT_SKY_BLUE = HSBK.from_rgb(135, 206, 250)
+    LIGHT_SLATE_GRAY = HSBK.from_rgb(119, 136, 153)
+    LIGHT_SLATE_GREY = HSBK.from_rgb(119, 136, 153)
+    LIGHT_STEEL_BLUE = HSBK.from_rgb(176, 196, 222)
+    LIGHT_YELLOW = HSBK.from_rgb(255, 255, 224)
+    LIME = HSBK.from_rgb(0, 255, 0)
+    LIME_GREEN = HSBK.from_rgb(50, 205, 50)
+    LINEN = HSBK.from_rgb(250, 240, 230)
+    MAGENTA = HSBK.from_rgb(255, 0, 255)
+    MAROON = HSBK.from_rgb(128, 0, 0)
+    MEDIUM_AQUAMARINE = HSBK.from_rgb(102, 205, 170)
+    MEDIUM_BLUE = HSBK.from_rgb(0, 0, 205)
+    MEDIUM_ORCHID = HSBK.from_rgb(186, 85, 211)
+    MEDIUM_PURPLE = HSBK.from_rgb(147, 112, 219)
+    MEDIUM_SEA_GREEN = HSBK.from_rgb(60, 179, 113)
+    MEDIUM_SLATE_BLUE = HSBK.from_rgb(123, 104, 238)
+    MEDIUM_SPRING_GREEN = HSBK.from_rgb(0, 250, 154)
+    MEDIUM_TURQUOISE = HSBK.from_rgb(72, 209, 204)
+    MEDIUM_VIOLET_RED = HSBK.from_rgb(199, 21, 133)
+    MIDNIGHT_BLUE = HSBK.from_rgb(25, 25, 112)
+    MINT_CREAM = HSBK.from_rgb(245, 255, 250)
+    MISTY_ROSE = HSBK.from_rgb(255, 228, 225)
+    MOCCASIN = HSBK.from_rgb(255, 228, 181)
+    NAVAJO_WHITE = HSBK.from_rgb(255, 222, 173)
+    NAVY = HSBK.from_rgb(0, 0, 128)
+    OLD_LACE = HSBK.from_rgb(253, 245, 230)
+    OLIVE = HSBK.from_rgb(128, 128, 0)
+    OLIVE_DRAB = HSBK.from_rgb(107, 142, 35)
+    ORANGE = HSBK.from_rgb(255, 165, 0)
+    ORANGE_RED = HSBK.from_rgb(255, 69, 0)
+    ORCHID = HSBK.from_rgb(218, 112, 214)
+    PALE_GOLDENROD = HSBK.from_rgb(238, 232, 170)
+    PALE_GREEN = HSBK.from_rgb(152, 251, 152)
+    PALE_TURQUOISE = HSBK.from_rgb(175, 238, 238)
+    PALE_VIOLET_RED = HSBK.from_rgb(219, 112, 147)
+    PAPAYA_WHIP = HSBK.from_rgb(255, 239, 213)
+    PEACH_PUFF = HSBK.from_rgb(255, 218, 185)
+    PERU = HSBK.from_rgb(205, 133, 63)
+    PINK = HSBK.from_rgb(255, 192, 203)
+    PLUM = HSBK.from_rgb(221, 160, 221)
+    POWDER_BLUE = HSBK.from_rgb(176, 224, 230)
+    PURPLE = HSBK.from_rgb(128, 0, 128)
+    REBECCA_PURPLE = HSBK.from_rgb(102, 51, 153)
+    RED = HSBK.from_rgb(255, 0, 0)
+    ROSY_BROWN = HSBK.from_rgb(188, 143, 143)
+    ROYAL_BLUE = HSBK.from_rgb(65, 105, 225)
+    SADDLE_BROWN = HSBK.from_rgb(139, 69, 19)
+    SALMON = HSBK.from_rgb(250, 128, 114)
+    SANDY_BROWN = HSBK.from_rgb(244, 164, 96)
+    SEA_GREEN = HSBK.from_rgb(46, 139, 87)
+    SEASHELL = HSBK.from_rgb(255, 245, 238)
+    SIENNA = HSBK.from_rgb(160, 82, 45)
+    SILVER = HSBK.from_rgb(192, 192, 192)
+    SKY_BLUE = HSBK.from_rgb(135, 206, 235)
+    SLATE_BLUE = HSBK.from_rgb(106, 90, 205)
+    SLATE_GRAY = HSBK.from_rgb(112, 128, 144)
+    SLATE_GREY = HSBK.from_rgb(112, 128, 144)
+    SNOW = HSBK.from_rgb(255, 250, 250)
+    SPRING_GREEN = HSBK.from_rgb(0, 255, 127)
+    STEEL_BLUE = HSBK.from_rgb(70, 130, 180)
+    TAN = HSBK.from_rgb(210, 180, 140)
+    TEAL = HSBK.from_rgb(0, 128, 128)
+    THISTLE = HSBK.from_rgb(216, 191, 216)
+    TOMATO = HSBK.from_rgb(255, 99, 71)
+    TURQUOISE = HSBK.from_rgb(64, 224, 208)
+    VIOLET = HSBK.from_rgb(238, 130, 238)
+    WHEAT = HSBK.from_rgb(245, 222, 179)
+    WHITE = HSBK.from_rgb(255, 255, 255)
+    WHITE_SMOKE = HSBK.from_rgb(245, 245, 245)
+    YELLOW = HSBK.from_rgb(255, 255, 0)
+    YELLOW_GREEN = HSBK.from_rgb(154, 205, 50)
+
+    # White temperature variants (kelvin-based, warmest to coolest)
+    CANDLELIGHT = HSBK(hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_CANDLELIGHT)
+    SUNSET = HSBK(hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_SUNSET)
+    AMBER = HSBK(hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_AMBER)
+    ULTRA_WARM = HSBK(hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_ULTRA_WARM)
+    INCANDESCENT = HSBK(
+        hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_INCANDESCENT
+    )
+    WARM = HSBK(hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_WARM)
+    NEUTRAL_WARM = HSBK(
+        hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_NEUTRAL_WARM
+    )
+    NEUTRAL = HSBK(hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_NEUTRAL)
+    COOL = HSBK(hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_COOL)
+    COOL_DAYLIGHT = HSBK(
+        hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_COOL_DAYLIGHT
+    )
+    SOFT_DAYLIGHT = HSBK(
+        hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_SOFT_DAYLIGHT
+    )
+    DAYLIGHT = HSBK(hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_DAYLIGHT)
+    NOON_DAYLIGHT = HSBK(
+        hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_NOON_DAYLIGHT
+    )
+    BRIGHT_DAYLIGHT = HSBK(
+        hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_BRIGHT_DAYLIGHT
+    )
+    CLOUDY_DAYLIGHT = HSBK(
+        hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_CLOUDY_DAYLIGHT
+    )
+    BLUE_DAYLIGHT = HSBK(
+        hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_BLUE_DAYLIGHT
+    )
+    BLUE_OVERCAST = HSBK(
+        hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_BLUE_OVERCAST
+    )
+    BLUE_ICE = HSBK(hue=0, saturation=0.0, brightness=1.0, kelvin=KELVIN_BLUE_ICE)
+
+    # Pastel variants (reduced saturation)
     PASTEL_RED = HSBK(hue=0, saturation=0.3, brightness=1.0, kelvin=KELVIN_NEUTRAL)
-    PASTEL_ORANGE = HSBK(hue=30, saturation=0.3, brightness=1.0, kelvin=KELVIN_NEUTRAL)
+    PASTEL_ORANGE = HSBK(hue=39, saturation=0.3, brightness=1.0, kelvin=KELVIN_NEUTRAL)
     PASTEL_YELLOW = HSBK(hue=60, saturation=0.3, brightness=1.0, kelvin=KELVIN_NEUTRAL)
     PASTEL_GREEN = HSBK(hue=120, saturation=0.3, brightness=1.0, kelvin=KELVIN_NEUTRAL)
     PASTEL_CYAN = HSBK(hue=180, saturation=0.3, brightness=1.0, kelvin=KELVIN_NEUTRAL)
     PASTEL_BLUE = HSBK(hue=240, saturation=0.3, brightness=1.0, kelvin=KELVIN_NEUTRAL)
-    PASTEL_PURPLE = HSBK(hue=270, saturation=0.3, brightness=1.0, kelvin=KELVIN_NEUTRAL)
+    PASTEL_PURPLE = HSBK(hue=300, saturation=0.3, brightness=1.0, kelvin=KELVIN_NEUTRAL)
     PASTEL_MAGENTA = HSBK(
         hue=300, saturation=0.3, brightness=1.0, kelvin=KELVIN_NEUTRAL
     )
-    PASTEL_PINK = HSBK(hue=330, saturation=0.3, brightness=1.0, kelvin=KELVIN_NEUTRAL)
+    PASTEL_PINK = HSBK(hue=350, saturation=0.3, brightness=1.0, kelvin=KELVIN_NEUTRAL)
+
+    # Backwards compatibility aliases
+    WHITE_WARM = WARM
+    WHITE_NEUTRAL = NEUTRAL
+    WHITE_COOL = COOL
+    WHITE_DAYLIGHT = DAYLIGHT

{lifx_async-4.8.0 → lifx_async-4.9.0}/src/lifx/products/generator.py

@@ -16,7 +16,7 @@ from urllib.request import urlopen
 from lifx.const import PRODUCTS_URL
 
 
-def download_products() -> dict[str, Any] | list[dict[str, Any]]:
+def download_products() -> dict[str, Any] | list[dict[str, Any]] | None:
     """Download and parse products.json from LIFX GitHub repository.
 
     Returns:
@@ -27,11 +27,13 @@ def download_products() -> dict[str, Any] | list[dict[str, Any]]:
         json.JSONDecodeError: If parsing fails
     """
     parsed_url = urlparse(PRODUCTS_URL)
-    if parsed_url.scheme == "https" and parsed_url.netloc.startswith(
-        "raw.githubusercontent.com"
+    if (
+        parsed_url.scheme == "https"
+        and parsed_url.netloc == "raw.githubusercontent.com"
+        and parsed_url.path.startswith("/LIFX/")
     ):
-        print(f"Downloading products.json from {PRODUCTS_URL}...")
-        with urlopen(PRODUCTS_URL) as response:  # nosec B310
+        print(f"Downloading products.json from {parsed_url.geturl()}...")
+        with urlopen(parsed_url.geturl()) as response:  # nosec B310
             products_data = response.read()
 
         print("Parsing products specification...")

{lifx_async-4.8.0 → lifx_async-4.9.0}/src/lifx/protocol/generator.py

@@ -1397,7 +1397,7 @@ from lifx.protocol.base import Packet
     return code
 
 
-def download_protocol() -> dict[str, Any]:
+def download_protocol() -> dict[str, Any] | None:
     """Download and parse protocol.yml from LIFX GitHub repository.
 
     Returns:
@@ -1408,11 +1408,13 @@ def download_protocol() -> dict[str, Any]:
         yaml.YAMLError: If parsing fails
     """
     parsed_url = urlparse(PROTOCOL_URL)
-    if parsed_url.scheme == "https" and parsed_url.netloc.startswith(
-        "raw.githubusercontent.com"
+    if (
+        parsed_url.scheme == "https"
+        and parsed_url.netloc == "raw.githubusercontent.com"
+        and parsed_url.path.startswith("/LIFX/")
     ):
-        print(f"Downloading protocol.yml from {PROTOCOL_URL}...")
-        with urlopen(PROTOCOL_URL) as response:  # nosec B310
+        print(f"Downloading protocol.yml from {parsed_url.geturl()}...")
+        with urlopen(parsed_url.geturl()) as response:  # nosec B310
             protocol_data = response.read()
 
         print("Parsing protocol specification...")

{lifx_async-4.8.0 → lifx_async-4.9.0}/tests/conftest.py

@@ -10,8 +10,6 @@ from collections.abc import Generator
 from contextlib import contextmanager
 
 import pytest
-
-# Import emulator library components
 from lifx_emulator import EmulatedLifxServer
 from lifx_emulator.devices import DeviceManager
 from lifx_emulator.factories import (
@@ -33,9 +31,29 @@ from lifx.devices import HevLight, InfraredLight, Light, MultiZoneLight
 from lifx.devices.base import Device
 from lifx.devices.ceiling import CeilingLight
 from lifx.devices.matrix import MatrixLight
+from lifx.exceptions import LifxConnectionError, LifxTimeoutError
 from lifx.network.connection import DeviceConnection
 
 
+def pytest_addoption(parser: pytest.Parser) -> None:
+    """Add custom command-line options for pytest."""
+    parser.addoption(
+        "--disable-emulator",
+        action="store_true",
+        default=False,
+        help="Disable lifx-emulator tests for this test run",
+    )
+
+
+def pytest_set_filtered_exceptions() -> list[type[Exception]]:
+    """Configure pytest-retry to only retry on network-related exceptions.
+
+    Tests that fail with LifxTimeoutError or LifxConnectionError will be
+    retried automatically, as these are typically transient network issues.
+    """
+    return [LifxTimeoutError, LifxConnectionError]
+
+
 def get_free_port() -> int:
     """Get a free UDP port."""
     with socket.socket(socket.AF_INET, socket.SOCK_DGRAM) as s:
@@ -84,15 +102,20 @@ class EmulatorRunner:
 
 
 @pytest.fixture(scope="session")
-def emulator_available() -> bool:
+def emulator_available(request: pytest.FixtureRequest) -> bool:
     """Check if lifx-emulator-core is available.
 
     The library is always available as it's a direct dependency.
-    This fixture exists for backwards compatibility with test markers.
+    Emulator tests are enabled on all platforms by default. Use --disable-emulator
+    to disable them if needed.
+
+    Args:
+        request: Pytest fixture request for accessing command-line options
     """
-    import sys
+    # Check command-line flags
+    disable_emulator = request.config.getoption("--disable-emulator", default=False)
 
-    if sys.platform != "linux":
+    if disable_emulator:
         return False
 
     try:

{lifx_async-4.8.0 → lifx_async-4.9.0}/tests/test_devices/test_matrix.py

@@ -563,7 +563,7 @@ class TestMatrixLight:
         2. Send two set64() messages to fb_index=1 (non-visible buffer)
         3. Send copy_frame_buffer() to copy fb_index=1 -> fb_index=0
         4. Send two get64() messages to retrieve all 128 zones from fb_index=0
-        5. Verify the colors match what we set (blue top half, green bottom half)
+        5. Verify the colors match what we set (blue top half, lime bottom half)
         """
         matrix = ceiling_device
         async with matrix:
@@ -581,9 +581,11 @@ class TestMatrixLight:
                 tile_index=0, colors=white_colors, duration=0
             )
 
-            # Create colors: first 64 zones blue, second 64 zones green
+            # Create colors: first 64 zones blue, second 64 zones lime
+            # Note: Colors.LIME (RGB 0,255,0) has full brightness, while
+            # Colors.GREEN (RGB 0,128,0) follows CSS3 spec with 50% brightness
             blue_colors = [Colors.BLUE] * 64
-            green_colors = [Colors.GREEN] * 64
+            lime_colors = [Colors.LIME] * 64
 
             # Step 1: Set first 64 zones (rows 0-3) to blue in frame buffer 1
             await matrix.set64(
@@ -597,7 +599,7 @@ class TestMatrixLight:
                 fb_index=1,  # Write to non-visible buffer
             )
 
-            # Step 2: Set second 64 zones (rows 4-7) to green in frame buffer 1
+            # Step 2: Set second 64 zones (rows 4-7) to lime in frame buffer 1
             await matrix.set64(
                 tile_index=0,
                 length=1,
@@ -605,7 +607,7 @@ class TestMatrixLight:
                 y=4,  # Start at row 4 (after first 64 zones)
                 width=tile.width,
                 duration=0,
-                colors=green_colors,
+                colors=lime_colors,
                 fb_index=1,  # Write to non-visible buffer
             )
 
@@ -628,7 +630,7 @@ class TestMatrixLight:
             assert first_64_colors[0].saturation > 0.9
             assert first_64_colors[0].brightness > 0.9
 
-            # Verify second 64 zones are green (hue ~120)
+            # Verify second 64 zones are lime (hue ~120)
             assert 110 < second_64_colors[0].hue < 130
             assert second_64_colors[0].saturation > 0.9
             assert second_64_colors[0].brightness > 0.9

{lifx_async-4.8.0 → lifx_async-4.9.0}/uv.lock

@@ -337,7 +337,7 @@ wheels = [
 
 [[package]]
 name = "lifx-async"
-version = "4.8.0"
+version = "4.9.0"
 source = { editable = "." }
 
 [package.dev-dependencies]
@@ -352,6 +352,7 @@ dev = [
     { name = "pytest" },
     { name = "pytest-asyncio" },
     { name = "pytest-cov" },
+    { name = "pytest-retry" },
     { name = "pytest-sugar" },
     { name = "pyyaml" },
     { name = "ruff" },
@@ -371,6 +372,7 @@ dev = [
     { name = "pytest", specifier = ">=8.4.2" },
     { name = "pytest-asyncio", specifier = ">=0.24.0" },
     { name = "pytest-cov", specifier = ">=7.0.0" },
+    { name = "pytest-retry", specifier = ">=1.7.0" },
     { name = "pytest-sugar", specifier = ">=1.1.1" },
     { name = "pyyaml", specifier = ">=6.0.3" },
     { name = "ruff", specifier = ">=0.14.2" },
@@ -933,6 +935,18 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/ee/49/1377b49de7d0c1ce41292161ea0f721913fa8722c19fb9c1e3aa0367eecb/pytest_cov-7.0.0-py3-none-any.whl", hash = "sha256:3b8e9558b16cc1479da72058bdecf8073661c7f57f7d3c5f22a1c23507f2d861", size = 22424, upload-time = "2025-09-09T10:57:00.695Z" },
 ]
 
+[[package]]
+name = "pytest-retry"
+version = "1.7.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pytest" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c5/5b/607b017994cca28de3a1ad22a3eee8418e5d428dcd8ec25b26b18e995a73/pytest_retry-1.7.0.tar.gz", hash = "sha256:f8d52339f01e949df47c11ba9ee8d5b362f5824dff580d3870ec9ae0057df80f", size = 19977, upload-time = "2025-01-19T01:56:13.115Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7c/ff/3266c8a73b9b93c4b14160a7e2b31d1e1088e28ed29f4c2d93ae34093bfd/pytest_retry-1.7.0-py3-none-any.whl", hash = "sha256:a2dac85b79a4e2375943f1429479c65beb6c69553e7dae6b8332be47a60954f4", size = 13775, upload-time = "2025-01-19T01:56:11.199Z" },
+]
+
 [[package]]
 name = "pytest-sugar"
 version = "1.1.1"