fastled 1.4.0__tar.gz → 1.4.2__tar.gz

{fastled-1.4.0 → fastled-1.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastled
-Version: 1.4.0
+Version: 1.4.2
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies
@@ -371,6 +371,7 @@ A: A big chunk of space is being used by unnecessary javascript `emscripten` bun
 
 
 # Revisions
+  * 1.4.00 - Browser now uses playwright when `pip install fastled[full]` is used. Much better app like experience.
   * 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.

{fastled-1.4.0 → fastled-1.4.2}/README.md

@@ -341,6 +341,7 @@ A: A big chunk of space is being used by unnecessary javascript `emscripten` bun
 
 
 # Revisions
+  * 1.4.00 - Browser now uses playwright when `pip install fastled[full]` is used. Much better app like experience.
   * 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.

{fastled-1.4.0 → fastled-1.4.2}/src/fastled/__init__.py

@@ -70,6 +70,7 @@ class Api:
             int | None
         ) = None,  # None means auto select a free port. -1 means no server.
         no_platformio: bool = False,
+        no_playwright: bool = False,
     ) -> LiveClient:
         return LiveClient(
             sketch_directory=sketch_directory,
@@ -82,6 +83,7 @@ class Api:
             profile=profile,
             http_port=http_port,
             no_platformio=no_platformio,
+            no_playwright=no_playwright,
         )
 
     @staticmethod
@@ -206,6 +208,7 @@ class Test:
         port: int | None = None,
         compile_server_port: int | None = None,
         open_browser: bool = True,
+        no_playwright: bool = False,
     ) -> Process:
         from fastled.open_browser import spawn_http_server
 
@@ -217,6 +220,7 @@ class Test:
             port=port,
             compile_server_port=compile_server_port,
             open_browser=open_browser,
+            no_playwright=no_playwright,
         )
         return proc
 

{fastled-1.4.0 → fastled-1.4.2}/src/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.4.0"
+__version__ = "1.4.2"
 
 __version_url_latest__ = "https://raw.githubusercontent.com/zackees/fastled-wasm/refs/heads/main/src/fastled/__version__.py"

{fastled-1.4.0 → fastled-1.4.2}/src/fastled/app.py

@@ -63,6 +63,11 @@ def main() -> int:
     # now it is safe to print out the version
     print(f"FastLED version: {__version__}")
 
+    # Check if Playwright browsers are installed
+    playwright_dir = Path.home() / ".fastled" / "playwright"
+    if playwright_dir.exists() and any(playwright_dir.iterdir()):
+        print(f"🎭 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.

{fastled-1.4.0 → fastled-1.4.2}/src/fastled/args.py

@@ -13,6 +13,7 @@ class Args:
     profile: bool
     force_compile: bool
     no_platformio: bool
+    no_playwright: bool
     auto_update: bool | None
     update: bool
     localhost: bool
@@ -51,6 +52,9 @@ class Args:
         assert isinstance(
             args.no_platformio, bool
         ), f"expected bool, got {type(args.no_platformio)}"
+        assert isinstance(
+            args.no_playwright, bool
+        ), f"expected bool, got {type(args.no_playwright)}"
         assert isinstance(
             args.no_auto_updates, bool | None
         ), f"expected bool | None, got {type(args.no_auto_updates)}"
@@ -83,6 +87,7 @@ class Args:
             profile=args.profile,
             force_compile=args.force_compile,
             no_platformio=args.no_platformio,
+            no_playwright=args.no_playwright,
             auto_update=not args.no_auto_updates,
             update=args.update,
             localhost=args.localhost,

{fastled-1.4.0 → fastled-1.4.2}/src/fastled/client_server.py

@@ -268,6 +268,7 @@ def run_client(
     ) = None,  # None means auto select a free port, http_port < 0 means no server.
     clear: bool = False,
     no_platformio: bool = False,
+    no_playwright: bool = False,
 ) -> int:
     has_checked_newer_version_yet = False
     compile_server: CompileServer | None = None
@@ -348,6 +349,7 @@ def run_client(
                 port=http_port,
                 compile_server_port=port,
                 open_browser=open_web_browser,
+                no_playwright=no_playwright,
             )
         else:
             print("\nCompilation successful.")
@@ -508,6 +510,7 @@ def run_client_server(args: Args) -> int:
     open_web_browser = not just_compile and not interactive
     build_mode: BuildMode = BuildMode.from_args(args)
     no_platformio = bool(args.no_platformio)
+    no_playwright = bool(args.no_playwright)
 
     if not force_compile and not looks_like_sketch_directory(directory):
         # if there is only one directory in the sketch directory, use that
@@ -570,6 +573,7 @@ def run_client_server(args: Args) -> int:
             profile=profile,
             clear=args.clear,
             no_platformio=no_platformio,
+            no_playwright=no_playwright,
         )
     except KeyboardInterrupt:
         return 1

{fastled-1.4.0 → fastled-1.4.2}/src/fastled/live_client.py

@@ -23,6 +23,7 @@ class LiveClient:
         build_mode: BuildMode = BuildMode.QUICK,
         profile: bool = False,
         no_platformio: bool = False,
+        no_playwright: bool = False,
     ) -> None:
         self.sketch_directory = sketch_directory
         self.host = host
@@ -36,6 +37,7 @@ class LiveClient:
         self.thread: threading.Thread | None = None
         self.auto_updates = auto_updates
         self.no_platformio = no_platformio
+        self.no_playwright = no_playwright
         if auto_start:
             self.start()
         if self.auto_updates is False:
@@ -55,6 +57,7 @@ class LiveClient:
             shutdown=self.shutdown,
             http_port=self.http_port,
             no_platformio=self.no_platformio,
+            no_playwright=self.no_playwright,
         )
         return rtn
 

{fastled-1.4.0 → fastled-1.4.2}/src/fastled/open_browser.py

@@ -101,6 +101,7 @@ def spawn_http_server(
     compile_server_port: int,
     port: int | None = None,
     open_browser: bool = True,
+    no_playwright: bool = False,
 ) -> Process:
 
     if port is not None and not is_port_free(port):
@@ -129,7 +130,11 @@ def spawn_http_server(
     wait_for_server(port)
     if open_browser:
         url = f"http://localhost:{port}"
-        if PLAYWRIGHT_AVAILABLE and open_with_playwright is not None:
+        if (
+            PLAYWRIGHT_AVAILABLE
+            and open_with_playwright is not None
+            and not no_playwright
+        ):
             print(f"Opening FastLED sketch in Playwright browser: {url}")
             print(
                 "Auto-resize enabled: Browser window will automatically adjust to content size"

{fastled-1.4.0 → fastled-1.4.2}/src/fastled/parse_args.py

@@ -120,6 +120,11 @@ def parse_args() -> Args:
         action="store_true",
         help="Bypass PlatformIO constraints by using local Docker compilation with custom build environment",
     )
+    parser.add_argument(
+        "--no-playwright",
+        action="store_true",
+        help="Disable Playwright browser and use default system browser instead",
+    )
     parser.add_argument(
         "-u",
         "--update",

{fastled-1.4.0 → fastled-1.4.2}/src/fastled/playwright_browser.py

@@ -1,18 +1,23 @@
 """
 Playwright browser integration for FastLED WASM compiler.
 
-This module provides functionality to open the compiled FastLED sketch
+This module provides a Playwright-based browser implementation that can be used
 in a Playwright browser instead of the default system browser when
-the 'full' optional dependency is installed.
+Playwright is available.
 """
 
 import asyncio
+import os
 import sys
+import threading
 import warnings
-from typing import TYPE_CHECKING, Any
+from pathlib import Path
+from typing import Any
 
-if TYPE_CHECKING:
-    from playwright.async_api import Browser, Page
+# Set custom Playwright browser installation path
+PLAYWRIGHT_DIR = Path.home() / ".fastled" / "playwright"
+PLAYWRIGHT_DIR.mkdir(parents=True, exist_ok=True)
+os.environ["PLAYWRIGHT_BROWSERS_PATH"] = str(PLAYWRIGHT_DIR)
 
 try:
     from playwright.async_api import Browser, Page, async_playwright
@@ -21,8 +26,8 @@ try:
 except ImportError:
     PLAYWRIGHT_AVAILABLE = False
     async_playwright = None
-    Browser = Any  # type: ignore
-    Page = Any  # type: ignore
+    Browser = None
+    Page = None
 
 
 def is_playwright_available() -> bool:
@@ -268,34 +273,57 @@ def run_playwright_browser(url: str, headless: bool = False) -> None:
             "Playwright is not installed. Install with: pip install fastled[full]. "
             "Falling back to default browser."
         )
+        import webbrowser
+
+        webbrowser.open(url)
         return
 
     async def main():
-        browser = PlaywrightBrowser(headless=headless)
+        browser = None
         try:
+            browser = PlaywrightBrowser(headless=headless)
             await browser.start()
             await browser.open_url(url)
 
-            if not headless:
-                print("Playwright browser opened. Press Ctrl+C to close.")
-                await browser.wait_for_close()
-            else:
-                # In headless mode, just wait a bit for the page to load
-                await asyncio.sleep(2)
+            print("Playwright browser opened. Press Ctrl+C to close.")
+            await browser.wait_for_close()
 
+        except Exception as e:
+            # If we get an error that suggests browsers aren't installed, try to install them
+            if "executable doesn't exist" in str(e) or "Browser not found" in str(e):
+                print("🎭 Playwright browsers not found. Installing...")
+                if install_playwright_browsers():
+                    print("🎭 Retrying browser startup...")
+                    # Try again with fresh browser instance
+                    browser = PlaywrightBrowser(headless=headless)
+                    await browser.start()
+                    await browser.open_url(url)
+
+                    print("Playwright browser opened. Press Ctrl+C to close.")
+                    await browser.wait_for_close()
+                else:
+                    print("❌ Failed to install Playwright browsers")
+                    raise e
+            else:
+                raise e
         except KeyboardInterrupt:
             print("\nClosing Playwright browser...")
         finally:
-            await browser.close()
+            if browser is not None:
+                try:
+                    await browser.close()
+                except Exception as e:
+                    print(f"Warning: Failed to close Playwright browser: {e}")
 
     try:
         asyncio.run(main())
     except KeyboardInterrupt:
         print("\nPlaywright browser closed.")
     except Exception as e:
-        warnings.warn(
-            f"Playwright browser failed: {e}. Falling back to default browser."
-        )
+        print(f"Playwright browser failed: {e}. Falling back to default browser.")
+        import webbrowser
+
+        webbrowser.open(url)
 
 
 class PlaywrightBrowserProxy:
@@ -357,7 +385,6 @@ class PlaywrightBrowserProxy:
             return
 
         import os
-        import threading
 
         def monitor_process():
             """Monitor the browser process and exit when it terminates."""
@@ -407,8 +434,9 @@ def run_playwright_browser_persistent(url: str, headless: bool = False) -> None:
         return
 
     async def main():
-        browser = PlaywrightBrowser(headless=headless)
+        browser = None
         try:
+            browser = PlaywrightBrowser(headless=headless)
             await browser.start()
             await browser.open_url(url)
 
@@ -420,12 +448,37 @@ def run_playwright_browser_persistent(url: str, headless: bool = False) -> None:
             while not browser._should_exit.is_set():
                 await asyncio.sleep(0.1)
 
+        except Exception as e:
+            # If we get an error that suggests browsers aren't installed, try to install them
+            if "executable doesn't exist" in str(e) or "Browser not found" in str(e):
+                print("🎭 Playwright browsers not found. Installing...")
+                if install_playwright_browsers():
+                    print("🎭 Retrying browser startup...")
+                    # Try again with fresh browser instance
+                    browser = PlaywrightBrowser(headless=headless)
+                    await browser.start()
+                    await browser.open_url(url)
+
+                    print(
+                        "Playwright browser opened. Browser will remain open until the FastLED process exits."
+                    )
+
+                    # Keep the browser alive until exit is signaled
+                    while not browser._should_exit.is_set():
+                        await asyncio.sleep(0.1)
+                else:
+                    print("❌ Failed to install Playwright browsers")
+                    raise e
+            else:
+                raise e
         except KeyboardInterrupt:
             print("\nClosing Playwright browser...")
-        except Exception as e:
-            print(f"Playwright browser error: {e}")
         finally:
-            await browser.close()
+            if browser is not None:
+                try:
+                    await browser.close()
+                except Exception as e:
+                    print(f"Warning: Failed to close Playwright browser: {e}")
 
     try:
         asyncio.run(main())
@@ -455,6 +508,8 @@ def open_with_playwright(url: str, headless: bool = False) -> PlaywrightBrowserP
 def install_playwright_browsers() -> bool:
     """Install Playwright browsers if not already installed.
 
+    Installs browsers to ~/.fastled/playwright directory.
+
     Returns:
         True if installation was successful or browsers were already installed
     """
@@ -462,6 +517,16 @@ def install_playwright_browsers() -> bool:
         return False
 
     try:
+        import os
+        from pathlib import Path
+
+        # Set custom browser installation path
+        playwright_dir = Path.home() / ".fastled" / "playwright"
+        playwright_dir.mkdir(parents=True, exist_ok=True)
+
+        # Set environment variable for Playwright browser path
+        os.environ["PLAYWRIGHT_BROWSERS_PATH"] = str(playwright_dir)
+
         from playwright.sync_api import sync_playwright
 
         with sync_playwright() as p:
@@ -475,21 +540,24 @@ def install_playwright_browsers() -> bool:
 
         # If we get here, browsers need to be installed
         print("Installing Playwright browsers...")
+        print(f"Installing to: {playwright_dir}")
         import subprocess
 
         result = subprocess.run(
             [sys.executable, "-m", "playwright", "install", "chromium"],
             capture_output=True,
             text=True,
+            env=dict(os.environ, PLAYWRIGHT_BROWSERS_PATH=str(playwright_dir)),
         )
 
         if result.returncode == 0:
-            print("Playwright browsers installed successfully.")
+            print("✅ Playwright browsers installed successfully!")
+            print(f"   Location: {playwright_dir}")
             return True
         else:
-            print(f"Failed to install Playwright browsers: {result.stderr}")
+            print(f"❌ Failed to install Playwright browsers: {result.stderr}")
             return False
 
     except Exception as e:
-        print(f"Error installing Playwright browsers: {e}")
+        print(f"❌ Error installing Playwright browsers: {e}")
         return False

{fastled-1.4.0 → fastled-1.4.2}/src/fastled.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastled
-Version: 1.4.0
+Version: 1.4.2
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies
@@ -371,6 +371,7 @@ A: A big chunk of space is being used by unnecessary javascript `emscripten` bun
 
 
 # Revisions
+  * 1.4.00 - Browser now uses playwright when `pip install fastled[full]` is used. Much better app like experience.
   * 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.