fastled 1.1.30__py2.py3-none-any.whl → 1.1.32__py2.py3-none-any.whl

fastled/open_browser.py

@@ -13,11 +13,12 @@ def _open_browser_python(fastled_js: Path, port: int) -> Server:
     """Start livereload server in the fastled_js directory using API"""
     print(f"\nStarting livereload server in {fastled_js} on port {port}")
 
-    server = Server()
-    server.watch(str(fastled_js / "index.html"), delay=0.1)
-    server.setHeader("Cache-Control", "no-cache")
-    server.serve(root=str(fastled_js), port=port, open_url_delay=0.5)
-    return server
+    # server = Server()
+    # server.watch(str(fastled_js / "index.html"), delay=0.1)
+    # server.setHeader("Cache-Control", "no-cache")
+    # server.serve(root=str(fastled_js), port=port, open_url_delay=0.5)
+    # return server
+    os.system(f"cd {fastled_js} && live-server")
 
 
 def _find_open_port(start_port: int) -> int:

fastled/parse_args.py

@@ -0,0 +1,164 @@
+import argparse
+import os
+import sys
+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.sketch import (
+    find_sketch_directories,
+    looks_like_fastled_repo,
+    looks_like_sketch_directory,
+)
+
+
+def parse_args() -> argparse.Namespace:
+    """Parse command-line arguments."""
+    parser = argparse.ArgumentParser(description=f"FastLED WASM Compiler {__version__}")
+    parser.add_argument(
+        "--version", action="version", version=f"%(prog)s {__version__}"
+    )
+    parser.add_argument(
+        "directory",
+        type=str,
+        nargs="?",
+        default=None,
+        help="Directory containing the FastLED sketch to compile",
+    )
+    parser.add_argument(
+        "--init",
+        action="store_true",
+        help="Initialize the FastLED sketch in the current directory",
+    )
+    parser.add_argument(
+        "--just-compile",
+        action="store_true",
+        help="Just compile, skip opening the browser and watching for changes.",
+    )
+    parser.add_argument(
+        "--web",
+        "-w",
+        type=str,
+        nargs="?",
+        # const does not seem to be working as expected
+        const=DEFAULT_URL,  # Default value when --web is specified without value
+        help="Use web compiler. Optional URL can be provided (default: https://fastled.onrender.com)",
+    )
+    parser.add_argument(
+        "-i",
+        "--interactive",
+        action="store_true",
+        help="Run in interactive mode (Not available with --web)",
+    )
+    parser.add_argument(
+        "--profile",
+        action="store_true",
+        help="Enable profiling for web compilation",
+    )
+    parser.add_argument(
+        "--force-compile",
+        action="store_true",
+        help="Skips the test to see if the current directory is a valid FastLED sketch directory",
+    )
+    parser.add_argument(
+        "--no-auto-updates",
+        action="store_true",
+        help="Disable automatic updates of the wasm compiler image when using docker.",
+    )
+    parser.add_argument(
+        "--update",
+        "--upgrade",
+        action="store_true",
+        help="Update the wasm compiler (if necessary) before running",
+    )
+    parser.add_argument(
+        "--localhost",
+        "--local",
+        "-l",
+        action="store_true",
+        help="Use localhost for web compilation from an instance of fastled --server, creating it if necessary",
+    )
+    parser.add_argument(
+        "--server",
+        "-s",
+        action="store_true",
+        help="Run the server in the current directory, volume mapping fastled if we are in the repo",
+    )
+
+    build_mode = parser.add_mutually_exclusive_group()
+    build_mode.add_argument("--debug", action="store_true", help="Build in debug mode")
+    build_mode.add_argument(
+        "--quick",
+        action="store_true",
+        default=True,
+        help="Build in quick mode (default)",
+    )
+    build_mode.add_argument(
+        "--release", action="store_true", help="Build in release mode"
+    )
+
+    cwd_is_fastled = looks_like_fastled_repo(Path(os.getcwd()))
+
+    args = parser.parse_args()
+
+    if args.init:
+        args.directory = project_init()
+        print("\nInitialized FastLED project in", args.directory)
+        print(f"Use 'fastled {args.directory}' to compile the project.")
+        sys.exit(0)
+
+    if not args.update:
+        if args.no_auto_updates:
+            args.auto_update = False
+        else:
+            args.auto_update = None
+
+        if (
+            not cwd_is_fastled
+            and not args.localhost
+            and not args.web
+            and not args.server
+        ):
+            # print(f"Using web compiler at {DEFAULT_URL}")
+            args.web = DEFAULT_URL
+            if DockerManager.is_docker_installed():
+                print("Docker is installed. Use --server to run the compiler locally.")
+                args.localhost = True
+            else:
+                print("Docker is not installed. Using web compiler.")
+        if cwd_is_fastled and not args.web and not args.server:
+            print("Forcing --local mode because we are in the FastLED repo")
+            args.localhost = True
+        if args.localhost:
+            args.web = "localhost"
+        if args.interactive and not args.server:
+            print("--interactive forces --server mode")
+            args.server = True
+        if args.directory is None and not args.server:
+            # does current directory look like a sketch?
+            maybe_sketch_dir = Path(os.getcwd())
+            if looks_like_sketch_directory(maybe_sketch_dir):
+                args.directory = str(maybe_sketch_dir)
+            else:
+                sketch_directories = find_sketch_directories(maybe_sketch_dir)
+                selected_dir = select_sketch_directory(
+                    sketch_directories, cwd_is_fastled
+                )
+                if selected_dir:
+                    print(f"Using sketch directory: {selected_dir}")
+                    args.directory = selected_dir
+                else:
+                    print(
+                        "\nYou either need to specify a sketch directory or run in --server mode."
+                    )
+                    sys.exit(1)
+        elif args.directory is not None and os.path.isfile(args.directory):
+            dir_path = Path(args.directory).parent
+            if looks_like_sketch_directory(dir_path):
+                print(f"Using sketch directory: {dir_path}")
+                args.directory = str(dir_path)
+
+    return args

fastled/project_init.py

@@ -5,28 +5,59 @@ import httpx
 
 from fastled.env import DEFAULT_URL
 
-ENDPOINT = f"{DEFAULT_URL}/project/init"
+ENDPOINT_PROJECT_INIT = f"{DEFAULT_URL}/project/init"
+ENDPOINT_INFO = f"{DEFAULT_URL}/info"
+DEFAULT_EXAMPLE = "wasm"
 
 
-def project_init() -> Path:
+def get_examples() -> list[str]:
+    response = httpx.get(ENDPOINT_INFO, timeout=4)
+    response.raise_for_status()
+    return response.json()["examples"]
+
+
+def _prompt_for_example() -> str:
+    examples = get_examples()
+    while True:
+        print("Available examples:")
+        for i, example in enumerate(examples):
+            print(f"  [{i+1}]: {example}")
+        answer = input("Enter the example number or name: ").strip()
+        if answer.isdigit():
+            example_num = int(answer) - 1
+            if example_num < 0 or example_num >= len(examples):
+                print("Invalid example number")
+                continue
+            return examples[example_num]
+        elif answer in examples:
+            return answer
+
+
+def project_init(example: str | None = None, outputdir: Path | None = None) -> Path:
     """
     Initialize a new FastLED project.
     """
-    response = httpx.get(ENDPOINT, timeout=20)
+
+    outputdir = outputdir or Path("fastled")
+    if example is None:
+        try:
+            example = _prompt_for_example()
+        except httpx.HTTPStatusError:
+            print(
+                f"Failed to fetch examples, using default example '{DEFAULT_EXAMPLE}'"
+            )
+            example = DEFAULT_EXAMPLE
+    assert example is not None
+    response = httpx.get(f"{ENDPOINT_PROJECT_INIT}/{example}", timeout=20)
     response.raise_for_status()
     content = response.content
-    output = Path("fastled.zip")
-    output.write_bytes(content)
-    # unzip the content
-    outdir = Path("fastled")
-    if outdir.exists():
-        print("Project already initialized.")
-        return Path("fastled").iterdir().__next__()
-    with zipfile.ZipFile(output, "r") as zip_ref:
-        zip_ref.extractall(outdir)
-    print(f"Project initialized successfully at {outdir}")
-    output.unlink()
-    return Path("fastled").iterdir().__next__()
+    tmpzip = outputdir / "fastled.zip"
+    outputdir.mkdir(exist_ok=True)
+    tmpzip.write_bytes(content)
+    with zipfile.ZipFile(tmpzip, "r") as zip_ref:
+        zip_ref.extractall(outputdir)
+    tmpzip.unlink()
+    return outputdir.iterdir().__next__()
 
 
 def unit_test() -> None:

{fastled-1.1.30.dist-info → fastled-1.1.32.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastled
-Version: 1.1.30
+Version: 1.1.32
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies
@@ -161,10 +161,10 @@ A: `delay()` will block `loop()` which blocks the main thread of the browser. Th
 Q: How can I get the compiled size of my FastLED sketch smaller?
 A: A big chunk of space is being used by unnecessary javascript `emscripten` is  bundling. This can be tweeked by the wasm_compiler_settings.py file in the FastLED repo.
 
-
-
 # Revisions
   
+  * 1.1.32 - `--init` now asks for which example you want, then tells you where the example was downloaded to. No longer auto-compiles.
+  * 1.1.31 - `--local` is auto-enabled if docker is installed, use `--web` to force web compiler. Updating is much more pretty.
   * 1.1.30 - Added `--init` to initialize a demo project.
   * 1.1.29 - Remove annoying dbg messages i left in.
   * 1.1.28 - Adds cache control headers to the live server to disable all caching in the live browser.

{fastled-1.1.30.dist-info → fastled-1.1.32.dist-info}/RECORD

@@ -1,16 +1,17 @@
-fastled/__init__.py,sha256=yLjBvriNeONWn5KKcX1r03E91NonWMYyWdtvyeeo7I8,61
-fastled/app.py,sha256=eKaY6sD8JQ0pz0CZ6rtmhx27xkv5-WteuMYd9HxSeYU,7245
+fastled/__init__.py,sha256=h57bgf-pWUgIqNDTiwecNLHLOonvdSie9JE_H5qq-eo,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=Adb2lvJ_p6Ui7UMxijRtYJhbO4YPTERKVQeuoQgibSE,6724
-fastled/docker_manager.py,sha256=Ok8TC1JXMoNMWt4P9clFFEVE29Xd-4C_MvIMIfvNo78,22134
+fastled/docker_manager.py,sha256=WVWg8ABWjdrX1P4vRRbW2z6yMOhhrHVtQ9H_cBBBAlI,23275
 fastled/env.py,sha256=8wctQwl5qE4CI8NBugHtgMmUfEfHZ869JX5lGdSOJxc,304
 fastled/filewatcher.py,sha256=5dVmjEG23kMeJa29tRVm5XKSr9sTD4ME2boo-CFDuUM,6910
 fastled/keyboard.py,sha256=Zz_ggxOUTX2XQEy6K6kAoorVlUev4wEk9Awpvv9aStA,3241
-fastled/open_browser.py,sha256=-2_vyf6dbi2xGex-CMZHVVcXvwXGJkLOwFcjHGxknUQ,1769
+fastled/open_browser.py,sha256=ERDHvsJKl7yKHX7UJKm35eCeQ1fRXseWdZavV962O0A,1829
+fastled/parse_args.py,sha256=PoFA9BVXexPf6g4tVIDigzCCOTHqV9aSbs71WqDhJZI,5696
 fastled/paths.py,sha256=VsPmgu0lNSCFOoEC0BsTYzDygXqy15AHUfN-tTuzDZA,99
-fastled/project_init.py,sha256=9GmyaRsXa1fNuzqpv0lcpkSFTOFszpEZ3jr788zZNp0,870
+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=ZGFXona3SJxmuHIzMGa6tqB0IVDSRr8W_dju09Z1Hwg,901
@@ -19,9 +20,9 @@ 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.30.dist-info/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
-fastled-1.1.30.dist-info/METADATA,sha256=JdbFFpslqjqfeg9SLWlsL1TABA2pCk2pPJFHNIwtqYE,14541
-fastled-1.1.30.dist-info/WHEEL,sha256=0VNUDWQJzfRahYI3neAhz2UVbRCtztpN5dPHAGvmGXc,109
-fastled-1.1.30.dist-info/entry_points.txt,sha256=RCwmzCSOS4-C2i9EziANq7Z2Zb4KFnEMR1FQC0bBwAw,101
-fastled-1.1.30.dist-info/top_level.txt,sha256=xfG6Z_ol9V5YmBROkZq2QTRwjbS2ouCUxaTJsOwfkOo,14
-fastled-1.1.30.dist-info/RECORD,,
+fastled-1.1.32.dist-info/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
+fastled-1.1.32.dist-info/METADATA,sha256=Ywsknp8GbAi4ExBaULxknlC7XEY7AfWTGFYxA6AUCIk,14803
+fastled-1.1.32.dist-info/WHEEL,sha256=0VNUDWQJzfRahYI3neAhz2UVbRCtztpN5dPHAGvmGXc,109
+fastled-1.1.32.dist-info/entry_points.txt,sha256=RCwmzCSOS4-C2i9EziANq7Z2Zb4KFnEMR1FQC0bBwAw,101
+fastled-1.1.32.dist-info/top_level.txt,sha256=xfG6Z_ol9V5YmBROkZq2QTRwjbS2ouCUxaTJsOwfkOo,14
+fastled-1.1.32.dist-info/RECORD,,