fastled 1.1.34__py2.py3-none-any.whl → 1.1.36__py2.py3-none-any.whl

fastled/__init__.py

@@ -1,3 +1,70 @@
 """FastLED Wasm Compiler package."""
 
-__version__ = "1.1.34"
+from pathlib import Path
+
+from .compile_server import CompileServer
+from .types import WebCompileResult
+
+__version__ = "1.1.36"
+
+
+class Api:
+    @staticmethod
+    def get_examples():
+        from fastled.project_init import get_examples
+
+        return get_examples()
+
+    @staticmethod
+    def project_init(
+        example=None, outputdir=None, host: str | CompileServer | None = None
+    ) -> Path:
+        from fastled.project_init import project_init
+
+        if isinstance(host, CompileServer):
+            host = host.url()
+        return project_init(example, outputdir, host)
+
+    @staticmethod
+    def web_compile(
+        directory, host: str | CompileServer | None = None
+    ) -> WebCompileResult:
+        from fastled.web_compile import web_compile
+
+        if isinstance(host, CompileServer):
+            host = host.url()
+
+        out: WebCompileResult = web_compile(directory, host)
+        return out
+
+    @staticmethod
+    def spawn_server(
+        sketch_directory: Path | None = None,
+        interactive=False,
+        auto_updates=None,
+        auto_start=True,
+        container_name: str | None = None,
+    ):
+        from fastled.compile_server import CompileServer
+
+        out = CompileServer(
+            container_name=container_name,
+            interactive=interactive,
+            auto_updates=auto_updates,
+            mapped_dir=sketch_directory,
+            auto_start=auto_start,
+        )
+        return out
+
+
+class Test:
+    @staticmethod
+    def test_examples(
+        examples: list[str] | None = None, host: str | CompileServer | None = None
+    ) -> Exception | None:
+        from fastled.test.examples import test_examples
+
+        if isinstance(host, CompileServer):
+            host = host.url()
+
+        return test_examples(examples=examples, host=host)

fastled/app.py

@@ -17,14 +17,17 @@ def run_server(args: argparse.Namespace) -> int:
     auto_update = args.auto_update
     mapped_dir = Path(args.directory).absolute() if args.directory else None
     compile_server = CompileServer(
-        interactive=interactive, auto_updates=auto_update, mapped_dir=mapped_dir
+        interactive=interactive,
+        auto_updates=auto_update,
+        mapped_dir=mapped_dir,
+        auto_start=True,
     )
+
     if not interactive:
         print(f"Server started at {compile_server.url()}")
-        compile_server.wait_for_startup()
     try:
         while True:
-            if not compile_server.proceess_running():
+            if not compile_server.process_running():
                 print("Server process is not running. Exiting...")
                 return 1
             time.sleep(0.1)

fastled/client_server.py

@@ -8,10 +8,10 @@ from pathlib import Path
 from fastled.build_mode import BuildMode, get_build_mode
 from fastled.compile_server import CompileServer
 from fastled.docker_manager import DockerManager
-from fastled.env import DEFAULT_URL
 from fastled.filewatcher import FileWatcherProcess
 from fastled.keyboard import SpaceBarWatcher
 from fastled.open_browser import open_browser_process
+from fastled.settings import DEFAULT_URL
 from fastled.sketch import looks_like_sketch_directory
 
 # CompiledResult
@@ -112,7 +112,7 @@ def _try_start_server_or_get_url(args: argparse.Namespace) -> str | CompileServe
             print("No local server found, starting one...")
             compile_server = CompileServer(auto_updates=auto_update)
             print("Waiting for the local compiler to start...")
-            if not compile_server.wait_for_startup():
+            if not compile_server.ping():
                 print("Failed to start local compiler.")
                 raise RuntimeError("Failed to start local compiler.")
             return compile_server
@@ -254,7 +254,7 @@ def run_client_server(args: argparse.Namespace) -> int:
             if changed:
                 print_status()
                 continue
-            if compile_server and not compile_server.proceess_running():
+            if compile_server and not compile_server.process_running():
                 print("Server process is not running. Exiting...")
                 return 1
             if source_code_watcher is not None:

fastled/compile_server.py

@@ -1,193 +1,82 @@
-import subprocess
-import time
-from datetime import datetime, timezone
 from pathlib import Path
 
-import httpx
-
-from fastled.docker_manager import (
-    DISK_CACHE,
-    Container,
-    DockerManager,
-    RunningContainer,
-)
-from fastled.sketch import looks_like_fastled_repo
-
-_IMAGE_NAME = "niteris/fastled-wasm"
-_DEFAULT_CONTAINER_NAME = "fastled-wasm-compiler"
-
-SERVER_PORT = 9021
-
-SERVER_OPTIONS = ["--allow-shutdown", "--no-auto-update"]
+from fastled.build_mode import BuildMode
+from fastled.types import WebCompileResult
 
 
 class CompileServer:
     def __init__(
         self,
-        container_name=_DEFAULT_CONTAINER_NAME,
         interactive: bool = False,
         auto_updates: bool | None = None,
         mapped_dir: Path | None = None,
+        auto_start: bool = True,
+        container_name: str | None = None,
     ) -> None:
-        if interactive and not mapped_dir:
-            raise ValueError(
-                "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")
-        cwd = Path(".").resolve()
-        fastled_src_dir: Path | None = None
-        if looks_like_fastled_repo(cwd):
-            print(
-                "Looks like a FastLED repo, using it as the source directory and mapping it into the server."
-            )
-            fastled_src_dir = cwd / "src"
-
-        self.container_name = container_name
-        self.mapped_dir = mapped_dir
-        self.docker = DockerManager()
-        self.fastled_src_dir: Path | None = fastled_src_dir
-        self.interactive = interactive
-        self.running_container: RunningContainer | None = None
-        self.auto_updates = auto_updates
-        self._port = self._start()
-        # fancy print
-        if not interactive:
-            msg = f"# FastLED Compile Server started at {self.url()} #"
-            print("\n" + "#" * len(msg))
-            print(msg)
-            print("#" * len(msg) + "\n")
+        from fastled.compile_server_impl import (  # avoid circular import
+            CompileServerImpl,
+        )
+
+        self.impl = CompileServerImpl(
+            container_name=container_name,
+            interactive=interactive,
+            auto_updates=auto_updates,
+            mapped_dir=mapped_dir,
+            auto_start=auto_start,
+        )
+
+    def start(self, wait_for_startup=True) -> None:
+        # from fastled.compile_server_impl import CompileServerImpl  # avoid circular import
+        self.impl.start(wait_for_startup=wait_for_startup)
+
+    def web_compile(
+        self,
+        directory: Path | str,
+        build_mode: BuildMode = BuildMode.QUICK,
+        profile: bool = False,
+    ) -> WebCompileResult:
+        return self.impl.web_compile(
+            directory=directory, build_mode=build_mode, profile=profile
+        )
+
+    def project_init(
+        self, example: str | None = None, outputdir: Path | None = None
+    ) -> None:
+        from fastled.project_init import project_init  # avoid circular import
+
+        project_init(example=example, outputdir=outputdir)
 
     @property
     def running(self) -> bool:
-        if not self._port:
-            return False
-        if not DockerManager.is_docker_installed():
-            return False
-        if not DockerManager.is_running():
-            return False
-        return self.docker.is_container_running(self.container_name)
+        return self.impl.running
+
+    @property
+    def fastled_src_dir(self) -> Path | None:
+        return self.impl.fastled_src_dir
 
     def using_fastled_src_dir_volume(self) -> bool:
-        return self.fastled_src_dir is not None
+        return self.impl.using_fastled_src_dir_volume()
 
     def port(self) -> int:
-        return self._port
+        return self.impl.port()
 
     def url(self) -> str:
-        return f"http://localhost:{self._port}"
+        return self.impl.url()
+
+    def ping(self) -> bool:
+        return self.impl.ping()
 
+    # by default this is automatically called by the constructor, unless
+    # auto_start is set to False.
     def wait_for_startup(self, timeout: int = 100) -> bool:
         """Wait for the server to start up."""
-        start_time = time.time()
-        while time.time() - start_time < timeout:
-            # ping the server to see if it's up
-            if not self._port:
-                return False
-            # use httpx to ping the server
-            # if successful, return True
-            try:
-                response = httpx.get(
-                    f"http://localhost:{self._port}", follow_redirects=True
-                )
-                if response.status_code < 400:
-                    return True
-            except KeyboardInterrupt:
-                raise
-            except Exception:
-                pass
-            time.sleep(0.1)
-            if not self.docker.is_container_running(self.container_name):
-                return False
-        return False
+        return self.impl.wait_for_startup(timeout=timeout)
 
     def _start(self) -> int:
-        print("Compiling server starting")
-
-        # Ensure Docker is running
-        if not self.docker.is_running():
-            if not self.docker.start():
-                print("Docker could not be started. Exiting.")
-                raise RuntimeError("Docker could not be started. Exiting.")
-        now = datetime.now(timezone.utc)
-        now_str = now.strftime("%Y-%m-%d")
-
-        upgrade = False
-        if self.auto_updates is None:
-            prev_date_str = DISK_CACHE.get("last-update")
-            if prev_date_str != now_str:
-                print("One day has passed, checking docker for updates")
-                upgrade = True
-        else:
-            upgrade = self.auto_updates
-        self.docker.validate_or_download_image(
-            image_name=_IMAGE_NAME, tag="main", upgrade=upgrade
-        )
-        DISK_CACHE.put("last-update", now_str)
-
-        print("Docker image now validated")
-        port = SERVER_PORT
-        if self.interactive:
-            server_command = ["/bin/bash"]
-        else:
-            server_command = ["python", "/js/run.py", "server"] + SERVER_OPTIONS
-        ports = {80: port}
-        volumes = None
-        if self.fastled_src_dir:
-            print(
-                f"Mounting FastLED source directory {self.fastled_src_dir} into container /host/fastled/src"
-            )
-            volumes = {
-                str(self.fastled_src_dir): {"bind": "/host/fastled/src", "mode": "ro"}
-            }
-        if self.interactive:
-            # add the mapped directory to the container
-            print(f"Mounting {self.mapped_dir} into container /mapped")
-            # volumes = {str(self.mapped_dir): {"bind": "/mapped", "mode": "rw"}}
-            # add it
-            assert self.mapped_dir is not None
-            dir_name = self.mapped_dir.name
-            if not volumes:
-                volumes = {}
-            volumes[str(self.mapped_dir)] = {
-                "bind": f"/mapped/{dir_name}",
-                "mode": "rw",
-            }
-
-        cmd_str = subprocess.list2cmdline(server_command)
-        if not self.interactive:
-            container: Container = self.docker.run_container_detached(
-                image_name=_IMAGE_NAME,
-                tag="main",
-                container_name=self.container_name,
-                command=cmd_str,
-                ports=ports,
-                volumes=volumes,
-                remove_previous=self.interactive,
-            )
-            self.running_container = self.docker.attach_and_run(container)
-            assert self.running_container is not None, "Container should be running"
-            print("Compile server starting")
-            return port
-        else:
-            self.docker.run_container_interactive(
-                image_name=_IMAGE_NAME,
-                tag="main",
-                container_name=self.container_name,
-                command=cmd_str,
-                ports=ports,
-                volumes=volumes,
-            )
-
-            print("Exiting interactive mode")
-            return port
-
-    def proceess_running(self) -> bool:
-        return self.docker.is_container_running(self.container_name)
+        return self.impl._start()
 
     def stop(self) -> None:
-        # print(f"Stopping server on port {self._port}")
-        if self.running_container:
-            self.running_container.stop()
-        self.docker.suspend_container(self.container_name)
-        print("Compile server stopped")
+        return self.impl.stop()
+
+    def process_running(self) -> bool:
+        return self.impl.process_running()

fastled/compile_server_impl.py

@@ -0,0 +1,244 @@
+import subprocess
+import time
+import warnings
+from datetime import datetime, timezone
+from pathlib import Path
+
+import httpx
+
+from fastled.build_mode import BuildMode
+from fastled.docker_manager import (
+    DISK_CACHE,
+    Container,
+    DockerManager,
+    RunningContainer,
+)
+from fastled.settings import SERVER_PORT
+from fastled.sketch import looks_like_fastled_repo
+from fastled.types import WebCompileResult
+
+_IMAGE_NAME = "niteris/fastled-wasm"
+_DEFAULT_CONTAINER_NAME = "fastled-wasm-compiler"
+
+
+SERVER_OPTIONS = ["--allow-shutdown", "--no-auto-update"]
+
+
+class CompileServerImpl:
+    def __init__(
+        self,
+        interactive: bool = False,
+        auto_updates: bool | None = None,
+        mapped_dir: Path | None = None,
+        auto_start: bool = True,
+        container_name: str | None = None,
+    ) -> None:
+        container_name = container_name or _DEFAULT_CONTAINER_NAME
+        if interactive and not mapped_dir:
+            raise ValueError(
+                "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")
+        cwd = Path(".").resolve()
+        fastled_src_dir: Path | None = None
+        if looks_like_fastled_repo(cwd):
+            print(
+                "Looks like a FastLED repo, using it as the source directory and mapping it into the server."
+            )
+            fastled_src_dir = cwd / "src"
+
+        self.container_name = container_name
+        self.mapped_dir = mapped_dir
+        self.docker = DockerManager()
+        self.fastled_src_dir: Path | None = fastled_src_dir
+        self.interactive = interactive
+        self.running_container: RunningContainer | None = None
+        self.auto_updates = auto_updates
+        # self._port = self._start()
+        self._port = 0  # 0 until compile server is started
+        # fancy print
+        if not interactive:
+            msg = f"# FastLED Compile Server started at {self.url()} #"
+            print("\n" + "#" * len(msg))
+            print(msg)
+            print("#" * len(msg) + "\n")
+        if auto_start:
+            self.start()
+
+    def start(self, wait_for_startup=True) -> None:
+        if self._port != 0:
+            warnings.warn("Server has already been started")
+        self._port = self._start()
+        if wait_for_startup:
+            self.wait_for_startup()
+
+    def web_compile(
+        self,
+        directory: Path | str,
+        build_mode: BuildMode = BuildMode.QUICK,
+        profile: bool = False,
+    ) -> WebCompileResult:
+        from fastled.web_compile import web_compile  # avoid circular import
+
+        if not self._port:
+            raise RuntimeError("Server has not been started yet")
+        if not self.ping():
+            raise RuntimeError("Server is not running")
+        out: WebCompileResult = web_compile(
+            directory, host=self.url(), build_mode=build_mode, profile=profile
+        )
+        return out
+
+    def project_init(
+        self, example: str | None = None, outputdir: Path | None = None
+    ) -> None:
+        from fastled.project_init import project_init  # avoid circular import
+
+        project_init(example=example, outputdir=outputdir)
+
+    @property
+    def running(self) -> bool:
+        if not self._port:
+            return False
+        if not DockerManager.is_docker_installed():
+            return False
+        if not DockerManager.is_running():
+            return False
+        return self.docker.is_container_running(self.container_name)
+
+    def using_fastled_src_dir_volume(self) -> bool:
+        return self.fastled_src_dir is not None
+
+    def port(self) -> int:
+        if self._port == 0:
+            warnings.warn("Server has not been started yet")
+        return self._port
+
+    def url(self) -> str:
+        if self._port == 0:
+            warnings.warn("Server has not been started yet")
+        return f"http://localhost:{self._port}"
+
+    def ping(self) -> bool:
+        try:
+            response = httpx.get(
+                f"http://localhost:{self._port}", follow_redirects=True
+            )
+            if response.status_code < 400:
+                return True
+        except KeyboardInterrupt:
+            raise
+        except Exception:
+            pass
+        return False
+
+    # by default this is automatically called by the constructor, unless
+    # auto_start is set to False.
+    def wait_for_startup(self, timeout: int = 100) -> bool:
+        """Wait for the server to start up."""
+        start_time = time.time()
+        while time.time() - start_time < timeout:
+            # ping the server to see if it's up
+            if not self._port:
+                return False
+            # use httpx to ping the server
+            # if successful, return True
+            if self.ping():
+                return True
+            time.sleep(0.1)
+            if not self.docker.is_container_running(self.container_name):
+                return False
+        return False
+
+    def _start(self) -> int:
+        print("Compiling server starting")
+
+        # Ensure Docker is running
+        if not self.docker.is_running():
+            if not self.docker.start():
+                print("Docker could not be started. Exiting.")
+                raise RuntimeError("Docker could not be started. Exiting.")
+        now = datetime.now(timezone.utc)
+        now_str = now.strftime("%Y-%m-%d")
+
+        upgrade = False
+        if self.auto_updates is None:
+            prev_date_str = DISK_CACHE.get("last-update")
+            if prev_date_str != now_str:
+                print("One day has passed, checking docker for updates")
+                upgrade = True
+        else:
+            upgrade = self.auto_updates
+        self.docker.validate_or_download_image(
+            image_name=_IMAGE_NAME, tag="main", upgrade=upgrade
+        )
+        DISK_CACHE.put("last-update", now_str)
+
+        print("Docker image now validated")
+        port = SERVER_PORT
+        if self.interactive:
+            server_command = ["/bin/bash"]
+        else:
+            server_command = ["python", "/js/run.py", "server"] + SERVER_OPTIONS
+        ports = {80: port}
+        volumes = None
+        if self.fastled_src_dir:
+            print(
+                f"Mounting FastLED source directory {self.fastled_src_dir} into container /host/fastled/src"
+            )
+            volumes = {
+                str(self.fastled_src_dir): {"bind": "/host/fastled/src", "mode": "ro"}
+            }
+        if self.interactive:
+            # add the mapped directory to the container
+            print(f"Mounting {self.mapped_dir} into container /mapped")
+            # volumes = {str(self.mapped_dir): {"bind": "/mapped", "mode": "rw"}}
+            # add it
+            assert self.mapped_dir is not None
+            dir_name = self.mapped_dir.name
+            if not volumes:
+                volumes = {}
+            volumes[str(self.mapped_dir)] = {
+                "bind": f"/mapped/{dir_name}",
+                "mode": "rw",
+            }
+
+        cmd_str = subprocess.list2cmdline(server_command)
+        if not self.interactive:
+            container: Container = self.docker.run_container_detached(
+                image_name=_IMAGE_NAME,
+                tag="main",
+                container_name=self.container_name,
+                command=cmd_str,
+                ports=ports,
+                volumes=volumes,
+                remove_previous=self.interactive,
+            )
+            self.running_container = self.docker.attach_and_run(container)
+            assert self.running_container is not None, "Container should be running"
+            print("Compile server starting")
+            return port
+        else:
+            self.docker.run_container_interactive(
+                image_name=_IMAGE_NAME,
+                tag="main",
+                container_name=self.container_name,
+                command=cmd_str,
+                ports=ports,
+                volumes=volumes,
+            )
+
+            print("Exiting interactive mode")
+            return port
+
+    def process_running(self) -> bool:
+        return self.docker.is_container_running(self.container_name)
+
+    def stop(self) -> None:
+        if self.running_container:
+            self.running_container.detach()
+            self.running_container = None
+        self.docker.suspend_container(self.container_name)
+        self._port = 0
+        print("Compile server stopped")

fastled/docker_manager.py

@@ -89,7 +89,7 @@ class RunningContainer:
                 print(f"Error monitoring logs: {e}")
                 break
 
-    def stop(self) -> None:
+    def detach(self) -> None:
         """Stop monitoring the container logs"""
         self.running = False
         self.thread.join()

fastled/parse_args.py

@@ -5,9 +5,9 @@ from pathlib import Path
 
 from fastled import __version__
 from fastled.docker_manager import DockerManager
-from fastled.env import DEFAULT_URL
 from fastled.project_init import project_init
 from fastled.select_sketch_directory import select_sketch_directory
+from fastled.settings import DEFAULT_URL
 from fastled.sketch import (
     find_sketch_directories,
     looks_like_fastled_repo,
@@ -150,6 +150,7 @@ def parse_args() -> argparse.Namespace:
             if looks_like_sketch_directory(maybe_sketch_dir):
                 args.directory = str(maybe_sketch_dir)
             else:
+                print("Searching for sketch directories...")
                 sketch_directories = find_sketch_directories(maybe_sketch_dir)
                 selected_dir = select_sketch_directory(
                     sketch_directories, cwd_is_fastled

fastled/project_init.py

@@ -3,7 +3,7 @@ from pathlib import Path
 
 import httpx
 
-from fastled.env import DEFAULT_URL
+from fastled.settings import DEFAULT_URL
 
 ENDPOINT_PROJECT_INIT = f"{DEFAULT_URL}/project/init"
 ENDPOINT_INFO = f"{DEFAULT_URL}/info"
@@ -33,13 +33,17 @@ def _prompt_for_example() -> str:
             return answer
 
 
-def project_init(example: str | None = None, outputdir: Path | None = None) -> Path:
+def project_init(
+    example: str | None = "PROMPT",  # prompt for example
+    outputdir: Path | None = None,
+    host: str | None = None,
+) -> Path:
     """
     Initialize a new FastLED project.
     """
-
+    host = host or DEFAULT_URL
     outputdir = outputdir or Path("fastled")
-    if example is None:
+    if example == "PROMPT" or example is None:
         try:
             example = _prompt_for_example()
         except httpx.HTTPStatusError:
@@ -48,7 +52,8 @@ def project_init(example: str | None = None, outputdir: Path | None = None) -> P
             )
             example = DEFAULT_EXAMPLE
     assert example is not None
-    response = httpx.get(f"{ENDPOINT_PROJECT_INIT}/{example}", timeout=20)
+    endpoint_url = f"{host}/project/init/{example}"
+    response = httpx.get(endpoint_url, timeout=20)
     response.raise_for_status()
     content = response.content
     tmpzip = outputdir / "fastled.zip"

fastled/{env.py → settings.py}

@@ -6,3 +6,4 @@ IS_ARM: bool = "arm" in MACHINE or "aarch64" in MACHINE
 PLATFORM_TAG: str = "-arm64" if IS_ARM else ""
 CONTAINER_NAME = f"fastled-wasm-compiler{PLATFORM_TAG}"
 DEFAULT_URL = str(os.environ.get("FASTLED_URL", "https://fastled.onrender.com"))
+SERVER_PORT = 9021

fastled/sketch.py

@@ -1,8 +1,11 @@
 import os
 from pathlib import Path
 
+_MAX_FILES_SEARCH_LIMIT = 10000
+
 
 def find_sketch_directories(directory: Path) -> list[Path]:
+    file_count = 0
     sketch_directories: list[Path] = []
     # search all the paths one level deep
     for path in directory.iterdir():
@@ -10,6 +13,12 @@ def find_sketch_directories(directory: Path) -> list[Path]:
             dir_name = path.name
             if str(dir_name).startswith("."):
                 continue
+            file_count += 1
+            if file_count > _MAX_FILES_SEARCH_LIMIT:
+                print(
+                    f"More than {_MAX_FILES_SEARCH_LIMIT} files found. Stopping search."
+                )
+                break
 
             if looks_like_sketch_directory(path, quick=True):
                 sketch_directories.append(path)
@@ -24,6 +33,7 @@ def find_sketch_directories(directory: Path) -> list[Path]:
 
 
 def get_sketch_files(directory: Path) -> list[Path]:
+    file_count = 0
     files: list[Path] = []
     for root, dirs, filenames in os.walk(directory):
         # ignore hidden directories
@@ -32,10 +42,21 @@ def get_sketch_files(directory: Path) -> list[Path]:
         dirs[:] = [d for d in dirs if "fastled_js" not in d]
         # ignore hidden files
         filenames = [f for f in filenames if not f.startswith(".")]
+        outer_break = False
         for filename in filenames:
             if "platformio.ini" in filename:
                 continue
+            file_count += 1
+            if file_count > _MAX_FILES_SEARCH_LIMIT:
+                print(
+                    f"More than {_MAX_FILES_SEARCH_LIMIT} files found. Stopping search."
+                )
+                outer_break = True
+                break
             files.append(Path(root) / filename)
+        if outer_break:
+            break
+
     return files
 
 

fastled/test/examples.py

@@ -0,0 +1,16 @@
+from fastled import WebCompileResult
+
+
+def test_examples(
+    examples: list[str] | None = None, host: str | None = None
+) -> Exception | None:
+    """Test the examples in the given directory."""
+    from fastled import Api
+
+    examples = Api.get_examples() if examples is None else examples
+    for example in examples:
+        print(f"Compiling example: {example}")
+        out: WebCompileResult = Api.web_compile(example, host=host)
+        if not out.success:
+            return Exception(out.stdout)
+    return None

fastled/types.py

@@ -1,4 +1,5 @@
 from dataclasses import dataclass
+from typing import Any
 
 
 @dataclass
@@ -8,3 +9,17 @@ class CompiledResult:
     success: bool
     fastled_js: str
     hash_value: str | None
+
+
+@dataclass
+class WebCompileResult:
+    success: bool
+    stdout: str
+    hash_value: str | None
+    zip_bytes: bytes
+
+    def __bool__(self) -> bool:
+        return self.success
+
+    def to_dict(self) -> dict[str, Any]:
+        return self.__dict__.copy()

fastled/web_compile.py

@@ -12,8 +12,9 @@ from pathlib import Path
 import httpx
 
 from fastled.build_mode import BuildMode
-from fastled.compile_server import SERVER_PORT
+from fastled.settings import SERVER_PORT
 from fastled.sketch import get_sketch_files
+from fastled.types import WebCompileResult
 from fastled.util import hash_file
 
 DEFAULT_HOST = "https://fastled.onrender.com"
@@ -31,17 +32,6 @@ class ConnectionResult:
     ipv4: bool
 
 
-@dataclass
-class WebCompileResult:
-    success: bool
-    stdout: str
-    hash_value: str | None
-    zip_bytes: bytes
-
-    def __bool__(self) -> bool:
-        return self.success
-
-
 def _sanitize_host(host: str) -> str:
     if host.startswith("http"):
         return host
@@ -165,12 +155,14 @@ def find_good_connection(
 
 
 def web_compile(
-    directory: Path,
+    directory: Path | str,
     host: str | None = None,
     auth_token: str | None = None,
     build_mode: BuildMode | None = None,
     profile: bool = False,
 ) -> WebCompileResult:
+    if isinstance(directory, str):
+        directory = Path(directory)
     host = _sanitize_host(host or DEFAULT_HOST)
     build_mode = build_mode or BuildMode.QUICK
     print("Compiling on", host)

{fastled-1.1.34.dist-info → fastled-1.1.36.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastled
-Version: 1.1.34
+Version: 1.1.36
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies
@@ -163,6 +163,8 @@ A: A big chunk of space is being used by unnecessary javascript `emscripten` is
 
 # Revisions
   
+  * 1.1.36 - We now have an api. `from fastled import Api` and `from fastled import Test` for testing.
+  * 1.1.35 - When searching for files cap the limit at a high amount to prevent hang.
   * 1.1.34 - On windows check to make sure we are in linux container mode, if not try to switch and if that fails then use `--web` compiler.
   * 1.1.33 - Auto updating frequency has been reduced from one hour to one day. To update immediatly use `--update`.
   * 1.1.32 - `--init` now asks for which example you want, then tells you where the example was downloaded to. No longer auto-compiles.

fastled-1.1.36.dist-info/RECORD

@@ -0,0 +1,30 @@
+fastled/__init__.py,sha256=CAu_kGMgCncOxL47XeHzp8Ahj-O2Le86k5XwknbHYbA,1840
+fastled/app.py,sha256=3xg7oVD-UYnKPU8SAY-Cs5UnAYdwpdpuEFRR2N8P1Tg,1787
+fastled/build_mode.py,sha256=joMwsV4K1y_LijT4gEAcjx69RZBoe_KmFmHZdPYbL_4,631
+fastled/cli.py,sha256=CNR_pQR0sNVPNuv8e_nmm-0PI8sU-eUBUgnWgWkzW9c,237
+fastled/client_server.py,sha256=rre250O1uCx6JFi_nn6fhKUncgKOw3F7BgN9O9wbCEM,11440
+fastled/compile_server.py,sha256=QxkXLpj9q7BWhPbS2NPeFF4WRne-358o-8fg4VEDH1o,2427
+fastled/compile_server_impl.py,sha256=cB5WZ9znNhCFe2HKl-p1ZonfYKeaJOUyV3uHfkQtTZk,8481
+fastled/docker_manager.py,sha256=zBCFGk2P3_bS7_SUQ5j2lpsOS3RvIzXYkrJXC6xP69k,25383
+fastled/filewatcher.py,sha256=LwEQJkqADsArZyY499RLAer6JjJyDwaQBcAvT7xmp3c,6708
+fastled/keyboard.py,sha256=Zz_ggxOUTX2XQEy6K6kAoorVlUev4wEk9Awpvv9aStA,3241
+fastled/open_browser.py,sha256=vzMBcpDNY0f-Bx9KmEILKDANZ6gvsywCVwn1FRhPXh4,1770
+fastled/parse_args.py,sha256=37WsELphNEqGQgmjppZx6uMWE2E-dZ58zCKUl-3mr3Q,6150
+fastled/paths.py,sha256=VsPmgu0lNSCFOoEC0BsTYzDygXqy15AHUfN-tTuzDZA,99
+fastled/project_init.py,sha256=5Wy-HONa81Ws0KHyUTzjkYWAXbDm1y7X58whKJbV5tc,2084
+fastled/select_sketch_directory.py,sha256=TZdCjl1D7YMKjodMTvDRurPcpAmN3x0TcJxffER2NfM,1314
+fastled/settings.py,sha256=3eMKv0tLXgIQ0CFDboIp_l5_71rzIIyWg353YjnYJnc,323
+fastled/sketch.py,sha256=483TrrIdZJfo1MIu5FkD-V5OGmOfHmsZ2f6VvNsJBJM,3299
+fastled/spinner.py,sha256=VHxmvB92P0Z_zYxRajb5HiNmkHHvZ5dG7hKtZltzpcs,867
+fastled/string_diff.py,sha256=UR1oRhg9lsPzAG4bn_MwJMCn0evP5AigkBiwLiI9fgA,1354
+fastled/types.py,sha256=4uSSuOUhZptTreor6CXXGSk-FIMOdwHfdvFI-4Yx6AY,475
+fastled/util.py,sha256=t4M3NFMhnCzfYbLvIyJi0RdFssZqbTN_vVIaej1WV-U,265
+fastled/web_compile.py,sha256=0jXFeej-YhOxcjIau8Ru8qEu-ULlsFjaufbqKYUUXjQ,10312
+fastled/assets/example.txt,sha256=lTBovRjiz0_TgtAtbA1C5hNi2ffbqnNPqkKg6UiKCT8,54
+fastled/test/examples.py,sha256=kUM1aDK-cD9WhbFzNPMXt_-LYqHHVgV2rLiEnzLpFW0,522
+fastled-1.1.36.dist-info/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
+fastled-1.1.36.dist-info/METADATA,sha256=2OuHb_W1FUx8PRj91B2cqABJ3UqU0TkABsr_21nwaak,15254
+fastled-1.1.36.dist-info/WHEEL,sha256=0VNUDWQJzfRahYI3neAhz2UVbRCtztpN5dPHAGvmGXc,109
+fastled-1.1.36.dist-info/entry_points.txt,sha256=RCwmzCSOS4-C2i9EziANq7Z2Zb4KFnEMR1FQC0bBwAw,101
+fastled-1.1.36.dist-info/top_level.txt,sha256=Bbv5kpJpZhWNCvDF4K0VcvtBSDMa8B7PTOrZa9CezHY,8
+fastled-1.1.36.dist-info/RECORD,,

{fastled-1.1.34.dist-info → fastled-1.1.36.dist-info}/top_level.txt

@@ -1,2 +1 @@
-cache
 fastled

fastled-1.1.34.dist-info/RECORD

@@ -1,28 +0,0 @@
-fastled/__init__.py,sha256=TRIZQh3TjPKDDHL3ZVGeuIOaPljhjQmkhKhLO6W6U4k,61
-fastled/app.py,sha256=Zw1RS72yyIZSDt1_08MDSzfY4YwLWzarwXM4nvy8GE4,1787
-fastled/build_mode.py,sha256=joMwsV4K1y_LijT4gEAcjx69RZBoe_KmFmHZdPYbL_4,631
-fastled/cli.py,sha256=CNR_pQR0sNVPNuv8e_nmm-0PI8sU-eUBUgnWgWkzW9c,237
-fastled/client_server.py,sha256=IK_u71XbmOAKBX1ovHATsCmfUON8VVJJu-XtObTuYJI,11448
-fastled/compile_server.py,sha256=QnvlomTbFG2OmFj4ChuOXa0yBhhOvR8Bp1iIFsD3hbU,6717
-fastled/docker_manager.py,sha256=x_lMreCkcY4ywLqU0pedTug80eo578ssaGUPystoDIs,25381
-fastled/env.py,sha256=8wctQwl5qE4CI8NBugHtgMmUfEfHZ869JX5lGdSOJxc,304
-fastled/filewatcher.py,sha256=LwEQJkqADsArZyY499RLAer6JjJyDwaQBcAvT7xmp3c,6708
-fastled/keyboard.py,sha256=Zz_ggxOUTX2XQEy6K6kAoorVlUev4wEk9Awpvv9aStA,3241
-fastled/open_browser.py,sha256=vzMBcpDNY0f-Bx9KmEILKDANZ6gvsywCVwn1FRhPXh4,1770
-fastled/parse_args.py,sha256=OZkVjRNlparNYR0F9Ic4ud2B0pMSn4fnmVwUY1Va89o,6084
-fastled/paths.py,sha256=VsPmgu0lNSCFOoEC0BsTYzDygXqy15AHUfN-tTuzDZA,99
-fastled/project_init.py,sha256=ndQICZ9rBtfEPOnucZ3cgRE67PUKc66CJYO4Tkwmt_M,1932
-fastled/select_sketch_directory.py,sha256=TZdCjl1D7YMKjodMTvDRurPcpAmN3x0TcJxffER2NfM,1314
-fastled/sketch.py,sha256=5nRjg281lMH8Bo9wKjbcpTQCfEP574ZCG-lukvFmyQ8,2656
-fastled/spinner.py,sha256=VHxmvB92P0Z_zYxRajb5HiNmkHHvZ5dG7hKtZltzpcs,867
-fastled/string_diff.py,sha256=UR1oRhg9lsPzAG4bn_MwJMCn0evP5AigkBiwLiI9fgA,1354
-fastled/types.py,sha256=dDIsGHJkHNJ7B61wNp6X0JSLs_nrHiq7RlNqNWbwFec,194
-fastled/util.py,sha256=t4M3NFMhnCzfYbLvIyJi0RdFssZqbTN_vVIaej1WV-U,265
-fastled/web_compile.py,sha256=KuvKGdX6SSUUqC7YgX4T9SMSP5wdcPUhpg9-K9zPoTI,10378
-fastled/assets/example.txt,sha256=lTBovRjiz0_TgtAtbA1C5hNi2ffbqnNPqkKg6UiKCT8,54
-fastled-1.1.34.dist-info/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
-fastled-1.1.34.dist-info/METADATA,sha256=G3dvar486uKa16kYTZvDdD75n6MtqybcAh3g_H_d4E0,15063
-fastled-1.1.34.dist-info/WHEEL,sha256=0VNUDWQJzfRahYI3neAhz2UVbRCtztpN5dPHAGvmGXc,109
-fastled-1.1.34.dist-info/entry_points.txt,sha256=RCwmzCSOS4-C2i9EziANq7Z2Zb4KFnEMR1FQC0bBwAw,101
-fastled-1.1.34.dist-info/top_level.txt,sha256=xfG6Z_ol9V5YmBROkZq2QTRwjbS2ouCUxaTJsOwfkOo,14
-fastled-1.1.34.dist-info/RECORD,,