Merge pull request #47 from jbchouinard/limitlessled

Add support for v6 RGB+CCT 8 Zone lights

Author: happyleavesaoc

.github/workflows/python.yaml

@@ -0,0 +1,37 @@
+name: Python
+on:
+  - push
+  - pull_request
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: astral-sh/ruff-action@v3
+        name: Ruff check format
+        with:
+          args: "format --check --diff"
+      - uses: astral-sh/ruff-action@v3
+        name: Ruff check
+        with:
+          args: "check"
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install tox tox-gh-actions
+    - name: Test with tox
+      run: tox

.gitignore

@@ -1,3 +1,6 @@
+# asdf config
+.tool-versions
+
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
@@ -24,6 +27,8 @@ wheels/
 *.egg-info/
 .installed.cfg
 *.egg
+.ruff_cache
+poetry.lock
 
 # PyInstaller
 #  Usually these files are written by a python script from a template
@@ -78,6 +83,7 @@ celerybeat-schedule
 
 # dotenv
 .env
+.envrc
 
 # virtualenv
 .venv/

.travis.yml

@@ -1,6 +1,7 @@
 The MIT License (MIT)
 
-Copyright (c) 2015 happyleavesaoc
+Copyright (c) 2015-2021 happyleavesaoc
+Copyright (c) 2025 Jerome Boisvert-Chouinard
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

LICENSE

@@ -1,8 +1,18 @@
-[![Build Status](https://travis-ci.org/happyleavesaoc/python-limitlessled.svg?branch=master)](https://travis-ci.org/happyleavesaoc/python-limitlessled) [![PyPI version](https://badge.fury.io/py/limitlessled.svg)](https://badge.fury.io/py/limitlessled)
-
 # python-limitlessled
 
-`python-limitlessled` controls LimitlessLED bridges. It supports `white`, `rgbw` and `rgbww` bulb groups as well as the `bridge-led` of newer wifi bridges.
+[![PyPI version](https://img.shields.io/pypi/v/litmitlessled.svg)](https://pypi.org/project/limitlessled/)
+[![Python Tests](https://github.com/happyleavesaoc/python-limitlessled/actions/workflows/python.yaml/badge.svg)](https://github.com/happyleavesaoc/python-limitlessled/actions/workflows/python.yaml)
+
+`python-limitlessled` controls LimitlessLED bridges (sold under various brand names such as MiLight, MiBoxer, EasyBulb, etc.).
+It supports `white`, `rgbw`, `rgbww`, and `rgbcct` bulb groups as well as the `bridge-led` of newer wifi bridges.
+
+Light types:
+- `white`: White bulbs, 4 zones
+- `rgbw`: RGB + white bulbs , 4 zones
+- `rgbww`: RGB + cool/warm white bulbs, 4 zones
+- `rgbcct`: Newer RGB+CCT bulbs and LED strip controllers, 8 zones
+- `bridge-led`: Integrated LED on newer WiFi bridges
+
 ## Install
 `pip install limitlessled`
 
@@ -13,6 +23,7 @@ Your bridge(s) must be set up and bulbs joined prior to using this module.
 Group names can be any string, but must be unique amongst all bridges.
 ```python
 from limitlessled.bridge import Bridge
+from limitlessled.group.rgbcct import RGBCCT
 from limitlessled.group.rgbw import RGBW
 from limitlessled.group.rgbww import RGBWW
 from limitlessled.group.white import WHITE
@@ -23,6 +34,8 @@ bridge.add_group(1, 'bedroom', RGBW)
 bridge.add_group(2, 'bathroom', WHITE)
 bridge.add_group(2, 'living_room', RGBW)
 bridge.add_group(2, 'kitchen', RGBWW)
+# RGBCCT supports up to 8 zones (groups)
+bridge.add_group(6, 'office', RGBCCT)
 ```
 
 Get access to groups either via the return value of `add_group`, or with the `LimitlessLED` object.
@@ -88,7 +101,7 @@ pipeline = Pipeline() \
     .on() \
     .brightness(0.7) \
     .color(0, 0, 255) \
-    .transition(color=Color(255, 0, 0))
+    .transition(3, color=Color(255, 0, 0))
 
 bedroom.enqueue(pipeline)
 ```

Makefile

@@ -0,0 +1,29 @@
+from limitlessled import Color
+from limitlessled.bridge import Bridge
+from limitlessled.group.rgbcct import RGBCCT
+from limitlessled.group.rgbw import RGBW
+from limitlessled.group.rgbww import RGBWW
+from limitlessled.group.white import WHITE
+from limitlessled.pipeline import Pipeline
+
+bridge = Bridge("<your bridge ip address>")
+bedroom = bridge.add_group(1, "bedroom", RGBW)
+# A group number can support two groups as long as the types differ
+bathroom = bridge.add_group(2, "bathroom", WHITE)
+living_room = bridge.add_group(2, "living_room", RGBW)
+kitchen = bridge.add_group(2, "kitchen", RGBWW)
+# RGBCCT supports up to 8 zones (groups)
+office = bridge.add_group(6, "office", RGBCCT)
+
+selected = office
+commands = (
+    Pipeline()
+    .off()
+    .wait(3)
+    .on()
+    .brightness(0.7)
+    .color(0, 0, 255)
+    .transition(3, color=Color(255, 0, 0))
+)
+selected.enqueue(commands)
+bridge.finish()

README.md

@@ -1,10 +1,10 @@
-""" LimitlessLED.
+"""LimitlessLED.
 
 http://www.limitlessled.com
 """
 
-import logging
 from collections import namedtuple
+import logging
 
 _LOGGER = logging.getLogger(__name__)
 
@@ -20,21 +20,22 @@
 
 
 class LimitlessLED(object):
-    """ Represents a LimitlessLED installation. """
+    """Represents a LimitlessLED installation."""
+
     def __init__(self):
-        """ Initialize. """
+        """Initialize."""
         self._groups = {}
 
     def group(self, name):
-        """ Fetch a named group.
+        """Fetch a named group.
 
         :param name: Name of group.
         :returns: Group.
         """
         return self._groups[name]
 
     def add_bridge(self, bridge):
-        """ Add bridge groups.
+        """Add bridge groups.
 
         :param bridge: Add groups from this bridge.
         """