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

{lifx_emulator-1.0.0 → lifx_emulator-1.0.1}/.github/workflows/ci.yml

@@ -17,15 +17,15 @@ jobs:
     name: Code Quality
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
 
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
       with:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@v7
+      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -57,15 +57,15 @@ jobs:
         os: [ubuntu-latest, macos-latest]
         python-version: ['3.11', '3.12', '3.13', '3.14']
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
 
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
       with:
         python-version: ${{ matrix.python-version }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@v7
+      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ matrix.python-version }}
@@ -79,15 +79,15 @@ jobs:
 
     - name: Upload coverage to Codecov
       if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11'
-      uses: codecov/codecov-action@v5
+      uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5
       with:
-        slug: Djelibeybi/lifx-async
+        slug: Djelibeybi/lifx-emulator
         token: ${{ secrets.CODECOV_TOKEN }}
         fail_ci_if_error: false
 
     - name: Upload test results to Codecov
       if: ${{ !cancelled() }}
-      uses: codecov/test-results-action@v1
+      uses: codecov/test-results-action@47f89e9acb64b76debcd5ea40642d25a4adced9f # v1
       with:
         fail_ci_if_error: false
         token: ${{ secrets.CODECOV_TOKEN }}
@@ -112,19 +112,19 @@ jobs:
 
     steps:
     - name: Checkout repository on release branch
-      uses: actions/checkout@v5
+      uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
       with:
         ref: ${{ github.head_ref || github.ref_name }}
         fetch-depth: 0
         ssh-key: ${{ secrets.DEPLOY_KEY }}
 
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
       with:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@v7
+      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -153,7 +153,7 @@ jobs:
         uv run --with python-semantic-release semantic-release version
 
     - name: Upload Distribution Artifacts
-      uses: actions/upload-artifact@v5
+      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
       with:
         name: distribution-artifacts
         path: dist
@@ -174,7 +174,7 @@ jobs:
 
     steps:
     - name: Download Build Artifacts
-      uses: actions/download-artifact@v6
+      uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
       id: artifact-download
       with:
         name: distribution-artifacts

{lifx_emulator-1.0.0 → lifx_emulator-1.0.1}/.github/workflows/docs.yml

@@ -25,17 +25,17 @@ jobs:
   build-docs:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
       with:
         fetch-depth: 0    # Fetch all history for git-revision-date-localized
 
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
       with:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@v7
+      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -49,7 +49,7 @@ jobs:
 
     - name: Upload docs artifact
       if: github.event_name == 'pull_request'
-      uses: actions/upload-artifact@v5
+      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
       with:
         name: docs
         path: site/
@@ -59,17 +59,17 @@ jobs:
     if: github.ref == 'refs/heads/main' && github.event_name == 'push'
     needs: build-docs
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
       with:
         fetch-depth: 0
 
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
       with:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@v7
+      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -89,15 +89,15 @@ jobs:
   validate-links:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
 
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
       with:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@v7
+      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}

lifx_emulator-1.0.1/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: lifx-emulator
+Version: 1.0.1
+Summary: LIFX Emulator for testing LIFX LAN protocol libraries
+Author-email: Avi Miller <me@dje.li>
+Maintainer-email: Avi Miller <me@dje.li>
+License-Expression: UPL-1.0
+License-File: LICENSE
+Classifier: Framework :: AsyncIO
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+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-Dist: cyclopts>=4.2.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: rich>=14.2.0
+Requires-Dist: uvicorn>=0.34.0
+Description-Content-Type: text/markdown
+
+# LIFX Emulator
+
+> A comprehensive LIFX device emulator for testing LIFX LAN protocol libraries
+
+[![Codecov](https://codecov.io/gh/Djelibeybi/lifx-emulator/branch/main/graph/badge.svg)](https://codecov.io/gh/Djelibeybi/lifx-emulator)
+[![CI](https://github.com/Djelibeybi/lifx-emulator/actions/workflows/ci.yml/badge.svg)](https://github.com/Djelibeybi/lifx-emulator/actions/workflows/ci.yml)
+[![Docs](https://github.com/Djelibeybi/lifx-emulator/workflows/Documentation/badge.svg)](https://Djelibeybi.github.io/lifx-emulator/)
+
+[![GitHub](https://img.shields.io/github/v/release/Djelibeybi/lifx-emulator)](https://github.com/Djelibeybi/lifx-emulator/releases)
+[![PyPI](https://img.shields.io/pypi/v/lifx-emulator)](https://pypi.org/project/lifx-emulator/)
+[![License](https://img.shields.io/badge/License-UPL--1.0-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%20|%203.12%20|%203.13%20|%203.14-blue)](https://www.python.org)
+## Overview
+
+LIFX Emulator implements the complete binary UDP protocol from [lan.developer.lifx.com](https://lan.developer.lifx.com) by providing virtual LIFX devices for testing without physical hardware. The emulator includes a basic web interface and OpenAPI-compliant REST API for device and scenario management at runtime.
+
+## Features
+
+- **Complete Protocol Support**: 44+ packet types from the LIFX LAN protocol
+- **Multiple Device Types**: Color lights, infrared, HEV, multizone strips, matrix tiles
+- **REST API and Web Interface**:  Monitor and manage your virtual devices during testing
+- **Testing Scenarios**: Built-in support for packet loss, delays, malformed responses
+- **Easy Integration**: Simple Python API and comprehensive CLI
+
+
+## Documentation
+
+- **[Installation Guide](https://djelibeybi.github.io/lifx-emulator/getting-started/installation/)** - Get started
+- **[Quick Start](https://djelibeybi.github.io/lifx-emulator/getting-started/quickstart/)** - Your first emulated device
+- **[User Guide](https://djelibeybi.github.io/lifx-emulator/guide/overview/)** - Product specifications and testing scenarios
+- **[Advanced Topics](https://djelibeybi.github.io/lifx-emulator/advanced/device-management-api/)** - REST API and persistent storage
+- **[CLI Reference](https://djelibeybi.github.io/lifx-emulator/getting-started/cli/)** - All CLI options
+- **[Device Types](https://djelibeybi.github.io/lifx-emulator/guide/device-types/)** - Supported devices
+- **[API Reference](https://djelibeybi.github.io/lifx-emulator/api/)** - Complete API docs
+- **[Architecture](https://djelibeybi.github.io/lifx-emulator/architecture/overview/)** - How it works
+
+
+## Use Cases
+
+- **Library Testing**: Test your LIFX library without physical devices
+- **CI/CD Integration**: Run automated tests in pipelines
+- **Protocol Development**: Experiment with LIFX protocol features
+- **Error Simulation**: Test error handling with configurable scenarios
+- **Performance Testing**: Test concurrent device handling
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/Djelibeybi/lifx-emulator.git
+cd lifx-emulator
+
+# Install with uv (recommended)
+uv sync
+
+# Or with pip
+pip install -e ".[dev]"
+
+# Run tests
+uv run pytest
+
+# Run linter
+uv run ruff check .
+
+# Build docs
+uv run mkdocs serve
+```
+
+
+## License
+
+[UPL-1.0](LICENSE)
+
+## Links
+
+- **Documentation**: https://djelibeybi.github.io/lifx-emulator
+- **GitHub**: https://github.com/Djelibeybi/lifx-emulator
+- **PyPI**: https://pypi.org/project/lifx-emulator/
+- **LIFX Protocol**: https://lan.developer.lifx.com

lifx_emulator-1.0.1/README.md

@@ -0,0 +1,79 @@
+# LIFX Emulator
+
+> A comprehensive LIFX device emulator for testing LIFX LAN protocol libraries
+
+[![Codecov](https://codecov.io/gh/Djelibeybi/lifx-emulator/branch/main/graph/badge.svg)](https://codecov.io/gh/Djelibeybi/lifx-emulator)
+[![CI](https://github.com/Djelibeybi/lifx-emulator/actions/workflows/ci.yml/badge.svg)](https://github.com/Djelibeybi/lifx-emulator/actions/workflows/ci.yml)
+[![Docs](https://github.com/Djelibeybi/lifx-emulator/workflows/Documentation/badge.svg)](https://Djelibeybi.github.io/lifx-emulator/)
+
+[![GitHub](https://img.shields.io/github/v/release/Djelibeybi/lifx-emulator)](https://github.com/Djelibeybi/lifx-emulator/releases)
+[![PyPI](https://img.shields.io/pypi/v/lifx-emulator)](https://pypi.org/project/lifx-emulator/)
+[![License](https://img.shields.io/badge/License-UPL--1.0-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%20|%203.12%20|%203.13%20|%203.14-blue)](https://www.python.org)
+## Overview
+
+LIFX Emulator implements the complete binary UDP protocol from [lan.developer.lifx.com](https://lan.developer.lifx.com) by providing virtual LIFX devices for testing without physical hardware. The emulator includes a basic web interface and OpenAPI-compliant REST API for device and scenario management at runtime.
+
+## Features
+
+- **Complete Protocol Support**: 44+ packet types from the LIFX LAN protocol
+- **Multiple Device Types**: Color lights, infrared, HEV, multizone strips, matrix tiles
+- **REST API and Web Interface**:  Monitor and manage your virtual devices during testing
+- **Testing Scenarios**: Built-in support for packet loss, delays, malformed responses
+- **Easy Integration**: Simple Python API and comprehensive CLI
+
+
+## Documentation
+
+- **[Installation Guide](https://djelibeybi.github.io/lifx-emulator/getting-started/installation/)** - Get started
+- **[Quick Start](https://djelibeybi.github.io/lifx-emulator/getting-started/quickstart/)** - Your first emulated device
+- **[User Guide](https://djelibeybi.github.io/lifx-emulator/guide/overview/)** - Product specifications and testing scenarios
+- **[Advanced Topics](https://djelibeybi.github.io/lifx-emulator/advanced/device-management-api/)** - REST API and persistent storage
+- **[CLI Reference](https://djelibeybi.github.io/lifx-emulator/getting-started/cli/)** - All CLI options
+- **[Device Types](https://djelibeybi.github.io/lifx-emulator/guide/device-types/)** - Supported devices
+- **[API Reference](https://djelibeybi.github.io/lifx-emulator/api/)** - Complete API docs
+- **[Architecture](https://djelibeybi.github.io/lifx-emulator/architecture/overview/)** - How it works
+
+
+## Use Cases
+
+- **Library Testing**: Test your LIFX library without physical devices
+- **CI/CD Integration**: Run automated tests in pipelines
+- **Protocol Development**: Experiment with LIFX protocol features
+- **Error Simulation**: Test error handling with configurable scenarios
+- **Performance Testing**: Test concurrent device handling
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/Djelibeybi/lifx-emulator.git
+cd lifx-emulator
+
+# Install with uv (recommended)
+uv sync
+
+# Or with pip
+pip install -e ".[dev]"
+
+# Run tests
+uv run pytest
+
+# Run linter
+uv run ruff check .
+
+# Build docs
+uv run mkdocs serve
+```
+
+
+## License
+
+[UPL-1.0](LICENSE)
+
+## Links
+
+- **Documentation**: https://djelibeybi.github.io/lifx-emulator
+- **GitHub**: https://github.com/Djelibeybi/lifx-emulator
+- **PyPI**: https://pypi.org/project/lifx-emulator/
+- **LIFX Protocol**: https://lan.developer.lifx.com

lifx_emulator-1.0.1/docs/changelog.md

@@ -0,0 +1,20 @@
+# CHANGELOG
+
+<!-- version list -->
+
+## v1.0.1 (2025-11-10)
+
+### Bug Fixes
+
+- Scenarios are now properly applied to initial devices
+  ([`4808512`](https://github.com/Djelibeybi/lifx-emulator/commit/480851231dbfe6c01b215e3938fa8067c9864227))
+
+### Documentation
+
+- Replace lifx-async with lifx-emulator and update README.md
+  ([`64ab6b6`](https://github.com/Djelibeybi/lifx-emulator/commit/64ab6b62dae6422774d8dc72f8f8020f0b6bb705))
+
+
+## v1.0.0 (2025-11-06)
+
+- Initial Release

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

@@ -1,6 +1,6 @@
 [project]
 name = "lifx-emulator"
-version = "1.0.0"
+version = "1.0.1"
 description = "LIFX Emulator for testing LIFX LAN protocol libraries"
 readme = "README.md"
 requires-python = ">=3.11"

{lifx_emulator-1.0.0 → lifx_emulator-1.0.1}/renovate.json

@@ -156,6 +156,6 @@
   },
   "dependencyDashboard": true,
   "dependencyDashboardTitle": "Dependency Dashboard",
-  "dependencyDashboardHeader": "This dashboard shows all pending dependency updates for lifx-async.",
+  "dependencyDashboardHeader": "This dashboard shows all pending dependency updates for lifx-emulator.",
   "dependencyDashboardFooter": "Configure Renovate by editing `renovate.json`"
 }

{lifx_emulator-1.0.0 → lifx_emulator-1.0.1}/src/lifx_emulator/api.py

@@ -7,7 +7,7 @@ from typing import TYPE_CHECKING
 
 from fastapi import FastAPI, HTTPException
 from fastapi.responses import HTMLResponse
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, Field, field_validator
 
 if TYPE_CHECKING:
     from lifx_emulator.server import EmulatedLifxServer
@@ -133,6 +133,22 @@ class ScenarioConfigModel(BaseModel):
         False, description="Send unhandled message responses for unknown packet types"
     )
 
+    @field_validator("drop_packets", mode="before")
+    @classmethod
+    def convert_drop_packets_keys(cls, v):
+        """Convert string keys to integers for drop_packets."""
+        if isinstance(v, dict):
+            return {int(k): float(val) for k, val in v.items()}
+        return v
+
+    @field_validator("response_delays", mode="before")
+    @classmethod
+    def convert_response_delays_keys(cls, v):
+        """Convert string keys to integers for response_delays."""
+        if isinstance(v, dict):
+            return {int(k): float(val) for k, val in v.items()}
+        return v
+
 
 class ScenarioResponse(BaseModel):
     """Response model for scenario operations."""

{lifx_emulator-1.0.0 → lifx_emulator-1.0.1}/src/lifx_emulator/server.py

@@ -117,6 +117,12 @@ class EmulatedLifxServer:
         # Scenario manager (shared across all devices for runtime updates)
         self.scenario_manager = scenario_manager or HierarchicalScenarioManager()
 
+        # Share scenario manager with all initial devices
+        for device in devices:
+            if isinstance(device.scenario_manager, HierarchicalScenarioManager):
+                device.scenario_manager = self.scenario_manager
+                device.invalidate_scenario_cache()
+
         # Activity observer - defaults to ActivityLogger if track_activity=True
         if activity_observer is not None:
             self.activity_observer = activity_observer

{lifx_emulator-1.0.0 → lifx_emulator-1.0.1}/tests/test_api.py

@@ -627,3 +627,85 @@ class TestScenarioConfiguration:
         assert data["scenario"]["response_delays"]["101"] == 0.1
         assert data["scenario"]["response_delays"]["102"] == 0.2
         assert data["scenario"]["response_delays"]["116"] == 0.5
+
+    def test_scenario_drop_packets_string_keys_converted(
+        self, api_client, server_with_devices
+    ):
+        """Test that string keys in drop_packets are converted to integers.
+
+        Regression test for bug where JSON string keys like {"101": 1.0}
+        were not being converted to integers, causing packet dropping to fail
+        because the comparison was int vs string.
+        """
+        from lifx_emulator.protocol.header import LifxHeader
+
+        # Set scenario with string keys (as JSON will provide)
+        scenario_config = {
+            "drop_packets": {"101": 1.0},  # String key
+            "response_delays": {},
+            "malformed_packets": [],
+            "invalid_field_values": [],
+            "firmware_version": None,
+            "partial_responses": [],
+            "send_unhandled": False,
+        }
+        response = api_client.put("/api/scenarios/global", json=scenario_config)
+        assert response.status_code == 200
+
+        # Verify the device's scenario manager has integer keys
+        device = server_with_devices.get_device("d073d5000001")
+        resolved_scenario = device._get_resolved_scenario()
+
+        # Keys should be integers, not strings
+        assert 101 in resolved_scenario.drop_packets
+        assert "101" not in resolved_scenario.drop_packets
+        assert resolved_scenario.drop_packets[101] == 1.0
+
+        # Verify packet dropping actually works
+        header = LifxHeader(
+            source=12345,
+            target=device.state.get_target_bytes(),
+            sequence=1,
+            pkt_type=101,  # GetColor - should be dropped
+            res_required=True,
+        )
+        responses = device.process_packet(header, None)
+        assert len(responses) == 0  # Packet should be dropped
+
+    def test_scenario_response_delays_string_keys_converted(
+        self, api_client, server_with_devices
+    ):
+        """Test that string keys in response_delays are converted to integers.
+
+        Ensures Pydantic validation correctly converts JSON string keys like
+        {"101": 0.5} to integer keys for proper packet type matching.
+        """
+        # Set scenario with string keys (as JSON will provide)
+        scenario_config = {
+            "drop_packets": {},
+            "response_delays": {"101": 0.5, "116": 1.0},  # String keys
+            "malformed_packets": [],
+            "invalid_field_values": [],
+            "firmware_version": None,
+            "partial_responses": [],
+            "send_unhandled": False,
+        }
+        response = api_client.put("/api/scenarios/global", json=scenario_config)
+        assert response.status_code == 200
+
+        # Verify the response contains the expected data
+        data = response.json()
+        assert data["scenario"]["response_delays"] == {"101": 0.5, "116": 1.0}
+
+        # Verify the device's scenario manager has integer keys
+        device = server_with_devices.get_device("d073d5000001")
+        resolved_scenario = device._get_resolved_scenario()
+
+        # Keys should be integers, not strings
+        assert 101 in resolved_scenario.response_delays
+        assert "101" not in resolved_scenario.response_delays
+        assert resolved_scenario.response_delays[101] == 0.5
+
+        assert 116 in resolved_scenario.response_delays
+        assert "116" not in resolved_scenario.response_delays
+        assert resolved_scenario.response_delays[116] == 1.0

{lifx_emulator-1.0.0 → lifx_emulator-1.0.1}/tests/test_server.py

@@ -195,8 +195,10 @@ class TestResponseDelays:
             color_device.state.serial,
             ScenarioConfig(response_delays={107: 0.1}),  # StateColor response
         )
-        color_device.scenario_manager = scenario_manager
-        server = EmulatedLifxServer([color_device], "127.0.0.1", 56700)
+        # Pass scenario_manager to server so it gets shared with all devices
+        server = EmulatedLifxServer(
+            [color_device], "127.0.0.1", 56700, scenario_manager=scenario_manager
+        )
 
         # StateColor response (107) has 100ms delay configured
         from lifx_emulator.constants import HEADER_SIZE

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

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