fastled 1.3.30__py3-none-any.whl → 1.4.50__py3-none-any.whl

fastled/__init__.py

@@ -7,6 +7,7 @@ from typing import Generator
 
 from .__version__ import __version__
 from .compile_server import CompileServer
+from .emoji_util import EMO
 from .live_client import LiveClient
 from .settings import DOCKER_FILE, IMAGE_NAME
 from .site.build import build
@@ -39,15 +40,31 @@ class Api:
         host: str | CompileServer | None = None,
         build_mode: BuildMode = BuildMode.QUICK,
         profile: bool = False,  # When true then profile information will be enabled and included in the zip.
+        no_platformio: bool = False,
     ) -> CompileResult:
+        from fastled.sketch import looks_like_fastled_repo
         from fastled.web_compile import web_compile
 
         if isinstance(host, CompileServer):
             host = host.url()
         if isinstance(directory, str):
             directory = Path(directory)
+
+        # Guard: libfastled compilation requires volume source mapping
+        # Only allow libcompile if we're in a FastLED repository
+        allow_libcompile = looks_like_fastled_repo(Path(".").resolve())
+        if not allow_libcompile:
+            print(
+                f"{EMO('⚠️', 'WARNING:')}  libfastled compilation disabled: not running in FastLED repository"
+            )
+
         out: CompileResult = web_compile(
-            directory, host, build_mode=build_mode, profile=profile
+            directory,
+            host,
+            build_mode=build_mode,
+            profile=profile,
+            no_platformio=no_platformio,
+            allow_libcompile=allow_libcompile,
         )
         return out
 
@@ -64,6 +81,8 @@ class Api:
         http_port: (
             int | None
         ) = None,  # None means auto select a free port. -1 means no server.
+        no_platformio: bool = False,
+        enable_https: bool = True,  # Enable HTTPS for the local server
     ) -> LiveClient:
         return LiveClient(
             sketch_directory=sketch_directory,
@@ -75,6 +94,8 @@ class Api:
             build_mode=build_mode,
             profile=profile,
             http_port=http_port,
+            no_platformio=no_platformio,
+            enable_https=enable_https,
         )
 
     @staticmethod
@@ -85,9 +106,9 @@ class Api:
         mapped_dir: Path | None = None,  # Sketch directory.
         container_name: str | None = None,  # Specific docker container name.
         remove_previous: bool = False,
+        no_platformio: bool = False,
     ) -> CompileServer:
         """Uses docker to spawn a compile server from the given name."""
-        from fastled.compile_server import CompileServer
 
         out = CompileServer(
             container_name=container_name,
@@ -96,6 +117,7 @@ class Api:
             mapped_dir=mapped_dir,
             auto_start=auto_start,
             remove_previous=remove_previous,
+            no_platformio=no_platformio,
         )
         return out
 
@@ -108,6 +130,7 @@ class Api:
         mapped_dir: Path | None = None,  # Sketch directory.
         container_name: str | None = None,  # Specific docker container name.
         remove_previous=False,
+        no_platformio: bool = False,
     ) -> Generator[CompileServer, None, None]:
         server = Api.spawn_server(
             interactive=interactive,
@@ -116,6 +139,7 @@ class Api:
             mapped_dir=mapped_dir,
             container_name=container_name,
             remove_previous=remove_previous,
+            no_platformio=no_platformio,
         )
         try:
             yield server
@@ -196,6 +220,8 @@ class Test:
         port: int | None = None,
         compile_server_port: int | None = None,
         open_browser: bool = True,
+        app: bool = False,
+        enable_https: bool = False,  # Default to HTTP for tests (tests use http:// URLs)
     ) -> Process:
         from fastled.open_browser import spawn_http_server
 
@@ -207,6 +233,8 @@ class Test:
             port=port,
             compile_server_port=compile_server_port,
             open_browser=open_browser,
+            app=app,
+            enable_https=enable_https,
         )
         return proc
 

fastled/__main__.py

@@ -0,0 +1,14 @@
+#!/usr/bin/env python3
+"""
+FastLED Package Main Entry Point
+Enables running the package as: python -m fastled
+"""
+
+import sys
+
+from fastled.cli import main
+
+if __name__ == "__main__":
+    # Pass execution to the main function from cli.py
+    # This enables 'python -m fastled' to work the same as 'fastled' command
+    sys.exit(main())

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.30"
+__version__ = "1.4.50"
 
 __version_url_latest__ = "https://raw.githubusercontent.com/zackees/fastled-wasm/refs/heads/main/src/fastled/__version__.py"

fastled/app.py

@@ -9,8 +9,10 @@ from pathlib import Path
 
 from fastled.client_server import run_client_server
 from fastled.compile_server import CompileServer
+from fastled.emoji_util import EMO
 from fastled.filewatcher import file_watcher_set
 from fastled.parse_args import Args, parse_args
+from fastled.settings import DEFAULT_URL
 from fastled.sketch import find_sketch_directories, looks_like_fastled_repo
 
 
@@ -27,6 +29,7 @@ def run_server(args: Args) -> int:
         mapped_dir=mapped_dir,
         auto_start=True,
         remove_previous=args.clear,
+        no_platformio=args.no_platformio,
     )
 
     if not interactive:
@@ -50,6 +53,41 @@ def main() -> int:
     from fastled.select_sketch_directory import select_sketch_directory
 
     args = parse_args()
+
+    if args.emsdk_headers:
+        import httpx
+
+        out_path = args.emsdk_headers
+        base_url = args.web if isinstance(args.web, str) else DEFAULT_URL
+        try:
+            response = httpx.get(f"{base_url}/headers/emsdk")
+            if response.status_code == 200:
+                Path(out_path).parent.mkdir(parents=True, exist_ok=True)
+                with open(out_path, "wb") as f:
+                    f.write(response.content)
+                print(f"{EMO('✅','SUCCESS:')} EMSDK headers exported to {out_path}")
+                return 0
+            else:
+                print(
+                    f"{EMO('❌','ERROR:')} Failed to export EMSDK headers: HTTP {response.status_code}"
+                )
+                return 1
+        except KeyboardInterrupt:
+            print("\nExiting from main...")
+            return 1
+        except Exception as e:
+            print(f"{EMO('❌','ERROR:')} Exception: {e}")
+            return 1
+
+    # Handle --install command early
+    if args.install:
+        from fastled.install.main import fastled_install
+
+        result = fastled_install(
+            dry_run=args.dry_run, no_interactive=args.no_interactive
+        )
+        return 0 if result else 1
+
     interactive: bool = args.interactive
     has_server = args.server
     update: bool = args.update
@@ -62,6 +100,14 @@ def main() -> int:
     # now it is safe to print out the version
     print(f"FastLED version: {__version__}")
 
+    # Print current working directory
+    print(f"Current working directory: {os.getcwd()}")
+
+    # Check if Playwright browsers are installed
+    playwright_dir = Path.home() / ".fastled" / "playwright"
+    if playwright_dir.exists() and any(playwright_dir.iterdir()):
+        print(f"{EMO('🎭', '*')} Playwright browsers available at: {playwright_dir}")
+
     # Resolve some of the last interactive arguments
     # 1. If interactive is set and the sketch directory is not given,
     # then prompt the user for a sketch directory.
@@ -75,7 +121,7 @@ def main() -> int:
             sketch_list: list[Path] = find_sketch_directories()
             if sketch_list:
                 maybe_dir: str | None = select_sketch_directory(
-                    sketch_list, cwd_looks_like_fastled_repo
+                    sketch_list, cwd_looks_like_fastled_repo, is_followup=True
                 )
                 if maybe_dir is not None:
                     directory = Path(maybe_dir)
@@ -87,7 +133,9 @@ def main() -> int:
 
     if update:
         # Force auto_update to ensure update check happens
-        compile_server = CompileServer(interactive=False, auto_updates=True)
+        compile_server = CompileServer(
+            interactive=False, auto_updates=True, no_platformio=args.no_platformio
+        )
         compile_server.stop()
         print("Finished updating.")
         return 0
@@ -109,6 +157,7 @@ def main() -> int:
             mapped_dir=directory,
             auto_start=False,
             remove_previous=args.clear,
+            no_platformio=args.no_platformio,
         )
 
         server.start(wait_for_startup=False)

fastled/args.py

@@ -12,8 +12,11 @@ class Args:
     interactive: bool
     profile: bool
     force_compile: bool
+    no_platformio: bool
+    app: bool  # New flag to trigger Playwright browser with browser download if needed
     auto_update: bool | None
     update: bool
+    background_update: bool
     localhost: bool
     build: bool
     server: bool
@@ -23,6 +26,10 @@ class Args:
     release: bool
     ram_disk_size: str  # suffixed liked "25mb" or "1gb"
     clear = False  # Force the last running container to be removed. Useful for benchmarking.
+    install: bool = False  # Install FastLED development environment
+    dry_run: bool = False  # Dry run mode for testing
+    no_interactive: bool = False  # Non-interactive mode
+    emsdk_headers: str | None = None  # Path to export EMSDK headers ZIP
 
     @staticmethod
     def from_namespace(args: argparse.Namespace) -> "Args":
@@ -47,10 +54,17 @@ class Args:
         assert isinstance(
             args.force_compile, bool
         ), f"expected bool, got {type(args.force_compile)}"
+        assert isinstance(
+            args.no_platformio, bool
+        ), f"expected bool, got {type(args.no_platformio)}"
+        assert isinstance(args.app, bool), f"expected bool, got {type(args.app)}"
         assert isinstance(
             args.no_auto_updates, bool | None
         ), f"expected bool | None, got {type(args.no_auto_updates)}"
         assert isinstance(args.update, bool), f"expected bool, got {type(args.update)}"
+        assert isinstance(
+            args.background_update, bool
+        ), f"expected bool, got {type(args.background_update)}"
         assert isinstance(
             args.localhost, bool
         ), f"expected bool, got {type(args.localhost)}"
@@ -62,6 +76,18 @@ class Args:
         assert isinstance(
             args.release, bool
         ), f"expected bool, got {type(args.release)}"
+        assert isinstance(
+            args.install, bool
+        ), f"expected bool, got {type(args.install)}"
+        assert isinstance(
+            args.dry_run, bool
+        ), f"expected bool, got {type(args.dry_run)}"
+        assert isinstance(
+            args.no_interactive, bool
+        ), f"expected bool, got {type(args.no_interactive)}"
+        assert isinstance(
+            args.emsdk_headers, str | None
+        ), f"expected str | None, got {type(args.emsdk_headers)}"
 
         init: bool | str = False
         if args.init is None:
@@ -78,8 +104,11 @@ class Args:
             interactive=args.interactive,
             profile=args.profile,
             force_compile=args.force_compile,
+            no_platformio=args.no_platformio,
+            app=args.app,
             auto_update=not args.no_auto_updates,
             update=args.update,
+            background_update=args.background_update,
             localhost=args.localhost,
             build=args.build,
             server=args.server,
@@ -88,4 +117,8 @@ class Args:
             quick=args.quick,
             release=args.release,
             ram_disk_size=args.ram_disk_size,
+            install=args.install,
+            dry_run=args.dry_run,
+            emsdk_headers=args.emsdk_headers,
+            no_interactive=args.no_interactive,
         )