lifx-emulator 2.4.0__py3-none-any.whl → 3.1.0__py3-none-any.whl

lifx_emulator-3.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,19 @@
+lifx_emulator_app/__init__.py,sha256=AJahGiWKb8U8yLQbJX21takbf-SoxDxMOGxjJeM7M5c,222
+lifx_emulator_app/__main__.py,sha256=f_VwgZfwOdp3zQshv8JQqBX7gocE9ATZbZ3wQndlBvo,22060
+lifx_emulator_app/api/__init__.py,sha256=bpdhugx7PAop5IQhkKnWE-a1hfI9gJoJiNRG2CCWe5A,651
+lifx_emulator_app/api/app.py,sha256=QyHSzb0BYk341PlWLIcgHJHOYnFetcG0FQsVlVY_OX8,5126
+lifx_emulator_app/api/models.py,sha256=fiX9hDmR1C12tzet-kGPmbaG_qiZfiprgy-uxwIcEsE,3970
+lifx_emulator_app/api/mappers/__init__.py,sha256=-lGAg-s16eTMl2_D-3bPu-EMqD2kaPzXHqSrKCnmW2w,156
+lifx_emulator_app/api/mappers/device_mapper.py,sha256=WAo-_PJ2kX3J4GUW_Sjoype1d_uaIh-PtXPfMUAujUY,4155
+lifx_emulator_app/api/routers/__init__.py,sha256=TKPypociZ_uo2YCyW5zIeUfalUh_PkzCVt31MHg9ZPc,381
+lifx_emulator_app/api/routers/devices.py,sha256=5_0Id09Z6yOB3s-uAEAU4oNribV49IitC0-_Bmx3bCk,4218
+lifx_emulator_app/api/routers/monitoring.py,sha256=i82_s61caYd9UvMb4MqWPLP7LuFh5KN8Qkw4_dZr3O0,1460
+lifx_emulator_app/api/routers/scenarios.py,sha256=pWXTliY9MIk-DCxDOZ1cjeAFgHn79ExvY-6lj-yHPWk,9747
+lifx_emulator_app/api/services/__init__.py,sha256=cdKZItYE-KkMX44V9xJW_PHHnJoAw5I7Uw1a1YKHgMI,285
+lifx_emulator_app/api/services/device_service.py,sha256=A2rCuZ1aAJ1tThKM6BYorKAjlaDgDaFCT5C9KUHfAvc,6303
+lifx_emulator_app/api/static/dashboard.js,sha256=eJOtBzTLRPYmMVuft5GC8r7Ae6x_JWZs9nqrmKaOILA,20177
+lifx_emulator_app/api/templates/dashboard.html,sha256=6vqMpsAtCBXASHOLnXn3_uZ-U5r7-P3FPo8_NJiMitk,10194
+lifx_emulator-3.1.0.dist-info/METADATA,sha256=hOg5mr27_HE83CfaYyjaF_5N4BClqSa3iYQ8kLsr2ec,3225
+lifx_emulator-3.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+lifx_emulator-3.1.0.dist-info/entry_points.txt,sha256=tNZHeJTPUXNxu_nuk99ArXLKgwYLhIVVxN7YiaiXBOA,66
+lifx_emulator-3.1.0.dist-info/RECORD,,

{lifx_emulator-2.4.0.dist-info → lifx_emulator-3.1.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any

lifx_emulator-3.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+lifx-emulator = lifx_emulator_app.__main__:main

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 → 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 → 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 → 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 → 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 → 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 → 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_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 → 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 → 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 → 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_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 → 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__)