fastled 1.4.32__tar.gz → 1.4.34__tar.gz

{fastled-1.4.32 → fastled-1.4.34}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastled
-Version: 1.4.32
+Version: 1.4.34
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies

fastled-1.4.34/chrome_vscode_bridge_design_task.md

@@ -0,0 +1,195 @@
+Here’s a refined `chrome_vscode_bridge_design_task.md` file for your repo. Feel free to adjust paths, placeholders, or formatting to match your project's style.
+
+---
+
+# Chrome ↔ VSCode Bridge Design 🛠️
+
+## Overview
+
+Design and implement a minimal debugging bridge between a Python backend (using a hypothetical `fastled` library) and a Chrome-based frontend, invokable from VS Code. The goal is to allow:
+
+* **Step-through debugging** (`step`, `next`, `in`, `out`)
+* **Program counter**, call stack, local variable inspection
+* Integration with VS Code Python or Node debugger
+
+---
+
+## 📘 Architecture
+
+```
+[VS Code] ↔ [Chrome Frontend CLI: Puppeteer + CDP] ↔ HTTP ↔ [Python Debug API (fastled)]
+```
+
+1. **Backend** (`Python + Flask`)
+
+   * Exposes endpoints:
+
+     * `POST /start` — begins execution, stops at first pause
+     * `POST /step/next` — advances one logical step
+     * `GET /state` — returns `{ pc, function, locals }`
+   * Internally uses generator-based control flow and `inspect` to snapshot state.
+2. **Frontend** (`Node.js + Puppeteer`)
+
+   * Launches Chrome with remote-debugging enabled
+   * Serves a minimal UI (e.g. HTML + JS) to send `start`, `step`, and poll `state`
+   * Renders debugging state to the user; future CDP integration for real-time UI
+3. **VS Code Integration**
+
+   * Launch configuration invokes the frontend script
+   * Stepping and inspection occur in the Chrome UI
+   * Optionally hooks into VS Code Debug Console for unified control
+
+---
+
+## 📄 Files
+
+### 1. `debug_fastled_api.py` (Backend)
+
+```python
+import fastled, inspect
+from flask import Flask, jsonify, request
+
+app = Flask(__name__)
+_state, _step_generator = {}, None
+
+def compute(n):
+    x = n * 2
+    y = fastled.compute(x)
+    yield from report_and_pause()
+    return y
+
+def report_and_pause():
+    frame = inspect.currentframe().f_back
+    _state.update({
+        "pc": frame.f_lineno,
+        "func": frame.f_code.co_name,
+        "locals": frame.f_locals.copy()
+    })
+    yield True
+
+@app.route('/start', methods=['POST'])
+def start():
+    global _step_generator
+    n = request.json.get("n", 5)
+    def runner():
+        gen = compute(n)
+        try: next(gen)
+        except StopIteration: pass
+    _step_generator = runner
+    return jsonify({"status": "started"})
+
+@app.route('/state', methods=['GET'])
+def state():
+    return jsonify(_state)
+
+@app.route('/step/next', methods=['POST'])
+def step_next():
+    try:
+        _step_generator()
+        return jsonify({"status": "paused", **_state})
+    except Exception:
+        return jsonify({"status": "done"})
+
+if __name__ == "__main__":
+    app.run(port=5000)
+```
+
+---
+
+### 2. `debug_fastled_frontend.js` (Frontend)
+
+```js
+const puppeteer = require('puppeteer-core');
+const fetch = require('node-fetch');
+
+(async () => {
+  const browser = await puppeteer.launch({
+    executablePath: '/path/to/chrome',
+    args: ['--remote-debugging-port=9222']
+  });
+  const [page] = await browser.pages();
+
+  const html = `
+    <button id="start">Start</button>
+    <button id="step">Next</button>
+    <pre id="out"></pre>
+    <script>
+      document.getElementById('start').onclick = async () => {
+        await fetch('http://localhost:5000/start', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ n: 10 })
+        });
+        update();
+      };
+      document.getElementById('step').onclick = async () => {
+        await fetch('http://localhost:5000/step/next', { method: 'POST' });
+        update();
+      };
+      async function update() {
+        const res = await fetch('http://localhost:5000/state');
+        document.getElementById('out').textContent = JSON.stringify(await res.json(), null, 2);
+      }
+    </script>
+  `;
+  await page.setContent(html);
+})();
+```
+
+---
+
+## ⛓️ Integration with VS Code
+
+Add this to `.vscode/launch.json`:
+
+```jsonc
+{
+  "configurations": [
+    {
+      "name": "Chrome-FastLED Debug Bridge",
+      "type": "node",
+      "request": "launch",
+      "program": "${workspaceFolder}/debug_fastled_frontend.js"
+    }
+  ]
+}
+```
+
+* Launch this first to start Chrome with debugging enabled
+* Use the UI to `Start`, `Next`, and inspect state output
+* Optionally, add CDP logic to highlight lines in VS Code or Chrome DevTools
+
+---
+
+## ✅ Roadmap & Next Steps
+
+| Task                                    | Status        |
+| --------------------------------------- | ------------- |
+| Generator-based stepping API            | ✅ Implemented |
+| Backend state introspection (PC/locals) | ✅ Implemented |
+| Frontend stepping UI (buttons + state)  | ✅ Implemented |
+| VS Code `launch.json` integration       | ✅ Drafted     |
+| CDP / DevTools integration              | 🔲 To Do      |
+| Support for `step in`, `step out`       | 🔲 To Do      |
+| Breakpoints, multi-file support         | 🔲 To Do      |
+
+---
+
+## 🔧 Future Enhancements
+
+* **Full CDP client**: translate HTTP state to actual Chrome DevTools UI breakpoints/stepping
+* **Rich UI**: live code view, synchronized highlighting, variable inspectors
+* **Language-agnostic bridge**: plug in Node.js or other backends
+* **VS Code Extension support**: unify stepping flows and tooltips
+
+---
+
+## 📎 Summary
+
+This bridge provides:
+
+* A **Python backend** exposing stepping and state via HTTP
+* A **Node.js/pupeteer frontend** for remote-debug Chrome UI
+* **VS Code launch config** for seamless integration
+
+You're all set to explore, refine, or build upon this foundation. Let me know if you'd like help developing CDP integration or full VS Code extension support!

fastled-1.4.34/requirements.docker.txt

@@ -0,0 +1 @@
+fastled-wasm-server>=1.1.38

{fastled-1.4.32 → fastled-1.4.34}/src/fastled/__init__.py

@@ -7,6 +7,7 @@ from typing import Generator
 
 from .__version__ import __version__
 from .compile_server import CompileServer
+from .emoji_util import EMO
 from .live_client import LiveClient
 from .settings import DOCKER_FILE, IMAGE_NAME
 from .site.build import build
@@ -54,7 +55,7 @@ class Api:
         allow_libcompile = looks_like_fastled_repo(Path(".").resolve())
         if not allow_libcompile:
             print(
-                "⚠️  libfastled compilation disabled: not running in FastLED repository"
+                f"{EMO('⚠️', 'WARNING:')}  libfastled compilation disabled: not running in FastLED repository"
             )
 
         out: CompileResult = web_compile(

{fastled-1.4.32 → fastled-1.4.34}/src/fastled/__version__.py

@@ -1,6 +1,6 @@
 # IMPORTANT! There's a bug in github which will REJECT any version update
 # that has any other change in the repo. Please bump the version as the
 # ONLY change in a commit, or else the pypi update and the release will fail.
-__version__ = "1.4.32"
+__version__ = "1.4.34"
 
 __version_url_latest__ = "https://raw.githubusercontent.com/zackees/fastled-wasm/refs/heads/main/src/fastled/__version__.py"

{fastled-1.4.32 → fastled-1.4.34}/src/fastled/app.py

@@ -9,6 +9,7 @@ from pathlib import Path
 
 from fastled.client_server import run_client_server
 from fastled.compile_server import CompileServer
+from fastled.emoji_util import EMO
 from fastled.filewatcher import file_watcher_set
 from fastled.parse_args import Args, parse_args
 from fastled.sketch import find_sketch_directories, looks_like_fastled_repo
@@ -79,7 +80,7 @@ def main() -> int:
     # Check if Playwright browsers are installed
     playwright_dir = Path.home() / ".fastled" / "playwright"
     if playwright_dir.exists() and any(playwright_dir.iterdir()):
-        print(f"🎭 Playwright browsers available at: {playwright_dir}")
+        print(f"{EMO('🎭', '*')} Playwright browsers available at: {playwright_dir}")
 
     # Resolve some of the last interactive arguments
     # 1. If interactive is set and the sketch directory is not given,

{fastled-1.4.32 → fastled-1.4.34}/src/fastled/client_server.py

@@ -10,6 +10,7 @@ from pathlib import Path
 
 from fastled.compile_server import CompileServer
 from fastled.docker_manager import DockerManager
+from fastled.emoji_util import EMO
 from fastled.filewatcher import DebouncedFileWatcherProcess, FileWatcherProcess
 from fastled.find_good_connection import ConnectionResult
 from fastled.keyboard import SpaceBarWatcher
@@ -100,7 +101,7 @@ def _run_web_compiler(
 
     # Guard: libfastled compilation requires volume source mapping
     if not allow_libcompile:
-        print("⚠️  libfastled compilation disabled.")
+        print(f"{EMO('⚠️', 'WARNING:')}  libfastled compilation disabled.")
 
     start = time.time()
     web_result = web_compile(
@@ -122,14 +123,59 @@ def _run_web_compiler(
         (output_dir / "index.html").write_text(error_html, encoding="utf-8")
         return web_result
 
+    # Extract zip contents to fastled_js directory
+    extraction_start_time = time.time()
+    output_dir.mkdir(exist_ok=True)
+    with tempfile.TemporaryDirectory() as temp_dir:
+        temp_path = Path(temp_dir)
+        temp_zip = temp_path / "result.zip"
+        temp_zip.write_bytes(web_result.zip_bytes)
+
+        # Clear existing contents
+        shutil.rmtree(output_dir, ignore_errors=True)
+        output_dir.mkdir(exist_ok=True)
+
+        # Extract zip contents
+        shutil.unpack_archive(temp_zip, output_dir, "zip")
+    extraction_time = time.time() - extraction_start_time
+
     def print_results() -> None:
         hash_value = (
             web_result.hash_value
             if web_result.hash_value is not None
             else "NO HASH VALUE"
         )
+
+        # Build timing breakdown
+        timing_breakdown = f"  Time: {diff:.2f} (seconds)"
+        if hasattr(web_result, "zip_time"):
+            timing_breakdown += f"\n     zip creation: {web_result.zip_time:.2f}"
+            if web_result.libfastled_time > 0:
+                timing_breakdown += (
+                    f"\n     libfastled: {web_result.libfastled_time:.2f}"
+                )
+            timing_breakdown += (
+                f"\n     sketch compile + link: {web_result.sketch_time:.2f}"
+            )
+            if hasattr(web_result, "response_processing_time"):
+                timing_breakdown += f"\n     response processing: {web_result.response_processing_time:.2f}"
+
+            # Calculate any unaccounted time
+            accounted_time = (
+                web_result.zip_time
+                + web_result.libfastled_time
+                + web_result.sketch_time
+                + web_result.response_processing_time
+                + extraction_time
+            )
+            unaccounted_time = diff - accounted_time
+            if extraction_time > 0.01:
+                timing_breakdown += f"\n     extraction: {extraction_time:.2f}"
+            if unaccounted_time > 0.01:
+                timing_breakdown += f"\n     other overhead: {unaccounted_time:.2f}"
+
         print(
-            f"\nWeb compilation successful\n  Time: {diff:.2f}\n  output: {output_dir}\n  hash: {hash_value}\n  zip size: {len(web_result.zip_bytes)} bytes"
+            f"\nWeb compilation successful\n{timing_breakdown}\n  output: {output_dir}\n  hash: {hash_value}\n  zip size: {len(web_result.zip_bytes)} bytes"
         )
 
     # now check to see if the hash value is the same as the last hash value
@@ -138,20 +184,6 @@ def _run_web_compiler(
         print_results()
         return web_result
 
-    # Extract zip contents to fastled_js directory
-    output_dir.mkdir(exist_ok=True)
-    with tempfile.TemporaryDirectory() as temp_dir:
-        temp_path = Path(temp_dir)
-        temp_zip = temp_path / "result.zip"
-        temp_zip.write_bytes(web_result.zip_bytes)
-
-        # Clear existing contents
-        shutil.rmtree(output_dir, ignore_errors=True)
-        output_dir.mkdir(exist_ok=True)
-
-        # Extract zip contents
-        shutil.unpack_archive(temp_zip, output_dir, "zip")
-
     _chunked_print(web_result.stdout)
     print_results()
     return web_result
@@ -252,16 +284,20 @@ def _background_update_docker_image() -> None:
             image_name=IMAGE_NAME, tag="latest", upgrade=True
         )
         if updated:
-            print("✅ Background docker image update completed successfully.")
+            print(
+                f"{EMO('✅', 'SUCCESS:')} Background docker image update completed successfully."
+            )
         else:
-            print("ℹ️  Docker image was already up to date.")
+            print(f"{EMO('ℹ️', 'INFO:')}  Docker image was already up to date.")
     except KeyboardInterrupt:
-        print("⚠️  Background docker image update interrupted by user.")
+        print(
+            f"{EMO('⚠️', 'WARNING:')}  Background docker image update interrupted by user."
+        )
         import _thread
 
         _thread.interrupt_main()
     except Exception as e:
-        print(f"⚠️  Background docker image update failed: {e}")
+        print(f"{EMO('⚠️', 'WARNING:')}  Background docker image update failed: {e}")
 
 
 def _is_local_host(url: str) -> bool:

{fastled-1.4.32 → fastled-1.4.34}/src/fastled/compile_server_impl.py

@@ -15,6 +15,7 @@ from fastled.docker_manager import (
     RunningContainer,
     Volume,
 )
+from fastled.emoji_util import EMO
 from fastled.settings import DEFAULT_CONTAINER_NAME, IMAGE_NAME, SERVER_PORT
 from fastled.sketch import looks_like_fastled_repo
 from fastled.types import BuildMode, CompileResult, CompileServerError
@@ -76,7 +77,7 @@ class CompileServerImpl:
         # If we don't have fastled_src_dir (not in FastLED repo), disable libcompile
         if allow_libcompile and self.fastled_src_dir is None:
             print(
-                "⚠️  libfastled compilation disabled: volume source mapping not available"
+                f"{EMO('⚠️', 'WARNING:')}  libfastled compilation disabled: volume source mapping not available"
             )
             print("   (not running in FastLED repository)")
             allow_libcompile = False

fastled-1.4.34/src/fastled/emoji_util.py

@@ -0,0 +1,15 @@
+"""
+Emoji utility functions for handling Unicode display issues on Windows cmd.exe
+"""
+
+import sys
+
+
+def EMO(emoji: str, fallback: str) -> str:
+    """Get emoji with fallback for systems that don't support Unicode properly"""
+    try:
+        # Test if we can encode the emoji properly
+        emoji.encode(sys.stdout.encoding or "utf-8")
+        return emoji
+    except (UnicodeEncodeError, AttributeError):
+        return fallback

{fastled-1.4.32 → fastled-1.4.34}/src/fastled/types.py

@@ -12,6 +12,10 @@ class CompileResult:
     stdout: str
     hash_value: str | None
     zip_bytes: bytes
+    zip_time: float
+    libfastled_time: float
+    sketch_time: float
+    response_processing_time: float
 
     def __bool__(self) -> bool:
         return self.success

{fastled-1.4.32 → fastled-1.4.34}/src/fastled/web_compile.py

@@ -196,16 +196,30 @@ def _process_compile_response(
     response: httpx.Response,
     zip_result: ZipResult,
     start_time: float,
+    zip_time: float,
+    libfastled_time: float,
+    sketch_time: float,
 ) -> CompileResult:
     """Process the compile response and return the final result."""
     if response.status_code != 200:
         json_response = response.json()
         detail = json_response.get("detail", "Could not compile")
         return CompileResult(
-            success=False, stdout=detail, hash_value=None, zip_bytes=b""
+            success=False,
+            stdout=detail,
+            hash_value=None,
+            zip_bytes=b"",
+            zip_time=zip_time,
+            libfastled_time=libfastled_time,
+            sketch_time=sketch_time,
+            response_processing_time=0.0,  # No response processing in error case
         )
 
     print(f"Response status code: {response}")
+
+    # Time the response processing
+    response_processing_start = time.time()
+
     # Create a temporary directory to extract the zip
     with tempfile.TemporaryDirectory() as extract_dir:
         extract_path = Path(extract_dir)
@@ -250,14 +264,32 @@ def _process_compile_response(
                     relative_path = file_path.relative_to(extract_path)
                     out_zip.write(file_path, relative_path)
 
+        response_processing_time = time.time() - response_processing_start
         diff_time = time.time() - start_time
-        msg = f"Compilation success, took {diff_time:.2f} seconds"
+
+        # Create detailed timing breakdown
+        unaccounted_time = diff_time - (
+            zip_time + libfastled_time + sketch_time + response_processing_time
+        )
+        msg = f"Compilation success, took {diff_time:.2f} seconds\n"
+        msg += f"     zip creation: {zip_time:.2f}\n"
+        if libfastled_time > 0:
+            msg += f"     libfastled: {libfastled_time:.2f}\n"
+        msg += f"     sketch compile + link: {sketch_time:.2f}\n"
+        msg += f"     response processing: {response_processing_time:.2f}\n"
+        if unaccounted_time > 0.01:  # Only show if significant
+            msg += f"     other overhead: {unaccounted_time:.2f}"
+
         _print_banner(msg)
         return CompileResult(
             success=True,
             stdout=stdout,
             hash_value=hash_value,
             zip_bytes=out_buffer.getvalue(),
+            zip_time=zip_time,
+            libfastled_time=libfastled_time,
+            sketch_time=sketch_time,
+            response_processing_time=response_processing_time,
         )
 
 
@@ -279,17 +311,35 @@ def web_compile(
     auth_token = auth_token or AUTH_TOKEN
     if not directory.exists():
         raise FileNotFoundError(f"Directory not found: {directory}")
+
+    # Time the zip creation
+    zip_start_time = time.time()
     zip_result: ZipResult | Exception = zip_files(directory, build_mode=build_mode)
+    zip_time = time.time() - zip_start_time
+
     if isinstance(zip_result, Exception):
         return CompileResult(
-            success=False, stdout=str(zip_result), hash_value=None, zip_bytes=b""
+            success=False,
+            stdout=str(zip_result),
+            hash_value=None,
+            zip_bytes=b"",
+            zip_time=zip_time,
+            libfastled_time=0.0,  # No libfastled compilation in zip error case
+            sketch_time=0.0,  # No sketch compilation in zip error case
+            response_processing_time=0.0,  # No response processing in zip error case
         )
     zip_bytes = zip_result.zip_bytes
     print(f"Web compiling on {host}...")
+
+    # Track timing for each step
+    libfastled_time = 0.0
+    sketch_time = 0.0
+
     try:
         # Step 1: Compile libfastled if requested
         if allow_libcompile:
             print("Step 1: Compiling libfastled...")
+            libfastled_start_time = time.time()
             try:
                 libfastled_response = _compile_libfastled(host, auth_token, build_mode)
 
@@ -308,6 +358,10 @@ def web_compile(
                         stdout=stdout,
                         hash_value=None,
                         zip_bytes=b"",
+                        zip_time=zip_time,
+                        libfastled_time=libfastled_time,
+                        sketch_time=0.0,  # No sketch compilation when libfastled fails
+                        response_processing_time=0.0,  # No response processing when libfastled fails
                     )
                 else:
                     # Check for embedded HTTP status in response content
@@ -332,6 +386,10 @@ def web_compile(
                                 stdout=stdout,
                                 hash_value=None,
                                 zip_bytes=b"",
+                                zip_time=zip_time,
+                                libfastled_time=libfastled_time,
+                                sketch_time=0.0,  # No sketch compilation when libfastled fails
+                                response_processing_time=0.0,  # No response processing when libfastled fails
                             )
                             # Continue with sketch compilation even if libfastled fails
                         elif embedded_status is None:
@@ -343,7 +401,9 @@ def web_compile(
                             print("✅ libfastled compilation successful")
                     else:
                         print("✅ libfastled compilation successful")
+                libfastled_time = time.time() - libfastled_start_time
             except Exception as e:
+                libfastled_time = time.time() - libfastled_start_time
                 print(f"Warning: libfastled compilation failed: {e}")
                 # Continue with sketch compilation even if libfastled fails
         else:
@@ -351,6 +411,7 @@ def web_compile(
 
         # Step 2: Compile the sketch
         print("Step 2: Compiling sketch...")
+        sketch_start_time = time.time()
         response = _send_compile_request(
             host,
             zip_bytes,
@@ -360,8 +421,11 @@ def web_compile(
             no_platformio,
             False,  # allow_libcompile is always False since we handle it manually
         )
+        sketch_time = time.time() - sketch_start_time
 
-        return _process_compile_response(response, zip_result, start_time)
+        return _process_compile_response(
+            response, zip_result, start_time, zip_time, libfastled_time, sketch_time
+        )
 
     except ConnectionError as e:
         _print_banner(str(e))
@@ -370,6 +434,10 @@ def web_compile(
             stdout=str(e),
             hash_value=None,
             zip_bytes=b"",
+            zip_time=zip_time,
+            libfastled_time=libfastled_time,
+            sketch_time=sketch_time,
+            response_processing_time=0.0,  # No response processing in connection error case
         )
     except KeyboardInterrupt:
         print("Keyboard interrupt")
@@ -377,5 +445,12 @@ def web_compile(
     except httpx.HTTPError as e:
         print(f"Error: {e}")
         return CompileResult(
-            success=False, stdout=str(e), hash_value=None, zip_bytes=b""
+            success=False,
+            stdout=str(e),
+            hash_value=None,
+            zip_bytes=b"",
+            zip_time=zip_time,
+            libfastled_time=libfastled_time,
+            sketch_time=sketch_time,
+            response_processing_time=0.0,  # No response processing in HTTP error case
         )

{fastled-1.4.32 → fastled-1.4.34}/src/fastled.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastled
-Version: 1.4.32
+Version: 1.4.34
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies

{fastled-1.4.32 → fastled-1.4.34}/src/fastled.egg-info/SOURCES.txt

@@ -14,6 +14,7 @@ TODO.md
 build_exe.py
 build_local_docker.py
 build_site.py
+chrome_vscode_bridge_design_task.md
 clean
 docker-compose.yml
 entrypoint.sh
@@ -25,6 +26,7 @@ requirements.docker.txt
 requirements.testing.txt
 setup.py
 task.md
+task2.md
 test
 upload_package.sh
 .github/workflows/build_multi_docker_image.yml
@@ -58,6 +60,7 @@ src/fastled/client_server.py
 src/fastled/compile_server.py
 src/fastled/compile_server_impl.py
 src/fastled/docker_manager.py
+src/fastled/emoji_util.py
 src/fastled/filewatcher.py
 src/fastled/find_good_connection.py
 src/fastled/interruptible_http.py