LIFX Emulator for testing LIFX LAN protocol libraries
Project description
LIFX Emulator
A comprehensive LIFX device emulator for testing LIFX LAN protocol libraries
Overview
LIFX Emulator implements the complete binary UDP protocol from 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 - Get started
- Quick Start - Your first emulated device
- User Guide - Product specifications and testing scenarios
- Advanced Topics - REST API and persistent storage
- CLI Reference - All CLI options
- Device Types - Supported devices
- API Reference - Complete API docs
- Architecture - 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
# 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
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file lifx_emulator-2.2.1.tar.gz.
File metadata
- Download URL: lifx_emulator-2.2.1.tar.gz
- Upload date:
- Size: 338.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
622f867df53d4778c26546511ef64e856b1a252ecedd9c4a85d67dd243726df9
|
|
| MD5 |
05fc4bf26996e8773b5e71ac22ac8c6e
|
|
| BLAKE2b-256 |
0092de646f88279bbb3464097d4d54aab09606559317f31d6544d186f8c45ba9
|
Provenance
The following attestation bundles were made for lifx_emulator-2.2.1.tar.gz:
Publisher:
ci.yml on Djelibeybi/lifx-emulator
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lifx_emulator-2.2.1.tar.gz -
Subject digest:
622f867df53d4778c26546511ef64e856b1a252ecedd9c4a85d67dd243726df9 - Sigstore transparency entry: 707074217
- Sigstore integration time:
-
Permalink:
Djelibeybi/lifx-emulator@70b2d48c1ee037591688abb345020e0cd515d2f1 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Djelibeybi
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@70b2d48c1ee037591688abb345020e0cd515d2f1 -
Trigger Event:
push
-
Statement type:
File details
Details for the file lifx_emulator-2.2.1-py3-none-any.whl.
File metadata
- Download URL: lifx_emulator-2.2.1-py3-none-any.whl
- Upload date:
- Size: 125.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
796fce1bf718c2c5bb389e65d332aa11049b1bcc1f5f97a84a3847df1eb097b4
|
|
| MD5 |
58a0e8daf836a1bba9e441f04c9c0d4e
|
|
| BLAKE2b-256 |
3c7925bc5eb0cdd1c124566d01335da27ac20680c0ee3368de86614087e4be18
|
Provenance
The following attestation bundles were made for lifx_emulator-2.2.1-py3-none-any.whl:
Publisher:
ci.yml on Djelibeybi/lifx-emulator
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lifx_emulator-2.2.1-py3-none-any.whl -
Subject digest:
796fce1bf718c2c5bb389e65d332aa11049b1bcc1f5f97a84a3847df1eb097b4 - Sigstore transparency entry: 707074228
- Sigstore integration time:
-
Permalink:
Djelibeybi/lifx-emulator@70b2d48c1ee037591688abb345020e0cd515d2f1 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Djelibeybi
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@70b2d48c1ee037591688abb345020e0cd515d2f1 -
Trigger Event:
push
-
Statement type:
