fastled 2.0.9__py3-none-win_amd64.whl

fastled/__init__.py

@@ -0,0 +1,5 @@
+"""Python compatibility package for the native FastLED Rust CLI."""
+
+from .__version__ import __version__
+
+__all__ = ["__version__"]

fastled/__main__.py

@@ -0,0 +1,14 @@
+#!/usr/bin/env python3
+"""
+FastLED Package Main Entry Point
+Enables running the package as: python -m fastled
+"""
+
+import sys
+
+from fastled.cli import main
+
+if __name__ == "__main__":
+    # Pass execution to the main function from cli.py
+    # This enables 'python -m fastled' to work the same as 'fastled' command
+    sys.exit(main())

fastled/__version__.py

@@ -0,0 +1,2 @@
+# Version is read directly from this file by the GitHub Actions release workflow.
+__version__ = "2.0.9"

fastled/_rust_cli.py

@@ -0,0 +1,100 @@
+"""Locate the native Rust ``fastled`` binary.
+
+Wheel-installed deployments bundle the Rust binary under ``fastled/bin``.
+Editable dev installs usually resolve the binary from ``target/`` after a
+local ``soldr cargo build --bin fastled``.
+
+Search order:
+    1. Package-local ``fastled/bin/fastled[.exe]`` (wheel install).
+    2. Workspace ``target/{release,debug}/fastled[.exe]`` (dev / editable).
+    3. ``$CARGO_HOME/bin/fastled[.exe]`` (where ``cargo-binstall`` installs).
+"""
+
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+
+def _exe_name() -> str:
+    return "fastled.exe" if sys.platform == "win32" else "fastled"
+
+
+def _find_workspace_root() -> Path | None:
+    current = Path(__file__).resolve().parent
+    for _ in range(10):
+        if (current / "Cargo.toml").is_file():
+            return current
+        parent = current.parent
+        if parent == current:
+            break
+        current = parent
+    return None
+
+
+def find_rust_fastled_cli() -> Path | None:
+    """Return the path to the Rust ``fastled`` binary, or ``None``."""
+    exe = _exe_name()
+
+    # 1. Wheel-bundled native binary.
+    candidate = Path(__file__).resolve().parent / "bin" / exe
+    if candidate.is_file():
+        return candidate
+
+    # 2. Workspace target/ tree (dev / editable).
+    workspace_root = _find_workspace_root()
+    if workspace_root is not None:
+        for profile in ("release", "debug"):
+            candidate = workspace_root / "target" / profile / exe
+            if candidate.is_file():
+                return candidate
+        target_dir = workspace_root / "target"
+        if target_dir.is_dir():
+            for arch_dir in target_dir.iterdir():
+                if arch_dir.is_dir() and not arch_dir.name.startswith("."):
+                    for profile in ("release", "debug"):
+                        candidate = arch_dir / profile / exe
+                        if candidate.is_file():
+                            return candidate
+
+    # 3. cargo-binstall install location.
+    cargo_home = os.environ.get("CARGO_HOME")
+    if cargo_home:
+        candidate = Path(cargo_home) / "bin" / exe
+        if candidate.is_file():
+            return candidate
+    candidate = Path.home() / ".cargo" / "bin" / exe
+    if candidate.is_file():
+        return candidate
+
+    return None
+
+
+def invoke_rust_fastled_cli(argv: list[str] | None = None) -> int:
+    """Run the Rust FastLED CLI and return its exit code."""
+    args = list(argv or [])
+    env = os.environ.copy()
+    env.setdefault("FASTLED_PYTHON_EXECUTABLE", sys.executable)
+
+    cli = find_rust_fastled_cli()
+    if cli is not None:
+        return subprocess.run([str(cli), *args], check=False, env=env).returncode
+
+    workspace_root = _find_workspace_root()
+    if workspace_root is not None:
+        soldr = shutil.which("soldr")
+        if soldr is None:
+            raise RuntimeError(
+                "soldr is required to build the Rust fastled CLI binary."
+            )
+        return subprocess.run(
+            [soldr, "cargo", "run", "--quiet", "--bin", "fastled", "--", *args],
+            check=False,
+            cwd=workspace_root,
+            env=env,
+        ).returncode
+
+    raise RuntimeError("Could not locate the Rust fastled CLI binary.")

fastled/app.py

@@ -0,0 +1,14 @@
+"""Compatibility entry point that forwards to the native Rust CLI."""
+
+import sys
+
+from fastled._rust_cli import invoke_rust_fastled_cli
+
+
+def main() -> int:
+    """Run the native Rust CLI with the current argv."""
+    return invoke_rust_fastled_cli(sys.argv[1:])
+
+
+if __name__ == "__main__":
+    sys.exit(main())

fastled/assets/example.txt

@@ -0,0 +1 @@
+Example assets that will be deployed with python code.

fastled/assets/localhost-key.pem

@@ -0,0 +1,28 @@
+-----BEGIN PRIVATE KEY-----
+MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDlxbWcpUXPpjqs
+DJPgFF1FsXPZqq0JPJqssHh4ZLfN0h4yJmj+kRcHS+pkgXnG46g6bUcL/AK5Ba08
+vwnUUGkPH0v4ShKiAGYwvOcbWaqTmvvJuIoaDBXh2jSCeOTagNoaHLYEugARkkEu
+0/FEW5P/79wU5vJ5G+SyZ8rBCVdxlU57pL1hKWBU7K+BLWsCiZ308NMpzHF5APZ6
+YxVjhFosJPr4TjN6yXr+whrsAjSTHamD5690MbXWyyPG0jwPQyjBot/cNtt8GrsN
+gcjA1E+8VKFvxO8RvZanMZLb0CGEpt7u3oaJ/jprHEsw+/UhnG6Qhksm8C/DN9kP
+hselewffAgMBAAECggEARjQ6YTo+Mkvf8WGGbRjLxteJRiBX7lKOD+V7aY2ce06P
+21LREbbTCm+vljXZN2OnqvJomsjNLCsH21+jaTOIZg5x79LyDn2Au7N8CWdELwVT
+mTbBO2Ql63P4R0UY54onGYNcOeV6z+OX9u7a8L/qYHCxFdHalBZpsfj0gjaQeStJ
+JSnvGjo6tKkwC/nUmX01qEVQgUO1+39WYqCaIWjijZNXt6XiKclEuu1AkL0u6Mpt
+CzvzEDrEA66D0Lvl3Tek9B4O16Oie5anNnNMHigwU9yVc6dI8vDCRSEiz7laPTFK
+xzOCQmqPGClKXkX3U+OvZp/Ss9U26Wpu0AbRKTvzAQKBgQDsMR9NjMpOmUaWkAwl
+1wlUxsZ9YkRuTy7R3RfIdYWj6Lcoc4/iN0qILFM7xidkHhYTFqnsnP1SQkV6lEHV
+OalYxZu9F2l1rHPc8G5YWh/KOg1rAEI47MVT4iwhA2fw6JLti/rm25AeSTMjSTqu
+ht3146036opcIF3v86oGUrSXDwKBgQD5CsNcwLeUDGXozjq62T8/mTYwd2Tw3aiY
+KaGp+exAW321vYm5SKsMitBMGU2tGFlv5eptSI48h7SCpgnszaexw7yj30KuvqjG
+bBqq/MsKuXHyn2sG0A7MJ6zfk+4l46B45blDJZ+x7xL0dyS4UCU3zUeesgSGo4zK
+ZOspPIQCMQKBgQCk35VuWP1P6IbxyxPvxi/pUeh01gfWyMdyD9fuQrtLM8PHJQQn
+cVlBvU9MxoHwzV+za3qqhNwAc+p0KtHZuiqQoUCZuqIPVpZ6gAtG+YJ/dA6xxrhz
+bDRC3frYALyp2m/WCoTWaiYsPgTIePHRqqt+XbQo+DwlGyL3wSvKxijx2QKBgCb0
+OwioEE70/X/DukX9szn0chh0pHJUiYl7gZD/yadraCdkRUWZC0BD+j7c+lxn4Z1y
+HhAH+E+Zfm+tHwJOTLuufTQ4uMpygh2/TRCPyAaeaSdlLi17n8TpM84o6mg8yZ3/
+eNH68Za4aYOZm0HFL30h++DjwXd534zM6keh8pgRAoGBAKUrsjDGjuSo8l1fi4Cq
+INu/rQop2h/db02zyJP5q7NKhE1nqogeLwwn+2M/LtHQ1nIzZR+rvrLNgt6oWY31
+sPsv8JUfVT8GmdhU9KKmizK6eUu3rWdj2+rJARmuEaPmHcD5O6oJaGU0qadqQP34
+H+enwWmpyZXAIbEu/q63DFhV
+-----END PRIVATE KEY-----

fastled/assets/localhost.pem

@@ -0,0 +1,27 @@
+-----BEGIN CERTIFICATE-----
+MIIEfTCCAuWgAwIBAgIRAPb7jkLrCuqToG+s3AQYeuUwDQYJKoZIhvcNAQELBQAw
+gakxHjAcBgNVBAoTFW1rY2VydCBkZXZlbG9wbWVudCBDQTE/MD0GA1UECww2REVT
+S1RPUC1JMzcxOERPXFphY2ggVm9yaGllc0BERVNLVE9QLUkzNzE4RE8gKG5pdGVy
+aXMpMUYwRAYDVQQDDD1ta2NlcnQgREVTS1RPUC1JMzcxOERPXFphY2ggVm9yaGll
+c0BERVNLVE9QLUkzNzE4RE8gKG5pdGVyaXMpMB4XDTI1MDQyODAwMzk1MFoXDTI3
+MDcyODAwMzk1MFowajEnMCUGA1UEChMebWtjZXJ0IGRldmVsb3BtZW50IGNlcnRp
+ZmljYXRlMT8wPQYDVQQLDDZERVNLVE9QLUkzNzE4RE9cWmFjaCBWb3JoaWVzQERF
+U0tUT1AtSTM3MThETyAobml0ZXJpcykwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw
+ggEKAoIBAQDlxbWcpUXPpjqsDJPgFF1FsXPZqq0JPJqssHh4ZLfN0h4yJmj+kRcH
+S+pkgXnG46g6bUcL/AK5Ba08vwnUUGkPH0v4ShKiAGYwvOcbWaqTmvvJuIoaDBXh
+2jSCeOTagNoaHLYEugARkkEu0/FEW5P/79wU5vJ5G+SyZ8rBCVdxlU57pL1hKWBU
+7K+BLWsCiZ308NMpzHF5APZ6YxVjhFosJPr4TjN6yXr+whrsAjSTHamD5690MbXW
+yyPG0jwPQyjBot/cNtt8GrsNgcjA1E+8VKFvxO8RvZanMZLb0CGEpt7u3oaJ/jpr
+HEsw+/UhnG6Qhksm8C/DN9kPhselewffAgMBAAGjXjBcMA4GA1UdDwEB/wQEAwIF
+oDATBgNVHSUEDDAKBggrBgEFBQcDATAfBgNVHSMEGDAWgBSPBydvhr9wI+FsoW/H
+WK3DbS8IUDAUBgNVHREEDTALgglsb2NhbGhvc3QwDQYJKoZIhvcNAQELBQADggGB
+AJVrF1yczZaxt+A2AhdeFbJQUR6NzGBTc20YeWF1YzLV5sV3QVumwZLP2M9ggRgd
+xWV0xfwUHobFQk6RIPTADcLKctiurql0cgF4DPnpWVvto9RM00U3AkQcMj3xtKBV
+wUqo83TcbqgL+euudFZ09gGTs9u9AENaZPcMh+rW8DDO92t+EwMI/IfopxVOJGUB
+RSM3yTwV93BMYBuddt8mclzLzPK/1WONfsHU2xEascaHR1tYMOmJN9Vq4o0fzWxo
+a2vI6K0aJqZV/ztdXq3akwLc6/e9hyptHWa0i/022xVCyNWIlnuEhT7ENMPxh6rX
+ZCQCZVnhcSWAyFjggLJql3aSID5fPF8rmN7wWsB/I5pl9qwMR1/THMPrm5aWn1Xj
+xW6PxkSGm73kd57DH7tqm5HTd8eYCbnsFofI9rC7xI6HCfwchKp+YHvIEu/LJ56E
+FLnCZW/orYkHCzWntzxv1bddrw1BwaNR8Q+mu3imRP8fuyXb2UkFkINVVyOOWHuW
+Kw==
+-----END CERTIFICATE-----

fastled/cli.py

@@ -0,0 +1,16 @@
+"""Python compatibility shim that launches the native Rust CLI."""
+
+import multiprocessing
+import sys
+
+from fastled._rust_cli import invoke_rust_fastled_cli
+
+
+def main() -> int:
+    """Run the native Rust CLI with the current argv."""
+    return invoke_rust_fastled_cli(sys.argv[1:])
+
+
+if __name__ == "__main__":
+    multiprocessing.freeze_support()
+    sys.exit(main())

fastled/frontend/Arduino.h

@@ -0,0 +1,10 @@
+// WASM Arduino.h stub - points to shared stub implementation
+// This ensures WASM uses the same Arduino emulation as other stub platforms
+
+// ok no namespace fl
+#pragma once
+
+// IWYU pragma: private
+
+// Include the shared stub Arduino.h implementation
+#include "platforms/stub/Arduino.h"