lifx-emulator-core 3.0.1__tar.gz

lifx_emulator_core-3.0.1/.gitignore

@@ -0,0 +1,94 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# Distribution / packaging
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.python-version
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+.hypothesis/
+junit.xml
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pytype/
+pyrightconfig.json
+
+# Ruff
+.ruff_cache/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+*.ipynb
+
+# Documentation
+docs/_build/
+site/
+
+# Build artifacts
+*.prof
+*.lprof
+
+# OS
+.DS_Store
+Thumbs.db
+.Spotlight-V100
+.Trashes
+
+# Temporary files
+*.tmp
+*.bak
+*.log
+.cache/
+
+# Local storage
+.notes/
+.claude/settings.local.json

lifx_emulator_core-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_core-3.0.1/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: lifx-emulator-core
+Version: 3.0.1
+Summary: Core LIFX Emulator library 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
+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: Topic :: Software Development :: Testing
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: pyyaml>=6.0.3
+Description-Content-Type: text/markdown
+
+# lifx-emulator-core
+
+Core Python library for emulating LIFX devices using the LAN protocol.
+
+This package provides the embeddable library for creating virtual LIFX devices in your own projects. It implements the binary UDP protocol from the [LIFX LAN Protocol](https://lan.developer.lifx.com) specification.
+
+## Installation
+
+```bash
+pip install lifx-emulator-core
+```
+
+## Quick Start
+
+```python
+import asyncio
+from lifx_emulator import EmulatedLifxServer, DeviceManager
+from lifx_emulator.factories import create_color_light
+from lifx_emulator.repositories import DeviceRepository
+
+async def main():
+    # Create devices
+    devices = [
+        create_color_light(serial="d073d5000001"),
+        create_color_light(serial="d073d5000002"),
+    ]
+
+    # Create repository and manager
+    repository = DeviceRepository()
+    manager = DeviceManager(repository)
+
+    # Start the emulator server
+    server = EmulatedLifxServer(
+        devices=devices,
+        device_manager=manager,
+        bind_address="127.0.0.1",
+        port=56700,
+    )
+
+    await server.start()
+    print("LIFX Emulator running on 127.0.0.1:56700")
+
+    # Keep running until interrupted
+    try:
+        await asyncio.Event().wait()
+    finally:
+        await server.stop()
+
+asyncio.run(main())
+```
+
+## Features
+
+- Emulate color lights, multizone strips, tiles, infrared, HEV, and switch devices
+- Full LIFX LAN protocol implementation
+- Persistent device state storage
+- Testing scenarios for simulating edge cases
+- Product registry with 137+ official LIFX products
+
+## Documentation
+
+Full documentation is available at: **https://djelibeybi.github.io/lifx-emulator**
+
+- [Installation Guide](https://djelibeybi.github.io/lifx-emulator/getting-started/installation/)
+- [Quick Start](https://djelibeybi.github.io/lifx-emulator/getting-started/quickstart/)
+- [API Reference](https://djelibeybi.github.io/lifx-emulator/library/)
+- [Architecture](https://djelibeybi.github.io/lifx-emulator/architecture/)
+
+## Related Packages
+
+- **[lifx-emulator](https://pypi.org/project/lifx-emulator/)**: Standalone CLI tool and HTTP management API built on this library
+
+## License
+
+[UPL-1.0](https://opensource.org/licenses/UPL)

lifx_emulator_core-3.0.1/README.md

@@ -0,0 +1,75 @@
+# lifx-emulator-core
+
+Core Python library for emulating LIFX devices using the LAN protocol.
+
+This package provides the embeddable library for creating virtual LIFX devices in your own projects. It implements the binary UDP protocol from the [LIFX LAN Protocol](https://lan.developer.lifx.com) specification.
+
+## Installation
+
+```bash
+pip install lifx-emulator-core
+```
+
+## Quick Start
+
+```python
+import asyncio
+from lifx_emulator import EmulatedLifxServer, DeviceManager
+from lifx_emulator.factories import create_color_light
+from lifx_emulator.repositories import DeviceRepository
+
+async def main():
+    # Create devices
+    devices = [
+        create_color_light(serial="d073d5000001"),
+        create_color_light(serial="d073d5000002"),
+    ]
+
+    # Create repository and manager
+    repository = DeviceRepository()
+    manager = DeviceManager(repository)
+
+    # Start the emulator server
+    server = EmulatedLifxServer(
+        devices=devices,
+        device_manager=manager,
+        bind_address="127.0.0.1",
+        port=56700,
+    )
+
+    await server.start()
+    print("LIFX Emulator running on 127.0.0.1:56700")
+
+    # Keep running until interrupted
+    try:
+        await asyncio.Event().wait()
+    finally:
+        await server.stop()
+
+asyncio.run(main())
+```
+
+## Features
+
+- Emulate color lights, multizone strips, tiles, infrared, HEV, and switch devices
+- Full LIFX LAN protocol implementation
+- Persistent device state storage
+- Testing scenarios for simulating edge cases
+- Product registry with 137+ official LIFX products
+
+## Documentation
+
+Full documentation is available at: **https://djelibeybi.github.io/lifx-emulator**
+
+- [Installation Guide](https://djelibeybi.github.io/lifx-emulator/getting-started/installation/)
+- [Quick Start](https://djelibeybi.github.io/lifx-emulator/getting-started/quickstart/)
+- [API Reference](https://djelibeybi.github.io/lifx-emulator/library/)
+- [Architecture](https://djelibeybi.github.io/lifx-emulator/architecture/)
+
+## Related Packages
+
+- **[lifx-emulator](https://pypi.org/project/lifx-emulator/)**: Standalone CLI tool and HTTP management API built on this library
+
+## License
+
+[UPL-1.0](https://opensource.org/licenses/UPL)

lifx_emulator_core-3.0.1/pyproject.toml

@@ -0,0 +1,102 @@
+[project]
+name = "lifx-emulator-core"
+version = "3.0.1"
+description = "Core LIFX Emulator library for testing LIFX LAN protocol libraries"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "pyyaml>=6.0.3",
+]
+license = "UPL-1.0"
+license-files = ["LICENSE"]
+authors = [
+    {name = "Avi Miller", email = "me@dje.li"}
+]
+maintainers = [
+    {name = "Avi Miller", email = "me@dje.li"}
+]
+classifiers = [
+    "Framework :: AsyncIO",
+    "Framework :: Pytest",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "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"
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/lifx_emulator"]
+
+[tool.pyright]
+typeCheckingMode = "standard"
+pythonVersion = "3.11"
+include = ["src"]
+exclude = ["**/__pycache__"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+
+[tool.semantic_release]
+commit_parser = "conventional-monorepo"
+commit_message = """\
+chore(release): lifx-emulator-core@{version}`
+
+Automatically generated by python-semantic-release
+"""
+tag_format = "core-v{version}"
+version_toml = ["pyproject.toml:project.version"]
+build_command = """
+    uv lock --upgrade-package "$PACKAGE_NAME"
+    git add ../../uv.lock
+    uv build --package lifx-emulator-core --out-dir dist/
+"""
+
+[tool.semantic_release.commit_parser_options]
+path_filters = ["."]
+scope_prefix = "core-"
+
+[tool.semantic_release.branches.main]
+match = "main"
+prerelease = false
+
+[tool.semantic_release.branches.dev]
+match = "(?!main$).*"
+prerelease = true
+prerelease_token = "dev"
+
+[tool.semantic_release.changelog]
+# Recommended patterns for conventional commits parser that is scope aware
+exclude_commit_patterns = [
+    '''chore(?:\([^)]*?\))?: .+''',
+    '''ci(?:\([^)]*?\))?: .+''',
+    '''refactor(?:\([^)]*?\))?: .+''',
+    '''style(?:\([^)]*?\))?: .+''',
+    '''test(?:\([^)]*?\))?: .+''',
+    '''build\((?!deps\): .+)''',
+    '''Initial [Cc]ommit.*''',
+]
+
+
+[tool.semantic_release.changelog.default_templates]
+changelog_file = "CHANGELOG.md"
+output_format = "md"
+
+[tool.semantic_release.remote]
+ignore_token_for_push = true

lifx_emulator_core-3.0.1/src/lifx_emulator/__init__.py

@@ -0,0 +1,31 @@
+"""LIFX Emulator
+
+A comprehensive LIFX emulator for testing LIFX LAN protocol libraries.
+Implements the binary UDP protocol documented at https://lan.developer.lifx.com
+"""
+
+from importlib.metadata import version as get_version
+
+from lifx_emulator.devices import EmulatedLifxDevice
+from lifx_emulator.factories import (
+    create_color_light,
+    create_color_temperature_light,
+    create_hev_light,
+    create_infrared_light,
+    create_multizone_light,
+    create_tile_device,
+)
+from lifx_emulator.server import EmulatedLifxServer
+
+__version__ = get_version("lifx-emulator-core")
+
+__all__ = [
+    "EmulatedLifxServer",
+    "EmulatedLifxDevice",
+    "create_color_light",
+    "create_color_temperature_light",
+    "create_hev_light",
+    "create_infrared_light",
+    "create_multizone_light",
+    "create_tile_device",
+]

lifx_emulator_core-3.0.1/src/lifx_emulator/constants.py

@@ -0,0 +1,33 @@
+"""Protocol constants for LIFX LAN Protocol"""
+
+from typing import Final
+
+# ============================================================================
+# Network Constants
+# ============================================================================
+
+# LIFX UDP port for device communication
+LIFX_UDP_PORT: Final[int] = 56700
+
+# LIFX Protocol version
+LIFX_PROTOCOL_VERSION: Final[int] = 1024
+
+# Header size in bytes
+LIFX_HEADER_SIZE: Final[int] = 36
+
+# Backward compatibility alias
+HEADER_SIZE = LIFX_HEADER_SIZE
+
+# ============================================================================
+# Official LIFX Repository URLs
+# ============================================================================
+
+# Official LIFX protocol specification URL
+PROTOCOL_URL: Final[str] = (
+    "https://raw.githubusercontent.com/LIFX/public-protocol/refs/heads/main/protocol.yml"
+)
+
+# Official LIFX products specification URL
+PRODUCTS_URL: Final[str] = (
+    "https://raw.githubusercontent.com/LIFX/products/refs/heads/master/products.json"
+)

lifx_emulator_core-3.0.1/src/lifx_emulator/devices/__init__.py

@@ -0,0 +1,37 @@
+"""Device management module for LIFX emulator.
+
+This module contains all device-related functionality including:
+- Device core (EmulatedLifxDevice)
+- Device manager (DeviceManager, IDeviceManager)
+- Device states (DeviceState and related dataclasses)
+- Device persistence (async file storage)
+- State restoration and serialization
+- Device state observers (ActivityObserver, ActivityLogger, PacketEvent, NullObserver)
+"""
+
+from lifx_emulator.devices.device import EmulatedLifxDevice
+from lifx_emulator.devices.manager import DeviceManager, IDeviceManager
+from lifx_emulator.devices.observers import (
+    ActivityLogger,
+    ActivityObserver,
+    NullObserver,
+    PacketEvent,
+)
+from lifx_emulator.devices.persistence import (
+    DEFAULT_STORAGE_DIR,
+    DevicePersistenceAsyncFile,
+)
+from lifx_emulator.devices.states import DeviceState
+
+__all__ = [
+    "EmulatedLifxDevice",
+    "DeviceManager",
+    "IDeviceManager",
+    "DeviceState",
+    "DevicePersistenceAsyncFile",
+    "DEFAULT_STORAGE_DIR",
+    "ActivityObserver",
+    "ActivityLogger",
+    "PacketEvent",
+    "NullObserver",
+]