fastled 1.1.88__py3-none-any.whl → 1.2.2__py3-none-any.whl

fastled/__init__.py

@@ -13,15 +13,18 @@ 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.1.88"
+__version__ = "1.2.2"
 
 
 class Api:
     @staticmethod
-    def get_examples():
+    def get_examples(host: str | CompileServer | None = None) -> list[str]:
         from fastled.project_init import get_examples
 
-        return get_examples()
+        if isinstance(host, CompileServer):
+            host = host.url()
+
+        return get_examples(host=host)
 
     @staticmethod
     def project_init(
@@ -109,7 +112,47 @@ class Api:
             server.stop()
 
 
+class Docker:
+    @staticmethod
+    def is_installed() -> bool:
+        from fastled.docker_manager import DockerManager
+
+        return DockerManager.is_docker_installed()
+
+    @staticmethod
+    def is_running() -> bool:
+        from fastled.docker_manager import DockerManager
+
+        return DockerManager.is_running()
+
+    @staticmethod
+    def is_container_running(container_name: str | None = None) -> bool:
+        # from fastled.docker import is_container_running
+        from fastled.docker_manager import DockerManager
+        from fastled.settings import CONTAINER_NAME
+
+        docker = DockerManager()
+        container_name = container_name or CONTAINER_NAME
+        return docker.is_container_running(container_name)
+
+    @staticmethod
+    def purge() -> None:
+        from fastled.docker_manager import DockerManager
+        from fastled.settings import CONTAINER_NAME
+
+        docker = DockerManager()
+        docker.purge(CONTAINER_NAME)
+
+
 class Test:
+    __test__ = False  # This prevents unittest from recognizing it as a test class.
+
+    @staticmethod
+    def can_run_local_docker_tests() -> bool:
+        from fastled.test.can_run_local_docker_tests import can_run_local_docker_tests
+
+        return can_run_local_docker_tests()
+
     @staticmethod
     def test_examples(
         examples: list[str] | None = None, host: str | CompileServer | None = None

fastled/app.py

@@ -16,6 +16,9 @@ def run_server(args: argparse.Namespace) -> int:
     interactive = args.interactive
     auto_update = args.auto_update
     mapped_dir = Path(args.directory).absolute() if args.directory else None
+    if interactive and mapped_dir is None:
+        print("Select a sketch when you enter interactive mode.")
+        return 1
     compile_server = CompileServer(
         interactive=interactive,
         auto_updates=auto_update,

fastled/compile_server_impl.py

@@ -12,14 +12,10 @@ from fastled.docker_manager import (
     DockerManager,
     RunningContainer,
 )
-from fastled.settings import SERVER_PORT
+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
 
-_IMAGE_NAME = "niteris/fastled-wasm"
-_DEFAULT_CONTAINER_NAME = "fastled-wasm-compiler"
-
-
 SERVER_OPTIONS = [
     "--allow-shutdown",  # Allow the server to be shut down without a force kill.
     "--no-auto-update",  # Don't auto live updates from the git repo.
@@ -46,7 +42,7 @@ class CompileServerImpl:
         auto_start: bool = True,
         container_name: str | None = None,
     ) -> None:
-        container_name = container_name or _DEFAULT_CONTAINER_NAME
+        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"
@@ -178,7 +174,7 @@ class CompileServerImpl:
         else:
             upgrade = self.auto_updates
         self.docker.validate_or_download_image(
-            image_name=_IMAGE_NAME, tag="main", upgrade=upgrade
+            image_name=IMAGE_NAME, tag="main", upgrade=upgrade
         )
         DISK_CACHE.put("last-update", now_str)
 
@@ -214,7 +210,7 @@ class CompileServerImpl:
         cmd_str = subprocess.list2cmdline(server_command)
         if not self.interactive:
             container: Container = self.docker.run_container_detached(
-                image_name=_IMAGE_NAME,
+                image_name=IMAGE_NAME,
                 tag="main",
                 container_name=self.container_name,
                 command=cmd_str,
@@ -228,7 +224,7 @@ class CompileServerImpl:
             return port
         else:
             self.docker.run_container_interactive(
-                image_name=_IMAGE_NAME,
+                image_name=IMAGE_NAME,
                 tag="main",
                 container_name=self.container_name,
                 command=cmd_str,

fastled/docker_manager.py

@@ -610,6 +610,35 @@ class DockerManager:
             print(f"Container {container_name} not found.")
             return False
 
+    def purge(self, image_name: str) -> None:
+        """
+        Remove all containers and images associated with the given image name.
+
+        Args:
+            image_name: The name of the image to purge (without tag)
+        """
+        print(f"Purging all containers and images for {image_name}...")
+
+        # Remove all containers using this image
+        try:
+            containers = self.client.containers.list(all=True)
+            for container in containers:
+                if any(image_name in tag for tag in container.image.tags):
+                    print(f"Removing container {container.name}")
+                    container.remove(force=True)
+        except Exception as e:
+            print(f"Error removing containers: {e}")
+
+        # Remove all images with this name
+        try:
+            images = self.client.images.list()
+            for image in images:
+                if any(image_name in tag for tag in image.tags):
+                    print(f"Removing image {image.tags}")
+                    self.client.images.remove(image.id, force=True)
+        except Exception as e:
+            print(f"Error removing images: {e}")
+
 
 def main():
     # Register SIGINT handler

fastled/parse_args.py

@@ -4,10 +4,9 @@ import sys
 from pathlib import Path
 
 from fastled import __version__
-from fastled.docker_manager import DockerManager
 from fastled.project_init import project_init
 from fastled.select_sketch_directory import select_sketch_directory
-from fastled.settings import DEFAULT_URL
+from fastled.settings import DEFAULT_URL, IMAGE_NAME
 from fastled.sketch import (
     find_sketch_directories,
     looks_like_fastled_repo,
@@ -86,6 +85,11 @@ def parse_args() -> argparse.Namespace:
         action="store_true",
         help="Run the server in the current directory, volume mapping fastled if we are in the repo",
     )
+    parser.add_argument(
+        "--purge",
+        action="store_true",
+        help="Remove all FastLED containers and images",
+    )
 
     build_mode = parser.add_mutually_exclusive_group()
     build_mode.add_argument("--debug", action="store_true", help="Build in debug mode")
@@ -103,6 +107,13 @@ def parse_args() -> argparse.Namespace:
 
     args = parser.parse_args()
 
+    if args.purge:
+        from fastled.docker_manager import DockerManager
+
+        docker = DockerManager()
+        docker.purge(IMAGE_NAME)
+        sys.exit(0)
+
     if args.init:
         example = args.init if args.init is not True else None
         args.directory = project_init(example, args.directory)
@@ -122,6 +133,8 @@ def parse_args() -> argparse.Namespace:
             and not args.web
             and not args.server
         ):
+            from fastled.docker_manager import DockerManager
+
             if DockerManager.is_docker_installed():
                 if not DockerManager.ensure_linux_containers_for_windows():
                     print(

fastled/project_init.py

@@ -5,22 +5,15 @@ import httpx
 
 from fastled.settings import DEFAULT_URL
 
-ENDPOINT_PROJECT_INIT = f"{DEFAULT_URL}/project/init"
-ENDPOINT_INFO = f"{DEFAULT_URL}/info"
 DEFAULT_EXAMPLE = "wasm"
 
-_EXCLUDED_EXAMPLES = [
-    "Pintest",
-    "OctoWS2811",
-]
 
-
-def get_examples() -> list[str]:
-    response = httpx.get(ENDPOINT_INFO, timeout=4)
+def get_examples(host: str | None = None) -> list[str]:
+    host = host or DEFAULT_URL
+    url_info = f"{host}/info"
+    response = httpx.get(url_info, timeout=4)
     response.raise_for_status()
     examples: list[str] = response.json()["examples"]
-    # filter out excluded examples
-    examples = [example for example in examples if example not in _EXCLUDED_EXAMPLES]
     return sorted(examples)
 
 
@@ -61,8 +54,9 @@ def project_init(
             )
             example = DEFAULT_EXAMPLE
     assert example is not None
-    endpoint_url = f"{host}/project/init/{example}"
-    response = httpx.get(endpoint_url, timeout=20)
+    endpoint_url = f"{host}/project/init"
+    json = example
+    response = httpx.post(endpoint_url, timeout=20, json=json)
     response.raise_for_status()
     content = response.content
     tmpzip = outputdir / "fastled.zip"
@@ -72,6 +66,7 @@ def project_init(
         zip_ref.extractall(outputdir)
     tmpzip.unlink()
     out = outputdir / example
+    print(f"Project initialized at {out}")
     assert out.exists()
     return out
 

fastled/settings.py

@@ -7,3 +7,7 @@ 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
+
+IMAGE_NAME = "niteris/fastled-wasm"
+DEFAULT_CONTAINER_NAME = "fastled-wasm-compiler"
+# IMAGE_TAG = "main"

fastled/test/can_run_local_docker_tests.py

@@ -0,0 +1,13 @@
+import os
+import platform
+
+
+def can_run_local_docker_tests() -> bool:
+    """Check if this system can run Docker Tests"""
+    is_github_runner = "GITHUB_ACTIONS" in os.environ
+    if not is_github_runner:
+        from fastled.docker_manager import DockerManager
+
+        return DockerManager.is_docker_installed()
+    # this only works in ubuntu at the moment
+    return platform.system() == "Linux"

fastled/test/examples.py

@@ -1,4 +1,8 @@
 from tempfile import TemporaryDirectory
+from time import time
+from warnings import warn
+
+_FILTER = True
 
 
 def test_examples(
@@ -8,13 +12,24 @@ def test_examples(
     from fastled import Api
 
     out: dict[str, Exception] = {}
-    examples = Api.get_examples() if examples is None else examples
+    examples = Api.get_examples(host=host) if examples is None else examples
+    if host is None and _FILTER:
+        examples.remove("Chromancer")  # Brutal
+        examples.remove("LuminescentGrand")
     with TemporaryDirectory() as tmpdir:
         for example in examples:
             print(f"Initializing example: {example}")
-            sketch_dir = Api.project_init(example, outputdir=tmpdir, host=host)
+            try:
+                sketch_dir = Api.project_init(example, outputdir=tmpdir, host=host)
+            except Exception as e:
+                warn(f"Failed to initialize example: {example}, error: {e}")
+                out[example] = e
+                continue
             print(f"Project initialized at: {sketch_dir}")
+            start = time()
             print(f"Compiling example: {example}")
+            diff = time() - start
+            print(f"Compilation took: {diff:.2f} seconds")
             result = Api.web_compile(sketch_dir, host=host)
             if not result.success:
                 out[example] = Exception(result.stdout)
@@ -22,9 +37,12 @@ def test_examples(
 
 
 def unit_test() -> None:
-    out = test_examples()
-    if out:
-        raise RuntimeError(f"Failed tests: {out}")
+    from fastled import Api
+
+    with Api.server(auto_updates=True) as server:
+        out = test_examples(host=server.url())
+        if out:
+            raise RuntimeError(f"Failed tests: {out}")
 
 
 if __name__ == "__main__":

{fastled-1.1.88.dist-info → fastled-1.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastled
-Version: 1.1.88
+Version: 1.2.2
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies
@@ -23,9 +23,6 @@ Requires-Dist: progress>=1.6
 
 # FastLED Wasm compiler
 
-Compiles an Arduino/Platformio sketch into a wasm binary that can be run directly in the web browser.
-
-
 [![Linting](https://github.com/zackees/fastled-wasm/actions/workflows/lint.yml/badge.svg)](https://github.com/zackees/fastled-wasm/actions/workflows/lint.yml)
 [![MacOS_Tests](https://github.com/zackees/fastled-wasm/actions/workflows/test_macos.yml/badge.svg)](https://github.com/zackees/fastled-wasm/actions/workflows/test_macos.yml)
 [![Ubuntu_Tests](https://github.com/zackees/fastled-wasm/actions/workflows/test_ubuntu.yml/badge.svg)](https://github.com/zackees/fastled-wasm/actions/workflows/test_ubuntu.yml)
@@ -35,9 +32,11 @@ Compiles an Arduino/Platformio sketch into a wasm binary that can be run directl
 [![Build Executables](https://github.com/zackees/fastled-wasm/actions/workflows/test_build_exe.yml/badge.svg)](https://github.com/zackees/fastled-wasm/actions/workflows/test_build_exe.yml)
 [![Publish Release](https://github.com/zackees/fastled-wasm/actions/workflows/publish_release.yml/badge.svg)](https://github.com/zackees/fastled-wasm/actions/workflows/publish_release.yml)
 
-# Demo
 
-https://zackees.github.io/fastled-wasm/
+
+## Compile your FastLED sketch and run it on the Browser!
+
+![image](https://github.com/user-attachments/assets/243aeb4d-e42f-4cc3-9c31-0af51271f3e0)
 
 
 # About
@@ -46,11 +45,17 @@ This python app will compile your FastLED style sketches into html/js/wasm outpu
 
 Compile times are extremely fast, thanks to aggressive object caching for C++ and sketch fingerprinting with a zip file cache. Recompilation of sketch files with minimal changes will occure in less than a second.
 
-By default the web compiler will always be used unless that user specifies `--local`, in which case this compiler will invoke docker to bring in a runtime necessary to run the compiler toolchain.
+If you have docker installed, the compiler will download the docker image and run a private local server on your machine. If you don't have Docker installed then the app will fall back to using the public web compiler.
+
+In every conceivable way, the local compiler will be much faster than the web version.
+
+# Demo
+
+https://zackees.github.io/fastled-wasm/
 
-The local compiler will be much faster than the web version in most circumstances after the first compile. The web compiler
-has the advantage that as a persistant service the compile cache will remain much more up to date.
+# Tutorial video
 
+**Note this video is a little outdated, you will install the app now with `pip install fastled` and run it like `fastled mysketchfolder`**
 
 https://github.com/user-attachments/assets/64ae0e6c-5f8b-4830-ab87-dcc25bc61218
 
@@ -260,6 +265,8 @@ A: A big chunk of space is being used by unnecessary javascript `emscripten` bun
 
 # Revisions
 
+  * 1.2.22 - Added `--purge` and added docker api at __init__.
+  * 1.2.00 - `fastled.exe` is now a signed binary on windows, however it's a self signed binary so you'll still get the warning on the first open. There's been a small api change between the server and the client for fetching projects.
   * 1.1.69 - Changed the binary name to `fastled.exe` instead of something like `fastled-windows-x64.exe`
   * 1.1.68 - Add a site builder to fastled.Test which generates a website with a bunch of demos. This is used to build the demo site automatically.
   * 1.1.67 - Pinned all the minimum versions of dependencies so we don't bind to an out of date py dep: https://github.com/zackees/fastled-wasm/issues/3

{fastled-1.1.88.dist-info → fastled-1.2.2.dist-info}/RECORD

@@ -1,19 +1,19 @@
-fastled/__init__.py,sha256=D282INW9LxPw4mZCC17pye4xt-z0O6fJZip52U-jJxk,3925
-fastled/app.py,sha256=AHLQczFKLV1ZyGCh45wTvJqQpQyJ_Ukh3MmG3Om4NHQ,1844
+fastled/__init__.py,sha256=XuiOBb_pqwouDkDxbp5hrYCJLRQo1kHiwVplzj3LYN8,5300
+fastled/app.py,sha256=Y1Q5mx4zdQbZ2AaB43ZqJo-w_8ehAaWVNtvTyeCRSaE,1970
 fastled/cli.py,sha256=FjVr31ht0UPlAcmX-84NwfAGMQHTkrCe4o744jCAxiw,375
 fastled/client_server.py,sha256=8L62zNtkGtErDtWrr4XVNsv7ji2zoS5rlqfCnwI3VKU,13177
 fastled/compile_server.py,sha256=Z7rHFs3M6QPbSCsbgHAQDk6GTVAJMMPCXtD4Y0mu8RM,2659
-fastled/compile_server_impl.py,sha256=ClBLtFHB0ucaT8tAJfI6o3bJ-LRnXc4Pxy7bVKnFiww,8803
-fastled/docker_manager.py,sha256=zBCFGk2P3_bS7_SUQ5j2lpsOS3RvIzXYkrJXC6xP69k,25383
+fastled/compile_server_impl.py,sha256=B_7zjdKHxX2JbNcx26hntwtk8-MyQTs6LMZlpOEuloM,8746
+fastled/docker_manager.py,sha256=J6epThU164XAKe8pDsquLs8ytFFn6QAch2PEVeRNY80,26538
 fastled/filewatcher.py,sha256=LwEQJkqADsArZyY499RLAer6JjJyDwaQBcAvT7xmp3c,6708
 fastled/keyboard.py,sha256=Zz_ggxOUTX2XQEy6K6kAoorVlUev4wEk9Awpvv9aStA,3241
 fastled/live_client.py,sha256=_KvqmyUyyGpoYET1Z9CdeUVoIbFjIUWwPcTp5XCQuxY,2075
 fastled/open_browser.py,sha256=vzMBcpDNY0f-Bx9KmEILKDANZ6gvsywCVwn1FRhPXh4,1770
-fastled/parse_args.py,sha256=qsikaRmRDPOosPF1AmfjaATSwH2xxJbKDKswOyVn2oM,6254
+fastled/parse_args.py,sha256=IN63KKFX8uO5h5JSrFtHOFoov6Sw9v41NwB-VitU0No,6579
 fastled/paths.py,sha256=VsPmgu0lNSCFOoEC0BsTYzDygXqy15AHUfN-tTuzDZA,99
-fastled/project_init.py,sha256=2WBdCN01hBfoYJn-x3TD5KsJEo5BTrHzr2QyszGzZAU,2416
+fastled/project_init.py,sha256=QEghpy5Vonc_fTF--3L5ySrQ1bDpdJpfnlEHHQLDKRk,2287
 fastled/select_sketch_directory.py,sha256=TZdCjl1D7YMKjodMTvDRurPcpAmN3x0TcJxffER2NfM,1314
-fastled/settings.py,sha256=3eMKv0tLXgIQ0CFDboIp_l5_71rzIIyWg353YjnYJnc,323
+fastled/settings.py,sha256=WwNYzZEGb_fk_25lx03_yIBNGRXWloyRm7FnQhHiJf8,430
 fastled/sketch.py,sha256=483TrrIdZJfo1MIu5FkD-V5OGmOfHmsZ2f6VvNsJBJM,3299
 fastled/spinner.py,sha256=VHxmvB92P0Z_zYxRajb5HiNmkHHvZ5dG7hKtZltzpcs,867
 fastled/string_diff.py,sha256=UR1oRhg9lsPzAG4bn_MwJMCn0evP5AigkBiwLiI9fgA,1354
@@ -22,10 +22,11 @@ fastled/util.py,sha256=t4M3NFMhnCzfYbLvIyJi0RdFssZqbTN_vVIaej1WV-U,265
 fastled/web_compile.py,sha256=05PeLJ77QQC6PUKjDhsntBmyBola6QQIfF2k-zjYNE4,10261
 fastled/assets/example.txt,sha256=lTBovRjiz0_TgtAtbA1C5hNi2ffbqnNPqkKg6UiKCT8,54
 fastled/site/build.py,sha256=UDWaked5QFPibbKZSoDrQgiP1Laoh8f0Fbj8Qfey0I4,12503
-fastled/test/examples.py,sha256=EDXb6KastKOOWzew99zrpmcNcXTcAtYi8eud6F1pnWA,980
-fastled-1.1.88.dist-info/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
-fastled-1.1.88.dist-info/METADATA,sha256=ElHNWdBrZiXj0gmUsNmRN7GMMZ8hECrTDnTXZB0q8r8,18951
-fastled-1.1.88.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-fastled-1.1.88.dist-info/entry_points.txt,sha256=RCwmzCSOS4-C2i9EziANq7Z2Zb4KFnEMR1FQC0bBwAw,101
-fastled-1.1.88.dist-info/top_level.txt,sha256=Bbv5kpJpZhWNCvDF4K0VcvtBSDMa8B7PTOrZa9CezHY,8
-fastled-1.1.88.dist-info/RECORD,,
+fastled/test/can_run_local_docker_tests.py,sha256=LEuUbHctRhNNFWcvnz2kEGmjDJeXO4c3kNpizm3yVJs,400
+fastled/test/examples.py,sha256=6xPwx_k9_XwYTpI1nk4SrYbsJKHJACd30GzD1epGqhY,1597
+fastled-1.2.2.dist-info/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
+fastled-1.2.2.dist-info/METADATA,sha256=sSe6CClj0Y2L_59L4-hsfDeoyYav2rm6pjlF-za1lOw,19341
+fastled-1.2.2.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+fastled-1.2.2.dist-info/entry_points.txt,sha256=RCwmzCSOS4-C2i9EziANq7Z2Zb4KFnEMR1FQC0bBwAw,101
+fastled-1.2.2.dist-info/top_level.txt,sha256=Bbv5kpJpZhWNCvDF4K0VcvtBSDMa8B7PTOrZa9CezHY,8
+fastled-1.2.2.dist-info/RECORD,,