lifx-emulator 2.4.0__tar.gz → 3.1.0__tar.gz

lifx_emulator-3.1.0/CHANGELOG.md

@@ -0,0 +1,43 @@
+# CHANGELOG
+
+<!-- version list -->
+
+## v3.1.0 (2026-01-11)
+
+### Features
+
+- Add Python 3.10 support
+  ([`c19eee5`](https://github.com/Djelibeybi/lifx-emulator/commit/c19eee5181fc3e0e3b4ef9fc3e6d47308dce7a0f))
+
+
+## v3.0.2 (2025-12-24)
+
+### Bug Fixes
+
+- **api**: Eliminate XSS vulnerabilities and extract dashboard JavaScript
+  ([`8302a09`](https://github.com/Djelibeybi/lifx-emulator/commit/8302a0947b326e73f6c2f15de85986a464a307ad))
+
+
+## v3.0.1 (2025-11-26)
+
+### Bug Fixes
+
+- Adjust uv build for new monorepo layout
+  ([`a0d5b7c`](https://github.com/Djelibeybi/lifx-emulator/commit/a0d5b7c1c1ab5659acc8554931f6c441654add05))
+
+
+## v3.0.0 (2025-11-26)
+
+### Refactoring
+
+- Split into monorepo with separate library and CLI packages
+  ([`402fe6e`](https://github.com/Djelibeybi/lifx-emulator/commit/402fe6e6c42e4fb730d076cd4dd0bfe7743b2c57))
+
+### Breaking Changes
+
+- The project is now split into two packages:
+
+
+## v2.4.0 (2025-11-26)
+
+- Initial Release

lifx_emulator-3.1.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: lifx-emulator
+Version: 3.1.0
+Summary: Standalone LIFX Emulator with CLI and HTTP management API
+Author-email: Avi Miller <me@dje.li>
+Maintainer-email: Avi Miller <me@dje.li>
+License-Expression: UPL-1.0
+Classifier: Environment :: Console
+Classifier: Framework :: AsyncIO
+Classifier: Framework :: FastAPI
+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
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Testing
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: cyclopts>=4.2.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: lifx-emulator-core>=2.4.0
+Requires-Dist: rich>=14.2.0
+Requires-Dist: uvicorn>=0.34.0
+Description-Content-Type: text/markdown
+
+# lifx-emulator
+
+Standalone LIFX device emulator with CLI and HTTP management API.
+
+This package provides a ready-to-run emulator for testing LIFX LAN protocol libraries. It includes a command-line interface and an optional HTTP API for runtime device management.
+
+## Installation
+
+```bash
+pip install lifx-emulator
+```
+
+## Quick Start
+
+```bash
+# Start with default configuration (1 color light)
+lifx-emulator
+
+# Create multiple device types
+lifx-emulator --color 2 --multizone 1 --tile 1
+
+# Enable HTTP management API
+lifx-emulator --api
+
+# List available LIFX products
+lifx-emulator list-products
+
+# Create devices by product ID
+lifx-emulator --product 27 --product 38 --product 55
+```
+
+## Features
+
+- Command-line interface for quick emulator setup
+- HTTP management API with web dashboard
+- Real-time device monitoring and management
+- Support for all LIFX device types (color, multizone, tile, infrared, HEV, switch)
+- Persistent device state across restarts
+- Testing scenarios for protocol edge cases
+
+## HTTP Management API
+
+Enable with `--api` to get:
+
+- **Web Dashboard**: `http://localhost:8080` - Real-time monitoring UI
+- **REST API**: Device management, statistics, and scenario control
+- **OpenAPI Docs**: `http://localhost:8080/docs` - Interactive API documentation
+
+```bash
+# Start with API server
+lifx-emulator --color 2 --api --api-port 9090
+
+# Add a device via API
+curl -X POST http://localhost:9090/api/devices \
+  -H "Content-Type: application/json" \
+  -d '{"product_id": 27}'
+```
+
+## Documentation
+
+Full documentation is available at: **https://djelibeybi.github.io/lifx-emulator**
+
+- [Installation Guide](https://djelibeybi.github.io/lifx-emulator/getting-started/installation/)
+- [CLI Reference](https://djelibeybi.github.io/lifx-emulator/cli/cli-reference/)
+- [Web Interface](https://djelibeybi.github.io/lifx-emulator/cli/web-interface/)
+- [REST API](https://djelibeybi.github.io/lifx-emulator/cli/device-management-api/)
+
+## Related Packages
+
+- **[lifx-emulator-core](https://pypi.org/project/lifx-emulator-core/)**: Core library for embedding the emulator in your own projects
+
+## License
+
+[UPL-1.0](https://opensource.org/licenses/UPL)

lifx_emulator-3.1.0/README.md

@@ -0,0 +1,74 @@
+# lifx-emulator
+
+Standalone LIFX device emulator with CLI and HTTP management API.
+
+This package provides a ready-to-run emulator for testing LIFX LAN protocol libraries. It includes a command-line interface and an optional HTTP API for runtime device management.
+
+## Installation
+
+```bash
+pip install lifx-emulator
+```
+
+## Quick Start
+
+```bash
+# Start with default configuration (1 color light)
+lifx-emulator
+
+# Create multiple device types
+lifx-emulator --color 2 --multizone 1 --tile 1
+
+# Enable HTTP management API
+lifx-emulator --api
+
+# List available LIFX products
+lifx-emulator list-products
+
+# Create devices by product ID
+lifx-emulator --product 27 --product 38 --product 55
+```
+
+## Features
+
+- Command-line interface for quick emulator setup
+- HTTP management API with web dashboard
+- Real-time device monitoring and management
+- Support for all LIFX device types (color, multizone, tile, infrared, HEV, switch)
+- Persistent device state across restarts
+- Testing scenarios for protocol edge cases
+
+## HTTP Management API
+
+Enable with `--api` to get:
+
+- **Web Dashboard**: `http://localhost:8080` - Real-time monitoring UI
+- **REST API**: Device management, statistics, and scenario control
+- **OpenAPI Docs**: `http://localhost:8080/docs` - Interactive API documentation
+
+```bash
+# Start with API server
+lifx-emulator --color 2 --api --api-port 9090
+
+# Add a device via API
+curl -X POST http://localhost:9090/api/devices \
+  -H "Content-Type: application/json" \
+  -d '{"product_id": 27}'
+```
+
+## Documentation
+
+Full documentation is available at: **https://djelibeybi.github.io/lifx-emulator**
+
+- [Installation Guide](https://djelibeybi.github.io/lifx-emulator/getting-started/installation/)
+- [CLI Reference](https://djelibeybi.github.io/lifx-emulator/cli/cli-reference/)
+- [Web Interface](https://djelibeybi.github.io/lifx-emulator/cli/web-interface/)
+- [REST API](https://djelibeybi.github.io/lifx-emulator/cli/device-management-api/)
+
+## Related Packages
+
+- **[lifx-emulator-core](https://pypi.org/project/lifx-emulator-core/)**: Core library for embedding the emulator in your own projects
+
+## License
+
+[UPL-1.0](https://opensource.org/licenses/UPL)

{lifx_emulator-2.4.0 → lifx_emulator-3.1.0}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "lifx-emulator"
-version = "2.4.0"
-description = "LIFX Emulator for testing LIFX LAN protocol libraries"
+version = "3.1.0"
+description = "Standalone LIFX Emulator with CLI and HTTP management API"
 readme = "README.md"
-requires-python = ">=3.11"
+requires-python = ">=3.10"
 dependencies = [
+    "lifx-emulator-core>=2.4.0",
     "cyclopts>=4.2.0",
     "fastapi>=0.115.0",
-    "pyyaml>=6.0.3",
     "rich>=14.2.0",
     "uvicorn>=0.34.0",
 ]
@@ -20,79 +20,35 @@ maintainers = [
     {name = "Avi Miller", email = "me@dje.li"}
 ]
 classifiers = [
+    "Environment :: Console",
     "Framework :: AsyncIO",
+    "Framework :: FastAPI",
     "Framework :: Pytest",
     "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",
     "Programming Language :: Python :: 3.14",
-    "Topic :: Software Development :: Libraries",
-    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Testing",
     "Typing :: Typed"
 ]
 
 [project.scripts]
-lifx-emulator = "lifx_emulator.__main__:main"
-
-[dependency-groups]
-dev = [
-    "hatchling>=1.27.0",
-    "httpx>=0.28.0",
-    "pyright>=1.1.407",
-    "pytest>=8.4.2",
-    "pytest-asyncio>=0.24.0",
-    "pytest-cov>=7.0.0",
-    "pytest-sugar>=1.1.1",
-    "ruff>=0.14.2",
-    "mkdocs>=1.6.0",
-    "mkdocs-material>=9.6.0",
-    "mkdocstrings[python]>=0.27.0",
-    "mkdocs-git-revision-date-localized-plugin>=1.4.0",
-    "mkdocs-llmstxt>=0.3.0",
-]
+lifx-emulator = "lifx_emulator_app.__main__:main"
 
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/lifx_emulator"]
-
-[tool.ruff]
-line-length = 88
-indent-width = 4
-target-version = "py311"
-
-[tool.ruff.format]
-quote-style = "double"
-indent-style = "space"
-docstring-code-format = true
-docstring-code-line-length = "dynamic"
-
-[tool.ruff.lint]
-select = ["E", "F", "I", "N", "W", "UP"]
-ignore = []
-
-# Complexity and code quality limits
-[tool.ruff.lint.mccabe]
-max-complexity = 10
-
-[tool.ruff.lint.pylint]
-max-args = 5
-max-branches = 12
-max-statements = 50
-
-[tool.ruff.lint.per-file-ignores]
-"src/lifx_emulator/protocol/generator.py" = ["E501"]
-"src/lifx_emulator/protocol/packets.py" = ["E501"]
-
+packages = ["src/lifx_emulator_app"]
 
 [tool.pyright]
 typeCheckingMode = "standard"
-pythonVersion = "3.11"
+pythonVersion = "3.10"
 include = ["src"]
 exclude = ["**/__pycache__"]
 
@@ -102,43 +58,28 @@ pythonpath = ["src"]
 python_files = ["test_*.py"]
 python_classes = ["Test*"]
 python_functions = ["test_*"]
-addopts = """\
-    -v
-    -Wdefault
-    --cov=lifx_emulator
-    --cov-branch
-    --cov-report=xml
-    --cov-report=term-missing:skip-covered
-    --junitxml=junit.xml -o junit_family=legacy
-    """
 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",
-    "@overload",
-    "if TYPE_CHECKING",
-    "raise NotImplementedError",
-    'if __name__ == "__main__":',
-]
-
 [tool.semantic_release]
+commit_parser = "conventional-monorepo"
+commit_message = """\
+chore(release): lifx-emulator@{version}
+
+Automatically generated by python-semantic-release
+"""
+tag_format = "app-v{version}"
 version_toml = ["pyproject.toml:project.version"]
 build_command = """
     uv lock --upgrade-package "$PACKAGE_NAME"
-    git add uv.lock
-    uv build
+    git add ../../uv.lock
+    uv build --package lifx-emulator --out-dir dist/
 """
 
+[tool.semantic_release.commit_parser_options]
+path_filters = ["."]
+scope_prefix = "app-"
+
 [tool.semantic_release.branches.main]
 match = "main"
 prerelease = false
@@ -161,7 +102,7 @@ exclude_commit_patterns = [
 ]
 
 [tool.semantic_release.changelog.default_templates]
-changelog_file = "docs/changelog.md"
+changelog_file = "CHANGELOG.md"
 output_format = "md"
 
 [tool.semantic_release.remote]

lifx_emulator-3.1.0/src/lifx_emulator_app/__init__.py

@@ -0,0 +1,10 @@
+"""LIFX Emulator Application
+
+Standalone CLI and HTTP management API for the LIFX Emulator.
+"""
+
+from importlib.metadata import version as get_version
+
+__version__ = get_version("lifx-emulator")
+
+__all__ = ["__version__"]

{lifx_emulator-2.4.0/src/lifx_emulator → lifx_emulator-3.1.0/src/lifx_emulator_app}/__main__.py

@@ -6,8 +6,6 @@ import signal
 from typing import Annotated
 
 import cyclopts
-from rich.logging import RichHandler
-
 from lifx_emulator.constants import LIFX_UDP_PORT
 from lifx_emulator.devices import (
     DEFAULT_STORAGE_DIR,
@@ -28,6 +26,7 @@ from lifx_emulator.products.registry import get_registry
 from lifx_emulator.repositories import DeviceRepository
 from lifx_emulator.scenarios import ScenarioPersistenceAsyncFile
 from lifx_emulator.server import EmulatedLifxServer
+from rich.logging import RichHandler
 
 app = cyclopts.App(
     name="lifx-emulator",
@@ -529,7 +528,7 @@ async def run(
     # Start API server if enabled
     api_task = None
     if api:
-        from lifx_emulator.api import run_api_server
+        from lifx_emulator_app.api import run_api_server
 
         logger.info("Starting HTTP API server on http://%s:%s", api_host, api_port)
         api_task = asyncio.create_task(run_api_server(server, api_host, api_port))

{lifx_emulator-2.4.0/src/lifx_emulator → lifx_emulator-3.1.0/src/lifx_emulator_app}/api/__init__.py

@@ -10,7 +10,7 @@ of concerns.
 """
 
 # Import from new refactored structure
-from lifx_emulator.api.app import create_api_app, run_api_server
+from lifx_emulator_app.api.app import create_api_app, run_api_server
 
 # Note: HTML_UI remains in the old lifx_emulator/api.py file temporarily
 # TODO: Phase 1.1d - extract HTML template to separate file

{lifx_emulator-2.4.0/src/lifx_emulator → lifx_emulator-3.1.0/src/lifx_emulator_app}/api/app.py

@@ -14,19 +14,21 @@ from typing import TYPE_CHECKING
 
 from fastapi import FastAPI, Request
 from fastapi.responses import HTMLResponse
+from fastapi.staticfiles import StaticFiles
 from fastapi.templating import Jinja2Templates
 
 if TYPE_CHECKING:
     from lifx_emulator.server import EmulatedLifxServer
 
-from lifx_emulator.api.routers.devices import create_devices_router
-from lifx_emulator.api.routers.monitoring import create_monitoring_router
-from lifx_emulator.api.routers.scenarios import create_scenarios_router
+from lifx_emulator_app.api.routers.devices import create_devices_router
+from lifx_emulator_app.api.routers.monitoring import create_monitoring_router
+from lifx_emulator_app.api.routers.scenarios import create_scenarios_router
 
 logger = logging.getLogger(__name__)
 
-# Template directory for web UI
+# Asset directories for web UI
 TEMPLATES_DIR = Path(__file__).parent / "templates"
+STATIC_DIR = Path(__file__).parent / "static"
 templates = Jinja2Templates(directory=str(TEMPLATES_DIR))
 
 
@@ -102,6 +104,9 @@ The API is organized into three main routers:
         """Serve embedded web UI dashboard."""
         return templates.TemplateResponse(request, "dashboard.html")
 
+    # Mount static files for JS/CSS assets (cached by browsers)
+    app.mount("/static", StaticFiles(directory=str(STATIC_DIR)), name="static")
+
     # Include routers with server dependency injection
     monitoring_router = create_monitoring_router(server)
     devices_router = create_devices_router(server)

{lifx_emulator-2.4.0/src/lifx_emulator → lifx_emulator-3.1.0/src/lifx_emulator_app}/api/mappers/__init__.py

@@ -1,5 +1,5 @@
 """Mappers for converting domain models to API models."""
 
-from lifx_emulator.api.mappers.device_mapper import DeviceMapper
+from lifx_emulator_app.api.mappers.device_mapper import DeviceMapper
 
 __all__ = ["DeviceMapper"]

{lifx_emulator-2.4.0/src/lifx_emulator → lifx_emulator-3.1.0/src/lifx_emulator_app}/api/mappers/device_mapper.py

@@ -7,7 +7,7 @@ from typing import TYPE_CHECKING
 if TYPE_CHECKING:
     from lifx_emulator.devices import EmulatedLifxDevice
 
-from lifx_emulator.api.models import ColorHsbk, DeviceInfo
+from lifx_emulator_app.api.models import ColorHsbk, DeviceInfo
 
 
 class DeviceMapper:

{lifx_emulator-2.4.0/src/lifx_emulator → lifx_emulator-3.1.0/src/lifx_emulator_app}/api/models.py

@@ -1,9 +1,8 @@
 """Pydantic models for API requests and responses."""
 
-from pydantic import BaseModel, Field, field_validator
-
 # Import shared domain models
 from lifx_emulator.scenarios import ScenarioConfig
+from pydantic import BaseModel, Field, field_validator
 
 
 class DeviceCreateRequest(BaseModel):

lifx_emulator-3.1.0/src/lifx_emulator_app/api/routers/__init__.py

@@ -0,0 +1,11 @@
+"""API routers for LIFX emulator endpoints."""
+
+from lifx_emulator_app.api.routers.devices import create_devices_router
+from lifx_emulator_app.api.routers.monitoring import create_monitoring_router
+from lifx_emulator_app.api.routers.scenarios import create_scenarios_router
+
+__all__ = [
+    "create_monitoring_router",
+    "create_devices_router",
+    "create_scenarios_router",
+]

{lifx_emulator-2.4.0/src/lifx_emulator → lifx_emulator-3.1.0/src/lifx_emulator_app}/api/routers/devices.py

@@ -9,8 +9,8 @@ from fastapi import APIRouter, HTTPException
 if TYPE_CHECKING:
     from lifx_emulator.server import EmulatedLifxServer
 
-from lifx_emulator.api.models import DeviceCreateRequest, DeviceInfo
-from lifx_emulator.api.services.device_service import (
+from lifx_emulator_app.api.models import DeviceCreateRequest, DeviceInfo
+from lifx_emulator_app.api.services.device_service import (
     DeviceAlreadyExistsError,
     DeviceCreationError,
     DeviceNotFoundError,

{lifx_emulator-2.4.0/src/lifx_emulator → lifx_emulator-3.1.0/src/lifx_emulator_app}/api/routers/monitoring.py

@@ -9,7 +9,7 @@ from fastapi import APIRouter
 if TYPE_CHECKING:
     from lifx_emulator.server import EmulatedLifxServer
 
-from lifx_emulator.api.models import ActivityEvent, ServerStats
+from lifx_emulator_app.api.models import ActivityEvent, ServerStats
 
 
 def create_monitoring_router(server: EmulatedLifxServer) -> APIRouter:

{lifx_emulator-2.4.0/src/lifx_emulator → lifx_emulator-3.1.0/src/lifx_emulator_app}/api/routers/scenarios.py

@@ -9,7 +9,7 @@ from fastapi import APIRouter, HTTPException
 if TYPE_CHECKING:
     from lifx_emulator.server import EmulatedLifxServer
 
-from lifx_emulator.api.models import ScenarioConfig, ScenarioResponse
+from lifx_emulator_app.api.models import ScenarioConfig, ScenarioResponse
 
 
 def _validate_device_serial(serial: str) -> bool:

lifx_emulator-3.1.0/src/lifx_emulator_app/api/services/__init__.py

@@ -0,0 +1,8 @@
+"""Business logic services for API endpoints."""
+
+from lifx_emulator_app.api.services.device_service import DeviceService
+
+# TODO: Create ScenarioService (Phase 1.1b completion)
+# from lifx_emulator_app.api.services.scenario_service import ScenarioService
+
+__all__ = ["DeviceService"]

{lifx_emulator-2.4.0/src/lifx_emulator → lifx_emulator-3.1.0/src/lifx_emulator_app}/api/services/device_service.py

@@ -13,10 +13,11 @@ from typing import TYPE_CHECKING
 if TYPE_CHECKING:
     from lifx_emulator.server import EmulatedLifxServer
 
-from lifx_emulator.api.mappers import DeviceMapper
-from lifx_emulator.api.models import DeviceCreateRequest, DeviceInfo
 from lifx_emulator.factories import create_device
 
+from lifx_emulator_app.api.mappers import DeviceMapper
+from lifx_emulator_app.api.models import DeviceCreateRequest, DeviceInfo
+
 logger = logging.getLogger(__name__)