fastled 1.2.30__py3-none-any.whl → 1.2.31__py3-none-any.whl

fastled/__init__.py

@@ -1,6 +1,7 @@
 """FastLED Wasm Compiler package."""
 
 # context
+import shutil
 import subprocess
 from contextlib import contextmanager
 from multiprocessing import Process
@@ -15,7 +16,7 @@ from .types import BuildMode, CompileResult, CompileServerError
 # 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.2.30"
+__version__ = "1.2.31"
 
 
 class Api:
@@ -60,6 +61,7 @@ class Api:
     def live_client(
         sketch_directory: Path,
         host: str | CompileServer | None = None,
+        auto_updates: bool = True,
         auto_start=True,
         open_web_browser=True,
         keep_running=True,
@@ -69,6 +71,7 @@ class Api:
         return LiveClient(
             sketch_directory=sketch_directory,
             host=host,
+            auto_updates=auto_updates,
             auto_start=auto_start,
             open_web_browser=open_web_browser,
             keep_running=keep_running,
@@ -81,9 +84,11 @@ class Api:
         interactive=False,
         auto_updates=None,
         auto_start=True,
-        mapped_dir: Path | None = None,
-        container_name: str | None = None,
+        mapped_dir: Path | None = None,  # Sketch directory.
+        container_name: str | None = None,  # Specific docker container name.
+        remove_previous: bool = False,
     ) -> CompileServer:
+        """Uses docker to spawn a compile server from the given name."""
         from fastled.compile_server import CompileServer
 
         out = CompileServer(
@@ -92,6 +97,7 @@ class Api:
             auto_updates=auto_updates,
             mapped_dir=mapped_dir,
             auto_start=auto_start,
+            remove_previous=remove_previous,
         )
         return out
 
@@ -101,8 +107,9 @@ class Api:
         interactive=False,
         auto_updates=None,
         auto_start=True,
-        mapped_dir: Path | None = None,
-        container_name: str | None = None,
+        mapped_dir: Path | None = None,  # Sketch directory.
+        container_name: str | None = None,  # Specific docker container name.
+        remove_previous=False,
     ) -> Generator[CompileServer, None, None]:
         server = Api.spawn_server(
             interactive=interactive,
@@ -110,6 +117,7 @@ class Api:
             auto_start=auto_start,
             mapped_dir=mapped_dir,
             container_name=container_name,
+            remove_previous=remove_previous,
         )
         try:
             yield server
@@ -172,14 +180,37 @@ class Docker:
         # Create output directory if it doesn't exist
         output_dir.mkdir(parents=True, exist_ok=True)
 
+        git_dir = output_dir / ".git"
+        library_properties = output_dir / "library.properties"
+
+        git_dir_exists = git_dir.exists()
+        library_properties_exists = library_properties.exists()
+        library_properties_text = (
+            library_properties.read_text().strip() if library_properties_exists else ""
+        )
+
+        already_exists = (
+            git_dir_exists
+            and library_properties_exists
+            and "FastLED" in library_properties_text
+        )
+        if git_dir_exists and not already_exists:
+            if ".cache/fastled" in str(output_dir.as_posix()):
+                shutil.rmtree(output_dir)
+                already_exists = False
+            else:
+                raise ValueError(
+                    f"Output directory {output_dir} already exists but does not appear to be a FastLED repository."
+                )
+
         # Clone or update the repository
-        if (output_dir / ".git").exists():
+        if already_exists:
             print(f"Updating existing repository in {output_dir}")
             # Reset local changes and move HEAD back to handle force pushes
             subprocess.run(
                 ["git", "reset", "--hard", "HEAD~10"],
                 cwd=output_dir,
-                check=True,
+                check=False,
                 capture_output=True,  # Suppress output of reset
             )
             subprocess.run(
@@ -232,12 +263,14 @@ class Docker:
             remove_previous=True,  # Remove any existing container
         )
 
-        return container.name
+        return container.name  # Todo, create an external docker container api.
 
     @staticmethod
     def build_from_fastled_repo(
-        project_root: Path | str = Path("."), platform_tag: str = ""
-    ) -> str:
+        project_root: Path | str = Path("."),
+        interactive: bool = False,
+        sketch_folder: Path | None = None,
+    ) -> CompileServer:
         """Build the FastLED WASM compiler Docker image, which will be tagged as "main".
 
         Args:
@@ -250,15 +283,22 @@ class Docker:
         from fastled.docker_manager import DockerManager
         from fastled.settings import CONTAINER_NAME, IMAGE_NAME
 
+        project_root = Path(project_root)
+        if interactive:
+            if sketch_folder is None:
+                sketch_folder = project_root / "examples" / "wasm"
+        else:
+            if sketch_folder is not None:
+                raise ValueError(
+                    "Cannot specify sketch_folder when not in interactive mode."
+                )
         if isinstance(project_root, str):
             project_root = Path(project_root)
 
         dockerfile_path = (
             project_root / "src" / "platforms" / "wasm" / "compiler" / "Dockerfile"
         )
-
         docker_mgr = DockerManager()
-
         platform_tag = ""
         # if "arm" in docker_mgr.architecture():
         if (
@@ -280,18 +320,16 @@ class Docker:
             platform_tag=platform_tag,
         )
 
-        # Run the container and return it
-        container = docker_mgr.run_container_detached(
-            image_name=IMAGE_NAME,
-            tag="main",
+        out: CompileServer = CompileServer(
             container_name=CONTAINER_NAME,
-            command=None,  # Use default command from Dockerfile
-            volumes=None,  # No volumes needed for build
-            ports=None,  # No ports needed for build
-            remove_previous=True,  # Remove any existing container
+            interactive=interactive,
+            auto_updates=False,
+            mapped_dir=sketch_folder,
+            auto_start=True,
+            remove_previous=True,
         )
-        container_name = f"{container.name}"
-        return container_name
+
+        return out
 
 
 class Tools:

fastled/app.py

@@ -7,8 +7,9 @@ import sys
 import time
 from pathlib import Path
 
-from fastled.client_server import run_client, run_client_server
+from fastled.client_server import run_client_server
 from fastled.compile_server import CompileServer
+from fastled.filewatcher import file_watcher_set
 from fastled.parse_args import parse_args
 
 
@@ -49,8 +50,10 @@ def main() -> int:
     update: bool = args.update
     build: bool = args.build
     just_compile: bool = args.just_compile
-    directory: Path | None = Path(args.directory).absolute() if args.directory else None
+    # directory: Path | None = Path(args.directory).absolute() if args.directory else None
+    directory: Path | None = Path(args.directory) if args.directory else None
 
+    # broken for now
     if directory is None and interactive:
         # if examples/wasm exists
         if Path("examples/wasm").exists():
@@ -66,42 +69,36 @@ def main() -> int:
 
     if build:
         try:
+            file_watcher_set(False)
             project_root = Path(".").absolute()
             print(f"Building Docker image at {project_root}")
             from fastled import Api, Docker
 
-            docker_image_name = Docker.build_from_fastled_repo(
-                project_root=project_root
+            server = Docker.build_from_fastled_repo(
+                project_root=project_root, interactive=interactive
             )
-            print(f"Built Docker image: {docker_image_name}")
+            assert isinstance(server, CompileServer)
+
+            if interactive:
+                server.stop()
+                return 0
+            print(f"Built Docker image: {server.name}")
             if not directory:
-                print("No sketch directory specified. So exiting...")
+                if not directory:
+                    print("No directory specified")
+                server.stop()
                 return 0
+
             print("Running server")
-            with Api.server(
+            with Api.live_client(
                 auto_updates=False,
-                container_name=docker_image_name,
-                interactive=interactive,
-                mapped_dir=directory,
-            ) as server:
-                sketch_dir = Path("examples/wasm")
-                if just_compile:
-                    rtn = run_client(
-                        directory=sketch_dir,
-                        host=server,
-                        open_web_browser=False,
-                        keep_running=False,
-                    )
-                    if rtn != 0:
-                        print(f"Failed to compile: {rtn})")
-                    return rtn
-                print(f"Server started at {server.url()}")
-                with Api.live_client(
-                    sketch_directory=sketch_dir, host=server
-                ) as client:
-                    print(f"Client started at {client.url()}")
-                    while True:
-                        time.sleep(0.1)
+                sketch_directory=directory,
+                host=server,
+                auto_start=True,
+                keep_running=not just_compile,
+            ) as client:
+                print(f"Exited client {client.url()}")
+                print(f"Exiting {server.name}")
         except KeyboardInterrupt:
             print("\nExiting from client...")
             return 1
@@ -118,7 +115,8 @@ if __name__ == "__main__":
     # Note that the entry point for the exe is in cli.py
     try:
         sys.argv.append("-b")
-        sys.argv.append("-i")
+        sys.argv.append("examples/wasm")
+        # sys.argv.append()
         import os
 
         os.chdir("../fastled")

fastled/compile_server.py

@@ -14,6 +14,7 @@ class CompileServer:
         auto_start: bool = True,
         container_name: str | None = None,
         platform: Platform = Platform.WASM,
+        remove_previous: bool = False,
     ) -> None:
         from fastled.compile_server_impl import (  # avoid circular import
             CompileServerImpl,
@@ -27,6 +28,7 @@ class CompileServer:
             auto_updates=auto_updates,
             mapped_dir=mapped_dir,
             auto_start=auto_start,
+            remove_previous=remove_previous,
         )
 
     # May throw CompileServerError if server could not be started.
@@ -51,6 +53,10 @@ class CompileServer:
 
         project_init(example=example, outputdir=outputdir)
 
+    @property
+    def name(self) -> str:
+        return self.impl.container_name
+
     @property
     def running(self) -> bool:
         return self.impl.running

fastled/compile_server_impl.py

@@ -42,6 +42,7 @@ class CompileServerImpl:
         mapped_dir: Path | None = None,
         auto_start: bool = True,
         container_name: str | None = None,
+        remove_previous: bool = False,
     ) -> None:
         container_name = container_name or DEFAULT_CONTAINER_NAME
         if interactive and not mapped_dir:
@@ -49,7 +50,9 @@ class CompileServerImpl:
                 "Interactive mode requires a mapped directory point to a sketch"
             )
         if not interactive and mapped_dir:
-            raise ValueError("Mapped directory is only used in interactive mode")
+            warnings.warn(
+                f"Mapped directory {mapped_dir} is ignored in non-interactive mode"
+            )
         self.container_name = container_name
         self.mapped_dir = mapped_dir
         self.docker = DockerManager()
@@ -57,6 +60,7 @@ class CompileServerImpl:
         self.interactive = interactive
         self.running_container: RunningContainer | None = None
         self.auto_updates = auto_updates
+        self.remove_previous = remove_previous
         self._port = 0  # 0 until compile server is started
         if auto_start:
             self.start()
@@ -242,7 +246,7 @@ class CompileServerImpl:
                 command=cmd_str,
                 ports=ports,
                 volumes=volumes,
-                remove_previous=self.interactive,
+                remove_previous=self.interactive or self.remove_previous,
             )
             self.running_container = self.docker.attach_and_run(container)
             assert self.running_container is not None, "Container should be running"

fastled/filewatcher.py

@@ -16,6 +16,16 @@ from watchdog.observers import Observer
 from watchdog.observers.api import BaseObserver
 
 
+def file_watcher_enabled() -> bool:
+    """Check if watchdog is disabled"""
+    return os.getenv("NO_FILE_WATCHING", "0") == "1"
+
+
+def file_watcher_set(enabled: bool) -> None:
+    """Set the file watcher enabled state"""
+    os.environ["NO_FILE_WATCHING"] = "1" if not enabled else "0"
+
+
 class MyEventHandler(FileSystemEventHandler):
     def __init__(
         self,
@@ -119,6 +129,9 @@ class FileChangedNotifier(threading.Thread):
         Returns:
             Changed filepath or None if no change within timeout
         """
+        if file_watcher_enabled():
+            time.sleep(timeout)
+            return None
         try:
             filepath = self.change_queue.get(timeout=timeout)
             current_time = time.time()

fastled/live_client.py

@@ -1,4 +1,5 @@
 import threading
+import warnings
 from pathlib import Path
 
 from fastled.compile_server import CompileServer
@@ -13,6 +14,7 @@ class LiveClient:
         sketch_directory: Path,
         host: str | CompileServer | None = None,
         auto_start: bool = True,
+        auto_updates: bool = True,
         open_web_browser: bool = True,
         keep_running: bool = True,
         build_mode: BuildMode = BuildMode.QUICK,
@@ -27,8 +29,11 @@ class LiveClient:
         self.auto_start = auto_start
         self.shutdown = threading.Event()
         self.thread: threading.Thread | None = None
+        self.auto_updates = auto_updates
         if auto_start:
             self.start()
+        if self.auto_updates is False:
+            warnings.warn("Auto updates False are not supported yet.")
 
     def run(self) -> int:
         """Run the client."""

fastled/test/examples.py

@@ -32,6 +32,7 @@ def test_examples(
             print(f"Compilation took: {diff:.2f} seconds")
             result = Api.web_compile(sketch_dir, host=host)
             if not result.success:
+                print(f"Compilation failed for {example}: {result.stdout}")
                 out[example] = Exception(result.stdout)
     return out
 

{fastled-1.2.30.dist-info → fastled-1.2.31.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: fastled
-Version: 1.2.30
+Version: 1.2.31
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies
@@ -295,6 +295,7 @@ A: A big chunk of space is being used by unnecessary javascript `emscripten` bun
 
 # Revisions
 
+  * 1.2.31 - Bunch of fixes and ease of use while compiling code in the repo.
   * 1.2.22 - Prefer to use `live-server` from npm. If npm exists on the system then do a background install of `live-server` for next run.
   * 1.2.20 - Fixed up path issue for web browser launch for hot reload.
   * 1.2.19 - Compilation failure now overwrites the index.html file with error message.

{fastled-1.2.30.dist-info → fastled-1.2.31.dist-info}/RECORD

@@ -1,13 +1,13 @@
-fastled/__init__.py,sha256=hp7u_kd2j03u0duINhqIYse6uptL3srBEAlOG9X5jxU,11205
-fastled/app.py,sha256=DeKOay8pTu1hWkCqTlAiEGcE45FmoWStoDGPh2V3d4E,4233
+fastled/__init__.py,sha256=n_KTHS96sx02p7xJGuZgVXsUUoNZOJrPVjfwkB6aDRs,12740
+fastled/app.py,sha256=H1V4_BKQTH0jARJZT8zGrabCkREHBxTXSbgZeSOPwuk,4005
 fastled/cli.py,sha256=FjVr31ht0UPlAcmX-84NwfAGMQHTkrCe4o744jCAxiw,375
 fastled/client_server.py,sha256=eORWVyI1PvyowmhLWt3V9aI_AemPSBL9bAkjMBD2kAw,14282
-fastled/compile_server.py,sha256=g0y9vEZqpzAJEUwketV8lbwI8VZNSSLuOuwcF04k-dw,2775
-fastled/compile_server_impl.py,sha256=JY7cDwFR1qZ05UtPkpCzkrylibpSMVlt7zudI6mnoYM,9895
+fastled/compile_server.py,sha256=ul3eiZNX2wwmInooo3PJC3_kNpdejYVDIo94G3sV9HQ,2941
+fastled/compile_server_impl.py,sha256=ygE471lKGidQKYnGNRt-PRYtf3MW1i293QT5ULuOhLE,10048
 fastled/docker_manager.py,sha256=cIxOSeHnDqrT5IWPP1sl1cF8XYy3sUNfoOE-JpuKr3U,29815
-fastled/filewatcher.py,sha256=9zjA2cJMSNioaas_igurElSzBOu9To4CPnV-tthDMvg,6707
+fastled/filewatcher.py,sha256=XjFTo6NvEaosGTPr2Uhj91aqmtFdYHzJfxPzjBTMkKA,7086
 fastled/keyboard.py,sha256=vyYxE98WCXjvMpcUJd0YXPVvt7TzvBmifLYI-K7jtKg,3524
-fastled/live_client.py,sha256=b9mVJ-8w_zoEDwKIlAEUC5Q1La5W5rR6ct-exOcgJec,2561
+fastled/live_client.py,sha256=MDauol0mxtXggV1Pv9ahC0Jjg_4wnnV6FjGEtdd9cxU,2763
 fastled/open_browser.py,sha256=DDzOXNYVYLIDWVdmpJ-jLxZSAs5mw3VGHo2UIJ-T8SE,4339
 fastled/open_browser2.py,sha256=jUgN81bEYX-sr0zKTVJkwj9tXEVq7aZTxGUP_ShyCbs,3614
 fastled/parse_args.py,sha256=23EoqEf7MF7WEYIufcjCanttz-hiDE2E3z1X73p6rIQ,6908
@@ -24,10 +24,10 @@ fastled/web_compile.py,sha256=05PeLJ77QQC6PUKjDhsntBmyBola6QQIfF2k-zjYNE4,10261
 fastled/assets/example.txt,sha256=lTBovRjiz0_TgtAtbA1C5hNi2ffbqnNPqkKg6UiKCT8,54
 fastled/site/build.py,sha256=l4RajIk0bApiAifT1lyLjIZi9lpPtSba4cnwWP5UOKc,14064
 fastled/test/can_run_local_docker_tests.py,sha256=LEuUbHctRhNNFWcvnz2kEGmjDJeXO4c3kNpizm3yVJs,400
-fastled/test/examples.py,sha256=6xPwx_k9_XwYTpI1nk4SrYbsJKHJACd30GzD1epGqhY,1597
-fastled-1.2.30.dist-info/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
-fastled-1.2.30.dist-info/METADATA,sha256=yTlr6UHXMo0moswF8vqksLz6p5pgm2ETfCquLoKillc,21176
-fastled-1.2.30.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-fastled-1.2.30.dist-info/entry_points.txt,sha256=RCwmzCSOS4-C2i9EziANq7Z2Zb4KFnEMR1FQC0bBwAw,101
-fastled-1.2.30.dist-info/top_level.txt,sha256=Bbv5kpJpZhWNCvDF4K0VcvtBSDMa8B7PTOrZa9CezHY,8
-fastled-1.2.30.dist-info/RECORD,,
+fastled/test/examples.py,sha256=GfaHeY1E8izBl6ZqDVjz--RHLyVR4NRnQ5pBesCFJFY,1673
+fastled-1.2.31.dist-info/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
+fastled-1.2.31.dist-info/METADATA,sha256=9qms9oXGZVJqiAs7xLnlS8tN9yJdKhuPpqHR7CZh01I,21254
+fastled-1.2.31.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+fastled-1.2.31.dist-info/entry_points.txt,sha256=RCwmzCSOS4-C2i9EziANq7Z2Zb4KFnEMR1FQC0bBwAw,101
+fastled-1.2.31.dist-info/top_level.txt,sha256=Bbv5kpJpZhWNCvDF4K0VcvtBSDMa8B7PTOrZa9CezHY,8
+fastled-1.2.31.dist-info/RECORD,,