fastled 1.3.11__tar.gz → 1.3.14__tar.gz

fastled-1.3.14/DEBUGGER.md

@@ -0,0 +1,34 @@
+# Debugger
+
+The `fastled` app supports full C++ debugging in your browser.
+
+This includes:
+
+  * Breakpoints
+  * Stepping
+  * Inspecting variables
+  * Stack
+
+
+![image](https://github.com/user-attachments/assets/774c61fd-4026-48b8-9f36-60295f5c311d)
+
+
+## Enabling
+
+  * Install the [C++ Devtools Plugin for Chrome/Brave/Chromium](https://chromewebstore.google.com/detail/cc++-devtools-support-dwa/pdcpmagijalfljmkmjngeonclgbbannb)
+  * Compile your sketch with `--debug` flag
+
+
+## Using
+
+  * Launch debugging mode with `fastled --debug`
+  * Open the Devtools panel
+    * In Chrome, press `F12`
+    * Or right click on the page and select `Inspect`
+  * Then click the `Sources` -> `Page`
+  * You should now see source code for both fastled core and your sketch.
+
+
+## Notable features
+
+  * If you use FASTLED_ASSERT(...) and it triggers while devtools is open, the debugger will be invoked and the program will pause at the point the assert fired.

fastled-1.3.14/Dockerfile

@@ -0,0 +1,58 @@
+
+# The only reason we use docker is because of the fastled-wasm-compiler.
+FROM niteris/fastled-wasm-compiler:latest
+
+
+COPY requirements.testing.txt /install/requirements.txt
+# Extract fastled-wasm-server version from requirements.txt
+RUN \
+    grep -oP '(?<=fastled-wasm-server[<>=!]=?)[^ \n#]+' /install/requirements.txt > /install/version.txt && \
+    cat /install/version.txt > /install/requirements.txt && \
+    uv pip install --system -r /install/requirements.txt --refresh || \
+    uv pip install --system -r /install/requirements.txt --refresh || \
+    uv pip install --system -r /install/requirements.txt --refresh
+
+# FIRST PRE-WARM CYCLE and initial setup: Download the fastled repo from the github and pre-warm the cache with a compilation.
+# This is by far the most expensive part of the build, because platformio needs to download initial tools. This
+# pre-warm cycle is "sticky" and tends to stay in the cache for a long time since docker is very relaxed about
+# invalidating cache layers that clone a github repo.
+
+ARG FASTLED_BUILD_DAY=echo $(date +'%Y-%m-%d')
+ENV FASTLED_BUILD_DAY=${FASTLED_BUILD_DAY}
+
+
+WORKDIR /js
+
+
+RUN mkdir -p /js/compiler
+
+
+# COPY compiler/*.py /js/compiler
+COPY entrypoint.sh /entrypoint.sh
+COPY compiler/run.py /js/run.py
+COPY compiler/debug.sh /js/debug.sh
+
+# COPY compiler/entrypoint.sh /entrypoint.sh
+# RUN chmod +x /entrypoint.sh && dos2unix /entrypoint.sh
+
+RUN cd /js && chmod +x debug.sh && dos2unix *.sh
+RUN chmod +x /entrypoint.sh && dos2unix /entrypoint.sh
+
+# RSYNC DISABLED FOR NOW
+# now sync local to the source directory.
+# RUN rsync -av /host/fastled/ /js/fastled/ && rm -rf /host/fastled
+
+# RUN python /js/init_runtime.py || true
+
+
+# SECOND PRE-WARM CYCLE: Copy the fastled repo from the host machine and pre-warm the cache with that compilation. This will
+# be much quicker than the first pre-warm cycle.
+# RUN /js/prewarm.sh --force > /logs/prewarm.log.2 || true
+
+# Now timestamp the image and store it at the end of the build.
+RUN date > /image_timestamp.txt
+
+ENTRYPOINT ["/entrypoint.sh"]
+CMD ["python", "/js/run.py", "server"]
+
+# CMD ["/bin/bash", "/entrypoint.sh"]

fastled-1.3.14/FAQ.md

@@ -0,0 +1,11 @@
+# FAQ
+
+### Why is this compiler so fast?
+
+The compiler image uses compile caching. This cache is pre-warmed by compiling the Blink sketch, and then frozen. This happens for debug/release/quick builds, which is why it’s so blazing fast. The whole compiler toolchain is cocked and ready to fire and then frozen in place right before it compiles your sketch.
+
+The entire Fastled library pre-compiled as a static archive and headers made available to the sketch.
+
+During compile time, the compiler only has to consider your code and linking against a static lib.
+
+All of this together has eliminated 90% of the compile time. But this number will increase to 97% when I apply some of the more painful refactors to eliminate the emscripten steps (--bind) that happen at final program generation time.

{fastled-1.3.11 → fastled-1.3.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastled
-Version: 1.3.11
+Version: 1.3.14
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies
@@ -20,7 +20,7 @@ Requires-Dist: progress>=1.6
 Requires-Dist: watchfiles>=1.0.5
 Requires-Dist: Flask>=3.0.0
 Requires-Dist: livereload
-Requires-Dist: fastled-wasm-server>=1.0.27
+Requires-Dist: disklru>=2.0.4
 Dynamic: home-page
 Dynamic: license-file
 Dynamic: maintainer
@@ -91,7 +91,11 @@ https://github.com/user-attachments/assets/64ae0e6c-5f8b-4830-ab87-dcc25bc61218
 pip install fastled
 ```
 
-**Note that you may need to install x86 docker emulation on Mac-m1 and later, as this is an x86 only image at the prsent.**
+# Debugger
+
+This tool features full C++ debugging through the browser.
+
+For instructions on setup see [DEBUGGER.md](DEBUGGER.md)
 
 # Command Line Use
 
@@ -389,12 +393,14 @@ A: A big chunk of space is being used by unnecessary javascript `emscripten` bun
 
 
 
+
   live-server --https --port=8416 --host=localhost .  --cert=C:/Users/niteris/dev/fastled-wasm/src/fastled/assets/localhost-key.pem --key=C:/Users/niteris/dev/fastled-wasm/src/fastled/assets/localhost.pem --no-browser
 
 
   live-server --https --cert=src/fastled/assets/localhost.pem --key=src/fastled/assets/localhost-key.pem --port=5500
 
 
+
 ## Performance
 
 ```

{fastled-1.3.11 → fastled-1.3.14}/README.md

@@ -64,7 +64,11 @@ https://github.com/user-attachments/assets/64ae0e6c-5f8b-4830-ab87-dcc25bc61218
 pip install fastled
 ```
 
-**Note that you may need to install x86 docker emulation on Mac-m1 and later, as this is an x86 only image at the prsent.**
+# Debugger
+
+This tool features full C++ debugging through the browser.
+
+For instructions on setup see [DEBUGGER.md](DEBUGGER.md)
 
 # Command Line Use
 
@@ -362,12 +366,14 @@ A: A big chunk of space is being used by unnecessary javascript `emscripten` bun
 
 
 
+
   live-server --https --port=8416 --host=localhost .  --cert=C:/Users/niteris/dev/fastled-wasm/src/fastled/assets/localhost-key.pem --key=C:/Users/niteris/dev/fastled-wasm/src/fastled/assets/localhost.pem --no-browser
 
 
   live-server --https --cert=src/fastled/assets/localhost.pem --key=src/fastled/assets/localhost-key.pem --port=5500
 
 
+
 ## Performance
 
 ```
@@ -441,4 +447,4 @@ A: A big chunk of space is being used by unnecessary javascript `emscripten` bun
 1.49
 2.20 ccache em++ -o .pio/build/wasm/program --bind -fuse-ld=lld -sWASM=1 -sALLOW_MEMORY_GROWTH=1 -sINITIAL_MEMORY=134217728 -sEXPORTED_RUNTIME_METHODS=['ccall','cwrap','stringToUTF8','lengthBytesUTF8'] -sEXPORTED_FUNCTIONS=['_malloc','_free','_extern_setup','_extern_loop','_fastled_declare_files'] --no-entry -sERROR_ON_WASM_CHANGES_AFTER_LINK -sMODULARIZE=1 -sEXPORT_NAME=fastled -o /js/.pio/build/wasm/fastled.js .pio/build/wasm/libbb9/fastled/FastLED.o .pio/build/wasm/libbb9/fastled/bitswap.o .pio/build/wasm/libbb9/fastled/cled_controller.o .pio/build/wasm/libbb9/fastled/colorpalettes.o .pio/build/wasm/libbb9/fastled/crgb.o .pio/build/wasm/libbb9/fastled/fl/allocator.o .pio/build/wasm/libbb9/fastled/fl/audio.o .pio/build/wasm/libbb9/fastled/fl/bilinear_expansion.o .pio/build/wasm/libbb9/fastled/fl/blur.o .pio/build/wasm/libbb9/fastled/fl/bytestreammemory.o .pio/build/wasm/libbb9/fastled/fl/colorutils.o .pio/build/wasm/libbb9/fastled/fl/downscale.o .pio/build/wasm/libbb9/fastled/fl/engine_events.o .pio/build/wasm/libbb9/fastled/fl/fft.o .pio/build/wasm/libbb9/fastled/fl/fft_impl.o .pio/build/wasm/libbb9/fastled/fl/file_system.o .pio/build/wasm/libbb9/fastled/fl/fill.o .pio/build/wasm/libbb9/fastled/fl/five_bit_hd_gamma.o .pio/build/wasm/libbb9/fastled/fl/gradient.o .pio/build/wasm/libbb9/fastled/fl/json.o .pio/build/wasm/libbb9/fastled/fl/leds.o .pio/build/wasm/libbb9/fastled/fl/line_simplification.o .pio/build/wasm/libbb9/fastled/fl/noise_woryley.o .pio/build/wasm/libbb9/fastled/fl/ptr.o .pio/build/wasm/libbb9/fastled/fl/raster_sparse.o .pio/build/wasm/libbb9/fastled/fl/rectangular_draw_buffer.o .pio/build/wasm/libbb9/fastled/fl/screenmap.o .pio/build/wasm/libbb9/fastled/fl/sin32.o .pio/build/wasm/libbb9/fastled/fl/str.o .pio/build/wasm/libbb9/fastled/fl/strstream.o .pio/build/wasm/libbb9/fastled/fl/stub_main.o .pio/build/wasm/libbb9/fastled/fl/tile2x2.o .pio/build/wasm/libbb9/fastled/fl/time_alpha.o .pio/build/wasm/libbb9/fastled/fl/transform.o .pio/build/wasm/libbb9/fastled/fl/type_traits.o .pio/build/wasm/libbb9/fastled/fl/ui.o .pio/build/wasm/libbb9/fastled/fl/wave_simulation.o .pio/build/wasm/libbb9/fastled/fl/wave_simulation_real.o .pio/build/wasm/libbb9/fastled/fl/xmap.o .pio/build/wasm/libbb9/fastled/fl/xymap.o .pio/build/wasm/libbb9/fastled/fl/xypath.o .pio/build/wasm/libbb9/fastled/fl/xypath_impls.o .pio/build/wasm/libbb9/fastled/fl/xypath_renderer.o .pio/build/wasm/libbb9/fastled/fx/2d/blend.o .pio/build/wasm/libbb9/fastled/fx/2d/noisepalette.o .pio/build/wasm/libbb9/fastled/fx/2d/scale_up.o .pio/build/wasm/libbb9/fastled/fx/2d/wave.o .pio/build/wasm/libbb9/fastled/fx/frame.o .pio/build/wasm/libbb9/fastled/fx/fx_engine.o .pio/build/wasm/libbb9/fastled/fx/time.o .pio/build/wasm/libbb9/fastled/fx/video.o .pio/build/wasm/libbb9/fastled/fx/video/frame_interpolator.o .pio/build/wasm/libbb9/fastled/fx/video/frame_tracker.o .pio/build/wasm/libbb9/fastled/fx/video/pixel_stream.o .pio/build/wasm/libbb9/fastled/fx/video/video_impl.o .pio/build/wasm/libbb9/fastled/hsv2rgb.o .pio/build/wasm/libbb9/fastled/lib8tion.o .pio/build/wasm/libbb9/fastled/noise.o .pio/build/wasm/libbb9/fastled/platforms.o .pio/build/wasm/libbb9/fastled/platforms/arm/k20/clockless_objectfled.o .pio/build/wasm/libbb9/fastled/platforms/esp/32/clockless_i2s_esp32s3.o .pio/build/wasm/libbb9/fastled/platforms/esp/32/i2s/i2s_esp32dev.o .pio/build/wasm/libbb9/fastled/platforms/esp/32/rmt_4/idf4_rmt.o .pio/build/wasm/libbb9/fastled/platforms/esp/32/rmt_4/idf4_rmt_impl.o .pio/build/wasm/libbb9/fastled/platforms/esp/32/rmt_5/idf5_rmt.o .pio/build/wasm/libbb9/fastled/platforms/esp/32/rmt_5/strip_rmt.o .pio/build/wasm/libbb9/fastled/platforms/esp/32/spi_ws2812/strip_spi.o .pio/build/wasm/libbb9/fastled/platforms/wasm/active_strip_data.o .pio/build/wasm/libbb9/fastled/platforms/wasm/compiler/Arduino.o .pio/build/wasm/libbb9/fastled/platforms/wasm/engine_listener.o .pio/build/wasm/libbb9/fastled/platforms/wasm/fs_wasm.o .pio/build/wasm/libbb9/fastled/platforms/wasm/js.o .pio/build/wasm/libbb9/fastled/platforms/wasm/timer.o .pio/build/wasm/libbb9/fastled/platforms/wasm/ui/audio.o .pio/build/wasm/libbb9/fastled/platforms/wasm/ui/button.o .pio/build/wasm/libbb9/fastled/platforms/wasm/ui/checkbox.o .pio/build/wasm/libbb9/fastled/platforms/wasm/ui/description.o .pio/build/wasm/libbb9/fastled/platforms/wasm/ui/number_field.o .pio/build/wasm/libbb9/fastled/platforms/wasm/ui/slider.o .pio/build/wasm/libbb9/fastled/platforms/wasm/ui/title.o .pio/build/wasm/libbb9/fastled/platforms/wasm/ui/ui_internal.o .pio/build/wasm/libbb9/fastled/platforms/wasm/ui/ui_manager.o .pio/build/wasm/libbb9/fastled/power_mgt.o .pio/build/wasm/libbb9/fastled/rgbw.o .pio/build/wasm/libbb9/fastled/sensors/digital_pin.o .pio/build/wasm/libbb9/fastled/sensors/pir.o .pio/build/wasm/libbb9/fastled/simplex.o .pio/build/wasm/libbb9/fastled/third_party/cq_kernel/cq_kernel.o .pio/build/wasm/libbb9/fastled/third_party/cq_kernel/kiss_fft.o .pio/build/wasm/libbb9/fastled/third_party/cq_kernel/kiss_fftr.o .pio/build/wasm/libbb9/fastled/third_party/espressif/led_strip/src/led_strip_api.o .pio/build/wasm/libbb9/fastled/third_party/espressif/led_strip/src/led_strip_rmt_dev.o .pio/build/wasm/libbb9/fastled/third_party/espressif/led_strip/src/led_strip_rmt_encoder.o .pio/build/wasm/libbb9/fastled/third_party/espressif/led_strip/src/led_strip_spi_dev.o .pio/build/wasm/libbb9/fastled/third_party/object_fled/src/OjectFLED.o .pio/build/wasm/libbb9/fastled/transpose8x1_noinline.o .pio/build/wasm/libbb9/fastled/wiring.o .pio/build/wasm/src/wasm.ino.o -L.pio/build/wasm
 3.61 ========================= [SUCCESS] Took 3.20 seconds =========================
-```
+```

{fastled-1.3.11 → fastled-1.3.14}/clean

@@ -19,3 +19,4 @@ find . -name "*.pyc" -exec rm -rf {} \;
 # remove all *.egg files
 find . -name "*.egg" -exec rm -rf {} \;
 
+rm -f uv.lock

{fastled-1.3.11 → fastled-1.3.14}/compiler/run.py

@@ -6,8 +6,8 @@ import warnings
 from pathlib import Path
 from typing import Tuple
 
-from fastled_wasm_server.code_sync import CodeSync
-from fastled_wasm_server.paths import VOLUME_MAPPED_SRC
+from fastled_wasm_compiler.compiler import Compiler
+from fastled_wasm_compiler.paths import VOLUME_MAPPED_SRC
 
 _PORT = os.environ.get("PORT", 80)
 
@@ -16,33 +16,6 @@ _CHOICES = ["compile", "server"]
 HERE = Path(__file__).parent
 
 
-def _update_fastled() -> None:
-    # NOT ENABLED YET
-    if True:
-        return
-    is_render = os.environ.get("RENDER", "false") == "true"
-    if not is_render:
-        print("Skipping finalprewarm...")
-        return
-    git_path = "/git/fastled"
-    fastled_path = "/js/fastled"
-    subprocess.run(["git", "fetch", "origin"], cwd=git_path)
-    subprocess.run(["git", "reset", "--hard", "origin/master"], cwd=git_path)
-    subprocess.run(
-        [
-            "rsync",
-            "-av",
-            "--info=NAME",
-            "--delete",
-            f"{git_path}/",
-            f"{fastled_path}/",
-            "--exclude",
-            ".git",
-        ],
-        cwd="/js",
-    )
-
-
 def _parse_args() -> Tuple[argparse.Namespace, list[str]]:
     parser = argparse.ArgumentParser(
         description="Run compile.py with additional arguments"
@@ -102,16 +75,16 @@ def _run_compile(unknown_args: list[str]) -> int:
 def main() -> int:
     print("Running...")
     args, unknown_args = _parse_args()
-    _update_fastled()
-
-    code_sync = CodeSync(
+    compiler = Compiler(
         volume_mapped_src=VOLUME_MAPPED_SRC,
-        rsync_dest=Path("/invalid/path"),
     )
-    code_sync.sync_source_directory_if_volume_is_mapped()
+    compiler.update_src()
 
     try:
         if args.mode == "compile":
+            warnings.warn(
+                "The compile mode is deprecated and may fail. Use server mode instead."
+            )
             rtn = _run_compile(unknown_args)
             return rtn
         elif args.mode == "server":

{fastled-1.3.11 → fastled-1.3.14}/docker-compose.yml

@@ -7,4 +7,4 @@ services:
       - "8234:80"
     environment:
       - ENVIRONMENT=dev
-    image: niteris/fastled-wasm:local
+    image: niteris/fastled-wasm:latest

{fastled-1.3.11/compiler → fastled-1.3.14}/entrypoint.sh

@@ -4,12 +4,9 @@
 source /emsdk/emsdk_env.sh
 export PATH="$PATH:/emsdk/upstream/bin"
 
-# initialize runtime
-python init_runtime.py
-
 # only do the final prewarm if RUNTIME_PREWARM is set to "1"
 if [[ "${RUNTIME_PREWARM:-0}" == "1" ]]; then
-  ./final_prewarm.sh
+    uv run -m fastled_wasm_compiler.cli_update_from_master
 fi
 
 # hand off to the main command

{fastled-1.3.11 → fastled-1.3.14}/pyproject.toml

@@ -23,8 +23,7 @@ dependencies = [
     "watchfiles>=1.0.5",
     "Flask>=3.0.0",
     "livereload",
-    ###### WASM SERVER ######
-    "fastled-wasm-server>=1.0.27",  # Enforced by unit test to match project <--> docker.
+    "disklru>=2.0.4",
 ]
 
 dynamic = ["version"]

{fastled-1.3.11 → fastled-1.3.14}/requirements.testing.txt

@@ -5,4 +5,5 @@ pytest
 ruff
 pytest-xdist
 pyinstaller
-pyright
+pyright
+fastled-wasm-server>=1.0.62

{fastled-1.3.11 → fastled-1.3.14}/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.3.11"
+__version__ = "1.3.14"
 
 __version_url_latest__ = "https://raw.githubusercontent.com/zackees/fastled-wasm/refs/heads/main/src/fastled/__version__.py"

{fastled-1.3.11 → fastled-1.3.14}/src/fastled/app.py

@@ -13,12 +13,6 @@ 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
 
-# from fastled.sketch import (
-#     find_sketch_directories,
-#     looks_like_fastled_repo,
-#     looks_like_sketch_directory,
-# )
-
 
 def run_server(args: Args) -> int:
     interactive = args.interactive

{fastled-1.3.11 → fastled-1.3.14}/src/fastled/compile_server_impl.py

@@ -18,7 +18,7 @@ from fastled.docker_manager import (
 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
-from fastled.util import port_is_free
+from fastled.util import port_is_free, print_banner
 
 SERVER_OPTIONS = [
     "--allow-shutdown",  # Allow the server to be shut down without a force kill.
@@ -221,9 +221,8 @@ class CompileServerImpl:
             ports = {INTERNAL_DOCKER_PORT: port}
         volumes = []
         if self.fastled_src_dir:
-            print(
-                f"Mounting FastLED source directory {self.fastled_src_dir} into container /host/fastled/src"
-            )
+            msg = f"FastLED REPO updates enabled!!\n\nMounting FastLED source directory\n{self.fastled_src_dir} into container\n/host/fastled/src"
+            print_banner(msg)
             volumes.append(
                 Volume(
                     host_path=str(self.fastled_src_dir),
@@ -249,22 +248,6 @@ class CompileServerImpl:
                 # to allow for interactive compilation
                 # interactive_sources = list(INTERACTIVE_SOURCES)
                 interactive_sources: list[tuple[Path, str]] = []
-                init_runtime_py = (
-                    Path(self.fastled_src_dir)
-                    / ".."
-                    / ".."
-                    / "fastled-wasm"
-                    / "compiler"
-                    / "init_runtime.py"
-                )
-                if init_runtime_py.exists():
-                    # fastled-wasm is in a sister directory, mapping this in to the container.
-                    mapping = (
-                        init_runtime_py,
-                        "/js/init_runtime.py",
-                    )
-                    interactive_sources.append(mapping)
-
                 src_host: Path
                 dst_container: str
                 for src_host, dst_container in interactive_sources:

{fastled-1.3.11 → fastled-1.3.14}/src/fastled/docker_manager.py

@@ -227,7 +227,7 @@ def set_force_remove_image_previous(new_value: str | None = None) -> None:
     if new_value is not None:
         os.environ["FASTLED_FORCE_CLEAR"] = new_value
     else:
-        os.environ["FASTLED_FORCE_CLEAR"] == "1"
+        os.environ["FASTLED_FORCE_CLEAR"] = "1"
 
 
 def force_image_removal() -> bool:
@@ -653,7 +653,7 @@ class DockerManager:
                     Example: {8080: 80} maps host port 8080 to container port 80
         """
         remove_previous = remove_previous or get_force_remove_image_previous()
-        if remove_previous:
+        if get_force_remove_image_previous():
             # make a banner print
             print(
                 "Force removing previous image due to FASTLED_FORCE_CLEAR environment variable."

{fastled-1.3.11 → fastled-1.3.14}/src/fastled/parse_args.py

@@ -157,7 +157,6 @@ def parse_args() -> Args:
     build_mode.add_argument(
         "--quick",
         action="store_true",
-        default=True,
         help="Build in quick mode (default)",
     )
     build_mode.add_argument(
@@ -209,11 +208,14 @@ def parse_args() -> Args:
     fastled_dir: Path | None = _find_fastled_repo(cwd)
     is_fastled_dir: bool = fastled_dir is not None
 
-    if is_fastled_dir:
-        # if --quick, --debug, --release are not specified then default to --debug
-        if not (args.debug or args.quick or args.release):
-            args.debug = True
-            print("Defaulting to --debug mode")
+    if not (args.debug or args.quick or args.release):
+        if is_fastled_dir:
+            # if --quick, --debug, --release are not specified then default to --debug
+            args.quick = True
+            print("Defaulting to --quick mode in fastled repo")
+        else:
+            args.quick = True
+            print("Defaulting to --quick mode")
 
     if args.build or args.interactive:
         if args.directory is not None:

{fastled-1.3.11 → fastled-1.3.14}/src/fastled/util.py

@@ -11,12 +11,17 @@ def hash_file(file_path: Path) -> str:
 
 
 def banner_string(msg: str) -> str:
-    """
-    Return `msg` surrounded by a border of # characters, including
-    leading and trailing newlines.
-    """
-    border = "#" * (len(msg) + 4)
-    return f"\n{border}\n# {msg}\n{border}\n"
+    lines = msg.splitlines()
+    max_length = max(len(line) for line in lines)
+    border = "#" * (max_length + 4)
+    bordered_lines = [f"# {line} " + "#" * (max_length - len(line)) for line in lines]
+    bordered_msg = "\n".join(bordered_lines)
+    return f"\n{border}\n{bordered_msg}\n{border}\n"
+
+
+def print_banner(msg: str) -> None:
+    """Print a message in a banner format."""
+    print(banner_string(msg))
 
 
 def port_is_free(port: int) -> bool:

{fastled-1.3.11 → fastled-1.3.14}/src/fastled.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastled
-Version: 1.3.11
+Version: 1.3.14
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies
@@ -20,7 +20,7 @@ Requires-Dist: progress>=1.6
 Requires-Dist: watchfiles>=1.0.5
 Requires-Dist: Flask>=3.0.0
 Requires-Dist: livereload
-Requires-Dist: fastled-wasm-server>=1.0.27
+Requires-Dist: disklru>=2.0.4
 Dynamic: home-page
 Dynamic: license-file
 Dynamic: maintainer
@@ -91,7 +91,11 @@ https://github.com/user-attachments/assets/64ae0e6c-5f8b-4830-ab87-dcc25bc61218
 pip install fastled
 ```
 
-**Note that you may need to install x86 docker emulation on Mac-m1 and later, as this is an x86 only image at the prsent.**
+# Debugger
+
+This tool features full C++ debugging through the browser.
+
+For instructions on setup see [DEBUGGER.md](DEBUGGER.md)
 
 # Command Line Use
 
@@ -389,12 +393,14 @@ A: A big chunk of space is being used by unnecessary javascript `emscripten` bun
 
 
 
+
   live-server --https --port=8416 --host=localhost .  --cert=C:/Users/niteris/dev/fastled-wasm/src/fastled/assets/localhost-key.pem --key=C:/Users/niteris/dev/fastled-wasm/src/fastled/assets/localhost.pem --no-browser
 
 
   live-server --https --cert=src/fastled/assets/localhost.pem --key=src/fastled/assets/localhost-key.pem --port=5500
 
 
+
 ## Performance
 
 ```

{fastled-1.3.11 → fastled-1.3.14}/src/fastled.egg-info/SOURCES.txt

@@ -2,7 +2,9 @@
 .dockerignore
 .gitignore
 .pylintrc
+DEBUGGER.md
 Dockerfile
+FAQ.md
 LICENSE
 MANIFEST.in
 README.md
@@ -13,6 +15,7 @@ build_local_docker.py
 build_site.py
 clean
 docker-compose.yml
+entrypoint.sh
 install
 install_linux.sh
 lint
@@ -33,18 +36,8 @@ upload_package.sh
 .vscode/launch.json
 .vscode/settings.json
 .vscode/tasks.json
-compiler/CMakeLists.txt
-compiler/arduino-pre-process.sh
 compiler/debug.sh
-compiler/entrypoint.sh
-compiler/final_prewarm.sh
-compiler/init_runtime.py
-compiler/install-arduino-cli.sh
-compiler/prewarm.sh
-compiler/process-ino.py
-compiler/pyproject.toml
 compiler/run.py
-compiler/libcompile/CMakeLists.txt
 demo/100dots.html
 demo/demo_threejs.html
 demo/micdemo.html
@@ -111,7 +104,6 @@ tests/unit/test_project_init.py
 tests/unit/test_server_and_client_seperatly.py
 tests/unit/test_string_diff.py
 tests/unit/test_version.py
-tests/unit/test_version_matches.py
 tests/unit/test_webcompile.py
 tests/unit/html/index.html
 tests/unit/test_ino/bad/bad.ino

{fastled-1.3.11 → fastled-1.3.14}/src/fastled.egg-info/requires.txt

@@ -8,4 +8,4 @@ progress>=1.6
 watchfiles>=1.0.5
 Flask>=3.0.0
 livereload
-fastled-wasm-server>=1.0.27
+disklru>=2.0.4

{fastled-1.3.11 → fastled-1.3.14}/test

@@ -19,8 +19,8 @@ if [[ "$*" == *"--full"* ]]; then
     uv run build_local_docker.py
 fi
 
-
-
+# If the test fails, then purge and try again
 pytest -x -v -s --durations=0 tests/unit "$@"
+
 # uv run pytest -n auto tests -v
 

{fastled-1.3.11 → fastled-1.3.14}/tests/unit/test_version.py

@@ -16,10 +16,11 @@ class MainTester(unittest.TestCase):
     def test_command(self) -> None:
         """Test command line interface (CLI)."""
         stdout = subprocess.check_output(COMMAND, shell=True)
+        version_stdout = stdout.decode("utf-8").strip()
         self.assertEqual(
-            stdout.decode("utf-8").strip(),
+            version_stdout,
             __version__,
-            f"Version mismatch: {stdout.decode('utf-8').strip()} != {__version__}",
+            f"FastLED Version mismatch: {version_stdout} (tool output) != {__version__} (package version)",
         )
 
 

fastled-1.3.11/Dockerfile

@@ -1,85 +0,0 @@
-
-# The only reason we use docker is because of the fastled-wasm-compiler.
-FROM niteris/fastled-wasm-compiler:latest
-
-
-# Get the compiler requirements and install them.
-COPY compiler/pyproject.toml /install/pyproject.toml
-RUN uv pip install --system -r /install/pyproject.toml
-
-# FIRST PRE-WARM CYCLE and initial setup: Download the fastled repo from the github and pre-warm the cache with a compilation.
-# This is by far the most expensive part of the build, because platformio needs to download initial tools. This
-# pre-warm cycle is "sticky" and tends to stay in the cache for a long time since docker is very relaxed about
-# invalidating cache layers that clone a github repo.
-
-RUN echo "force update4"
-ARG FASTLED_BUILD_DAY=echo $(date +'%Y-%m-%d')
-ENV FASTLED_BUILD_DAY=${FASTLED_BUILD_DAY}
-
-# ARG FASTLED_VERSION=master
-# ENV FASTLED_VERSION=${FASTLED_VERSION}
-# RUN mkdir -p /js/fastled && \
-#     rsync -a /git/fastled/ /js/fastled/ --exclude='.git'
-
-# Create symlinks for wasm platform files.
-COPY compiler/init_runtime.py /js/init_runtime.py
-#COPY compiler/prewarm.sh /js/prewarm.sh
-
-WORKDIR /js
-
-#ARG NO_PREWARM=0
-#ENV NO_PREWARM=${NO_PREWARM}
-
-#RUN python /js/init_runtime.py || true
-
-
-# First pre-warm cycle - always do it as part of the build.
-# RUN mkdir -p /logs
-
-# Force a build if the compiler flags change.
-#COPY compiler/CMakeLists.txt /trash/CMakeLists.txt
-#RUN rm -rf /trash
-
-#RUN chmod +x /js/prewarm.sh && \
-#    cat /js/prewarm.sh >> /logs/prewarm.log.0
-#RUN /js/prewarm.sh --force >> /logs/prewarm.log.1 || true
-
-
-
-# # Copy the fastled repo from the host machine and prepare for pre-warm
-# # Make sure and delete files that have been removed so that we don't get
-# # duplicate symbols from stale files.
-# COPY *.json /host/fastled/
-# COPY src/*.* /host/fastled/src/
-# COPY examples /host/fastled/examples
-# COPY src/fx /host/fastled/src/fx
-# COPY src/fl /host/fastled/src/fl
-# COPY src/lib8tion /host/fastled/src/lib8tion
-# COPY src/third_party /host/fastled/src/third_party
-# COPY src/sensors /host/fastled/src/sensors
-# COPY src/platforms /host/fastled/src/platforms
-
-RUN echo "force update"
-COPY compiler /js/compiler
-
-COPY compiler/entrypoint.sh /entrypoint.sh
-RUN chmod +x /entrypoint.sh && dos2unix /entrypoint.sh
-
-# RSYNC DISABLED FOR NOW
-# now sync local to the source directory.
-# RUN rsync -av /host/fastled/ /js/fastled/ && rm -rf /host/fastled
-
-# RUN python /js/init_runtime.py || true
-
-
-# SECOND PRE-WARM CYCLE: Copy the fastled repo from the host machine and pre-warm the cache with that compilation. This will
-# be much quicker than the first pre-warm cycle.
-# RUN /js/prewarm.sh --force > /logs/prewarm.log.2 || true
-
-# Now timestamp the image and store it at the end of the build.
-RUN date > /image_timestamp.txt
-
-ENTRYPOINT ["/entrypoint.sh"]
-CMD ["python", "/js/run.py", "server"]
-
-# CMD ["/bin/bash", "/entrypoint.sh"]