lifx-emulator 1.0.1__tar.gz → 1.0.2__tar.gz

{lifx_emulator-1.0.1 → lifx_emulator-1.0.2}/CLAUDE.md

@@ -553,6 +553,48 @@ All factory functions now use the specs system to load product-specific defaults
 - Tile dimensions (e.g., 8x8 for Tiles, 5x6 for Candles)
 - Users can override these defaults by passing explicit parameters
 
+### Product Registry
+
+**Product Registry** (`src/lifx_emulator/products/registry.py`):
+- Auto-generated from official LIFX products.json (https://github.com/LIFX/products)
+- Contains 137+ product definitions with capabilities, temperature ranges, and firmware requirements
+- Pre-built `ProductInfo` instances for efficient runtime lookups
+- Capability flags: `COLOR`, `INFRARED`, `MULTIZONE`, `CHAIN`, `MATRIX`, `RELAYS`, `BUTTONS`, `HEV`, `EXTENDED_MULTIZONE`
+- Never edit this file manually - regenerate using the generator
+
+**Product Registry Generator** (`src/lifx_emulator/products/generator.py`):
+- Downloads latest products.json from LIFX GitHub repository
+- Generates optimized Python code with pre-built product definitions
+- Handles extended multizone capability detection:
+  - **Native support**: Products with `extended_multizone: true` in features (no firmware requirement)
+    - Examples: LIFX Z US (PID 117), LIFX Beam US (PID 119), LIFX Neon, LIFX Permanent Outdoor
+  - **Firmware upgrade**: Products with `extended_multizone` in upgrades section (requires minimum firmware)
+    - Examples: LIFX Z (PID 32, requires firmware 2.77+), LIFX Beam (PID 38, requires firmware 2.77+)
+- Updates specs.yml with templates for new multizone/matrix products
+- Run with: `python -m lifx_emulator.products.generator`
+
+**Product Specs** (`src/lifx_emulator/products/specs.yml`):
+- Product-specific configuration not available in upstream products.json
+- Default zone counts, tile configurations, and device-specific defaults
+- Used by factory functions to create realistic device configurations
+- Manually maintained for accurate product specifications
+
+**ProductInfo API:**
+```python
+from lifx_emulator.products.registry import get_product
+
+product = get_product(117)  # LIFX Z US
+product.has_extended_multizone  # True
+product.min_ext_mz_firmware     # None (native support)
+product.supports_extended_multizone()  # True
+
+product = get_product(32)  # LIFX Z (older model)
+product.has_extended_multizone  # True
+product.min_ext_mz_firmware     # 131149 (firmware 2.77)
+product.supports_extended_multizone(131149)  # True (meets requirement)
+product.supports_extended_multizone(131148)  # False (below requirement)
+```
+
 ## Key Implementation Details
 
 ### MultiZone Handling

{lifx_emulator-1.0.1 → lifx_emulator-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lifx-emulator
-Version: 1.0.1
+Version: 1.0.2
 Summary: LIFX Emulator for testing LIFX LAN protocol libraries
 Author-email: Avi Miller <me@dje.li>
 Maintainer-email: Avi Miller <me@dje.li>

{lifx_emulator-1.0.1 → lifx_emulator-1.0.2}/docs/changelog.md

@@ -2,6 +2,14 @@
 
 <!-- version list -->
 
+## v1.0.2 (2025-11-10)
+
+### Bug Fixes
+
+- Extended_multizone added to products correctly by generator
+  ([`b6c4f78`](https://github.com/Djelibeybi/lifx-emulator/commit/b6c4f78c7353313b961acdb4283023a595141151))
+
+
 ## v1.0.1 (2025-11-10)
 
 ### Bug Fixes

{lifx_emulator-1.0.1 → lifx_emulator-1.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lifx-emulator"
-version = "1.0.1"
+version = "1.0.2"
 description = "LIFX Emulator for testing LIFX LAN protocol libraries"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -103,6 +103,14 @@ addopts = """\
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "function"
 
+[tool.coverage.run]
+omit = [
+    "src/lifx_emulator/protocol/generator.py",
+    "src/lifx_emulator/protocol/protocol_types.py",
+    "src/lifx_emulator/products/generator.py",
+    "src/lifx_emulator/products/registry.py",
+]
+
 [tool.coverage.report]
 exclude_lines = [
     "pragma: no cover",

{lifx_emulator-1.0.1 → lifx_emulator-1.0.2}/src/lifx_emulator/__main__.py

@@ -102,10 +102,12 @@ def _format_product_capabilities(product: ProductInfo) -> str:
     # Add additional capabilities
     if product.has_infrared:
         caps.append("infrared")
-    if product.has_multizone:
-        caps.append("multizone")
+    # Extended multizone is backwards compatible with multizone,
+    # so only show multizone if extended multizone is not present
     if product.has_extended_multizone:
         caps.append("extended-multizone")
+    elif product.has_multizone:
+        caps.append("multizone")
     if product.has_matrix:
         caps.append("matrix")
     if product.has_hev:

{lifx_emulator-1.0.1 → lifx_emulator-1.0.2}/src/lifx_emulator/products/generator.py

@@ -97,16 +97,22 @@ def generate_product_definitions(
             if features.get("hev"):
                 capabilities.append("ProductCapability.HEV")
 
-            # Check for extended multizone in upgrades
+            # Check for extended multizone capability
             min_ext_mz_firmware = None
-            for upgrade in product.get("upgrades", []):
-                if upgrade.get("features", {}).get("extended_multizone"):
-                    capabilities.append("ProductCapability.EXTENDED_MULTIZONE")
-                    # Parse firmware version (major.minor format)
-                    major = upgrade.get("major", 0)
-                    minor = upgrade.get("minor", 0)
-                    min_ext_mz_firmware = (major << 16) | minor
-                    break
+
+            # First check if it's a native feature (no firmware requirement)
+            if features.get("extended_multizone"):
+                capabilities.append("ProductCapability.EXTENDED_MULTIZONE")
+            else:
+                # Check if it's available as an upgrade (requires minimum firmware)
+                for upgrade in product.get("upgrades", []):
+                    if upgrade.get("features", {}).get("extended_multizone"):
+                        capabilities.append("ProductCapability.EXTENDED_MULTIZONE")
+                        # Parse firmware version (major.minor format)
+                        major = upgrade.get("major", 0)
+                        minor = upgrade.get("minor", 0)
+                        min_ext_mz_firmware = (major << 16) | minor
+                        break
 
             # Build capabilities expression
             if capabilities:
@@ -357,16 +363,22 @@ class ProductRegistry:
                 if features.get("hev"):
                     capabilities |= ProductCapability.HEV
 
-                # Check for extended multizone in upgrades
+                # Check for extended multizone capability
                 min_ext_mz_firmware = None
-                for upgrade in product.get("upgrades", []):
-                    if upgrade.get("features", {}).get("extended_multizone"):
-                        capabilities |= ProductCapability.EXTENDED_MULTIZONE
-                        # Parse firmware version (major.minor format)
-                        major = upgrade.get("major", 0)
-                        minor = upgrade.get("minor", 0)
-                        min_ext_mz_firmware = (major << 16) | minor
-                        break
+
+                # First check if it's a native feature (no firmware requirement)
+                if features.get("extended_multizone"):
+                    capabilities |= ProductCapability.EXTENDED_MULTIZONE
+                else:
+                    # Check if it's available as an upgrade (requires minimum firmware)
+                    for upgrade in product.get("upgrades", []):
+                        if upgrade.get("features", {}).get("extended_multizone"):
+                            capabilities |= ProductCapability.EXTENDED_MULTIZONE
+                            # Parse firmware version (major.minor format)
+                            major = upgrade.get("major", 0)
+                            minor = upgrade.get("minor", 0)
+                            min_ext_mz_firmware = (major << 16) | minor
+                            break
 
                 # Parse temperature range
                 temp_range = None

{lifx_emulator-1.0.1 → lifx_emulator-1.0.2}/src/lifx_emulator/products/registry.py

@@ -677,7 +677,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=117,
         name="LIFX Z US",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -685,7 +687,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=118,
         name="LIFX Z Intl",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -693,7 +697,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=119,
         name="LIFX Beam US",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -701,7 +707,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=120,
         name="LIFX Beam Intl",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -853,7 +861,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=141,
         name="LIFX Neon US",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -861,7 +871,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=142,
         name="LIFX Neon Intl",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -869,7 +881,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=143,
         name="LIFX String US",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -877,7 +891,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=144,
         name="LIFX String Intl",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -885,7 +901,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=161,
         name="LIFX Outdoor Neon US",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -893,7 +911,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=162,
         name="LIFX Outdoor Neon Intl",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -1101,7 +1121,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=203,
         name="LIFX String US",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -1109,7 +1131,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=204,
         name="LIFX String Intl",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -1117,7 +1141,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=205,
         name="LIFX Indoor Neon US",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -1125,7 +1151,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=206,
         name="LIFX Indoor Neon Intl",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -1133,7 +1161,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=213,
         name="LIFX Permanent Outdoor US",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -1141,7 +1171,9 @@ PRODUCTS: dict[int, ProductInfo] = {
         pid=214,
         name="LIFX Permanent Outdoor Intl",
         vendor=1,
-        capabilities=ProductCapability.COLOR | ProductCapability.MULTIZONE,
+        capabilities=ProductCapability.COLOR
+        | ProductCapability.MULTIZONE
+        | ProductCapability.EXTENDED_MULTIZONE,
         temperature_range=TemperatureRange(min=1500, max=9000),
         min_ext_mz_firmware=None,
     ),
@@ -1300,16 +1332,22 @@ class ProductRegistry:
                 if features.get("hev"):
                     capabilities |= ProductCapability.HEV
 
-                # Check for extended multizone in upgrades
+                # Check for extended multizone capability
                 min_ext_mz_firmware = None
-                for upgrade in product.get("upgrades", []):
-                    if upgrade.get("features", {}).get("extended_multizone"):
-                        capabilities |= ProductCapability.EXTENDED_MULTIZONE
-                        # Parse firmware version (major.minor format)
-                        major = upgrade.get("major", 0)
-                        minor = upgrade.get("minor", 0)
-                        min_ext_mz_firmware = (major << 16) | minor
-                        break
+
+                # First check if it's a native feature (no firmware requirement)
+                if features.get("extended_multizone"):
+                    capabilities |= ProductCapability.EXTENDED_MULTIZONE
+                else:
+                    # Check if it's available as an upgrade (requires minimum firmware)
+                    for upgrade in product.get("upgrades", []):
+                        if upgrade.get("features", {}).get("extended_multizone"):
+                            capabilities |= ProductCapability.EXTENDED_MULTIZONE
+                            # Parse firmware version (major.minor format)
+                            major = upgrade.get("major", 0)
+                            minor = upgrade.get("minor", 0)
+                            min_ext_mz_firmware = (major << 16) | minor
+                            break
 
                 # Parse temperature range
                 temp_range = None

{lifx_emulator-1.0.1 → lifx_emulator-1.0.2}/uv.lock

@@ -441,7 +441,7 @@ wheels = [
 
 [[package]]
 name = "lifx-emulator"
-version = "1.0.1"
+version = "1.0.2"
 source = { editable = "." }
 dependencies = [
     { name = "cyclopts" },