lifx-emulator 2.3.1__tar.gz → 3.0.1__tar.gz

lifx_emulator-3.0.1/CHANGELOG.md

@@ -0,0 +1,27 @@
+# CHANGELOG
+
+<!-- version list -->
+
+## 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.0.1/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: lifx-emulator
+Version: 3.0.1
+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.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.11
+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.0.1/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.3.1 → lifx_emulator-3.0.1}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "lifx-emulator"
-version = "2.3.1"
-description = "LIFX Emulator for testing LIFX LAN protocol libraries"
+version = "3.0.1"
+description = "Standalone LIFX Emulator with CLI and HTTP management API"
 readme = "README.md"
 requires-python = ">=3.11"
 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,7 +20,9 @@ maintainers = [
     {name = "Avi Miller", email = "me@dje.li"}
 ]
 classifiers = [
+    "Environment :: Console",
     "Framework :: AsyncIO",
+    "Framework :: FastAPI",
     "Framework :: Pytest",
     "Intended Audience :: Developers",
     "Natural Language :: English",
@@ -29,66 +31,19 @@ classifiers = [
     "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"
@@ -102,43 +57,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 +101,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.0.1/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.3.1/src/lifx_emulator → lifx_emulator-3.0.1/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,
@@ -21,12 +19,14 @@ from lifx_emulator.factories import (
     create_hev_light,
     create_infrared_light,
     create_multizone_light,
+    create_switch,
     create_tile_device,
 )
 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",
@@ -239,6 +239,7 @@ async def run(
     hev: Annotated[int, cyclopts.Parameter(group=device_group)] = 0,
     multizone: Annotated[int, cyclopts.Parameter(group=device_group)] = 0,
     tile: Annotated[int, cyclopts.Parameter(group=device_group)] = 0,
+    switch: Annotated[int, cyclopts.Parameter(group=device_group)] = 0,
     # Multizone Options
     multizone_zones: Annotated[
         int | None, cyclopts.Parameter(group=multizone_group)
@@ -284,6 +285,7 @@ async def run(
         multizone_extended: Enable extended multizone support (Beam).
             Set --no-multizone-extended for basic multizone (Z) devices.
         tile: Number of tile/matrix chain devices.
+        switch: Number of LIFX Switch devices (relays, no lighting).
         tile_count: Number of tiles per device. Uses product defaults if not
             specified (5 for Tile, 1 for Candle/Ceiling).
         tile_width: Width of each tile in zones. Uses product defaults if not
@@ -310,7 +312,7 @@ async def run(
             lifx-emulator --color 2 --multizone 1 --tile 1 --api --verbose
 
         Create only specific device types:
-            lifx-emulator --color 0 --infrared 3 --hev 2
+            lifx-emulator --color 0 --infrared 3 --hev 2 --switch 2
 
         Custom serial prefix:
             lifx-emulator --serial-prefix cafe00 --color 5
@@ -410,6 +412,7 @@ async def run(
                 and infrared == 0
                 and hev == 0
                 and multizone == 0
+                and switch == 0
             ):
                 color = 0
 
@@ -423,6 +426,7 @@ async def run(
             and hev == 0
             and multizone == 0
             and tile == 0
+            and switch == 0
         ):
             color = 0
 
@@ -467,13 +471,17 @@ async def run(
                 )
             )
 
+        # Create switch devices
+        for _ in range(switch):
+            devices.append(create_switch(get_serial(), storage=storage))
+
     if not devices:
         if persistent:
             logger.warning("No devices configured. Server will run with no devices.")
             logger.info("Use API (--api) or restart with device flags to add devices.")
         else:
             logger.error(
-                "No devices configured. Use --color, --multizone, --tile, "
+                "No devices configured. Use --color, --multizone, --tile, --switch, "
                 "etc. to add devices."
             )
             return
@@ -520,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.3.1/src/lifx_emulator → lifx_emulator-3.0.1/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.3.1/src/lifx_emulator → lifx_emulator-3.0.1/src/lifx_emulator_app}/api/app.py

@@ -19,9 +19,9 @@ 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__)
 

{lifx_emulator-2.3.1/src/lifx_emulator → lifx_emulator-3.0.1/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.3.1/src/lifx_emulator → lifx_emulator-3.0.1/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.3.1/src/lifx_emulator → lifx_emulator-3.0.1/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.0.1/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.3.1/src/lifx_emulator → lifx_emulator-3.0.1/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.3.1/src/lifx_emulator → lifx_emulator-3.0.1/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.3.1/src/lifx_emulator → lifx_emulator-3.0.1/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.0.1/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.3.1/src/lifx_emulator → lifx_emulator-3.0.1/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__)
 
 

lifx_emulator-3.0.1/tests/conftest.py

@@ -0,0 +1,9 @@
+"""Pytest configuration for LIFX Emulator App tests."""
+
+import pytest
+
+
+@pytest.fixture
+def anyio_backend():
+    """Use asyncio for async tests."""
+    return "asyncio"

{lifx_emulator-2.3.1 → lifx_emulator-3.0.1}/tests/test_api.py

@@ -2,12 +2,11 @@
 
 import pytest
 from fastapi.testclient import TestClient
-
-from lifx_emulator.api import create_api_app
 from lifx_emulator.devices.manager import DeviceManager
 from lifx_emulator.factories import create_color_light, create_multizone_light
 from lifx_emulator.repositories import DeviceRepository
 from lifx_emulator.server import EmulatedLifxServer
+from lifx_emulator_app.api import create_api_app
 
 
 @pytest.fixture
@@ -725,7 +724,7 @@ class TestRunAPIServer:
         """Test that run_api_server creates uvicorn server with correct config."""
         from unittest.mock import AsyncMock, Mock
 
-        from lifx_emulator.api.app import run_api_server
+        from lifx_emulator_app.api.app import run_api_server
 
         # Mock uvicorn components
         mock_server_instance = Mock()
@@ -768,7 +767,7 @@ class TestRunAPIServer:
         """Test that run_api_server uses default host and port."""
         from unittest.mock import AsyncMock, Mock
 
-        from lifx_emulator.api.app import run_api_server
+        from lifx_emulator_app.api.app import run_api_server
 
         # Mock uvicorn components
         mock_server_instance = Mock()

{lifx_emulator-2.3.1 → lifx_emulator-3.0.1}/tests/test_api_validation.py

@@ -1,10 +1,9 @@
 """Tests for API input validation using Pydantic models."""
 
 import pytest
+from lifx_emulator_app.api.models import ColorHsbk, DeviceCreateRequest
 from pydantic import ValidationError
 
-from lifx_emulator.api.models import ColorHsbk, DeviceCreateRequest
-
 
 class TestDeviceCreateRequestValidation:
     """Test DeviceCreateRequest validation."""