tinkly 0.2.0__tar.gz → 0.2.1__tar.gz

tinkly-0.2.1/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: tinkly
+Version: 0.2.1
+Summary: Low-level Twinkly discovery, authentication, HTTP, and realtime UDP transport
+Author-email: Tom Ritchford <tom@swirly.com>
+Project-URL: Documentation, https://rec.github.io/tinkly/
+Project-URL: Repository, https://github.com/rec/tinkly
+Project-URL: Issues, https://github.com/rec/tinkly/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# tinkly: a tiny interface to Twinkly v2 lights
+
+I love the Twinkly lights but the [xled library](https://github.com/scrool/xled) is
+filled with complicated cruft which obscures the actual communication layer, and seems
+to no longer be in development.
+
+In particular, xled has a totally unnecessary ZMQ queue that
+slows everything down and prevents two clients from existing.
+
+I re-implemented just the Twinkly communication part, and left all the other
+parts behind. In particular, there is no CLI - for that, you'll have to see my
+upcoming general project, "lyte".
+
+## Device communication
+
+This package provides UDP discovery, authentication, HTTP endpoint access for generation
+2 Twinkly lights.
+
+```python
+from tinkly.client import TwinklyClient
+from tinkly.discovery import discover
+from tinkly.frame import send_frame
+
+devices = list(discover(timeout=2.0))
+client = TwinklyClient(host=devices[0].ip_address)
+info = client.get('gestalt', authenticated=False).data
+client.mac = str(info['mac'])
+token = client.authenticate()
+
+client.set_realtime_mode()
+frame = bytes((255, 0, 0)) * int(str(info['number_of_led']))
+send_frame(client.host, token.value, frame)
+client.set_off_mode()
+```
+
+## Frame buffers
+
+`lyte` uses `numpy`, but I decided not to make that a dependency. Instead, we use
+Python's buffer protocol `collections.abc.Buffer`. The input is C-style unsigned bytes
+in RGB order, with three bytes per LED.  Supported inputs include `bytes`, `bytearray`,
+`array.array('B')`, `memoryview`, and C-contiguous NumPy `uint8` arrays.
+
+## The API
+
+https://rec.github.io/tinkly/

{tinkly-0.2.0 → tinkly-0.2.1}/pyproject.toml

@@ -4,9 +4,23 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tinkly"
-version = "0.2.0"
+version = "0.2.1"
 description = "Low-level Twinkly discovery, authentication, HTTP, and realtime UDP transport"
+readme = "README.md"
+authors = [{ name = "Tom Ritchford", email = "tom@swirly.com" }]
 requires-python = ">=3.12"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+]
+
+[project.urls]
+Documentation = "https://rec.github.io/tinkly/"
+Repository = "https://github.com/rec/tinkly"
+Issues = "https://github.com/rec/tinkly/issues"
 
 [tool.setuptools.packages.find]
 where = ["."]
@@ -15,8 +29,12 @@ include = ["tinkly*"]
 [tool.ruff.format]
 quote-style = "single"
 
+[tool.ruff.lint]
+select = ["B", "E", "F", "I"]
+
 [tool.pytest.ini_options]
 pythonpath = ["."]
+testpaths = ["tests"]
 
 [dependency-groups]
 dev = [
@@ -29,6 +47,9 @@ dev = [
     "tyro",
 ]
 
+[tool.uv]
+exclude-newer = "1 week"
+
 [tool.uv.sources]
 reccy = { git = "ssh://git@github.com/rec/reccy.git", branch = "main" }
 

tinkly-0.2.1/tinkly.egg-info/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: tinkly
+Version: 0.2.1
+Summary: Low-level Twinkly discovery, authentication, HTTP, and realtime UDP transport
+Author-email: Tom Ritchford <tom@swirly.com>
+Project-URL: Documentation, https://rec.github.io/tinkly/
+Project-URL: Repository, https://github.com/rec/tinkly
+Project-URL: Issues, https://github.com/rec/tinkly/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# tinkly: a tiny interface to Twinkly v2 lights
+
+I love the Twinkly lights but the [xled library](https://github.com/scrool/xled) is
+filled with complicated cruft which obscures the actual communication layer, and seems
+to no longer be in development.
+
+In particular, xled has a totally unnecessary ZMQ queue that
+slows everything down and prevents two clients from existing.
+
+I re-implemented just the Twinkly communication part, and left all the other
+parts behind. In particular, there is no CLI - for that, you'll have to see my
+upcoming general project, "lyte".
+
+## Device communication
+
+This package provides UDP discovery, authentication, HTTP endpoint access for generation
+2 Twinkly lights.
+
+```python
+from tinkly.client import TwinklyClient
+from tinkly.discovery import discover
+from tinkly.frame import send_frame
+
+devices = list(discover(timeout=2.0))
+client = TwinklyClient(host=devices[0].ip_address)
+info = client.get('gestalt', authenticated=False).data
+client.mac = str(info['mac'])
+token = client.authenticate()
+
+client.set_realtime_mode()
+frame = bytes((255, 0, 0)) * int(str(info['number_of_led']))
+send_frame(client.host, token.value, frame)
+client.set_off_mode()
+```
+
+## Frame buffers
+
+`lyte` uses `numpy`, but I decided not to make that a dependency. Instead, we use
+Python's buffer protocol `collections.abc.Buffer`. The input is C-style unsigned bytes
+in RGB order, with three bytes per LED.  Supported inputs include `bytes`, `bytearray`,
+`array.array('B')`, `memoryview`, and C-contiguous NumPy `uint8` arrays.
+
+## The API
+
+https://rec.github.io/tinkly/

{tinkly-0.2.0 → tinkly-0.2.1}/uv.lock

@@ -7,7 +7,7 @@ resolution-markers = [
 ]
 
 [options]
-exclude-newer = "2026-11-04T19:29:17.139037Z"
+exclude-newer = "2026-11-04T19:32:54.323936Z"
 exclude-newer-span = "P1W"
 
 [[package]]
@@ -327,7 +327,7 @@ wheels = [
 
 [[package]]
 name = "tinkly"
-version = "0.2.0"
+version = "0.2.1"
 source = { editable = "." }
 
 [package.dev-dependencies]

tinkly-0.2.0/PKG-INFO

@@ -1,5 +0,0 @@
-Metadata-Version: 2.4
-Name: tinkly
-Version: 0.2.0
-Summary: Low-level Twinkly discovery, authentication, HTTP, and realtime UDP transport
-Requires-Python: >=3.12

tinkly-0.2.0/tinkly.egg-info/PKG-INFO

@@ -1,5 +0,0 @@
-Metadata-Version: 2.4
-Name: tinkly
-Version: 0.2.0
-Summary: Low-level Twinkly discovery, authentication, HTTP, and realtime UDP transport
-Requires-Python: >=3.12