fastled 1.4.7__tar.gz → 1.4.8__tar.gz

{fastled-1.4.7 → fastled-1.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastled
-Version: 1.4.7
+Version: 1.4.8
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies
@@ -22,8 +22,7 @@ Requires-Dist: Flask>=3.0.0
 Requires-Dist: flask-cors>=4.0.0
 Requires-Dist: livereload
 Requires-Dist: disklru>=2.0.4
-Provides-Extra: full
-Requires-Dist: playwright>=1.40.0; extra == "full"
+Requires-Dist: playwright>=1.40.0
 Dynamic: home-page
 Dynamic: license-file
 Dynamic: maintainer
@@ -73,34 +72,28 @@ $ cd mysketchdirectory
 $ fastled
 ```
 
-## Playwright Browser Support
+## App-like Browser Support
 
-For enhanced browser control and automation capabilities, you can install the full version with Playwright support:
+FastLED includes Playwright for enhanced browser control and automation capabilities. To use the app-like browser experience, use the `--app` flag:
 
 ```bash
-$ pip install fastled[full]
+$ fastled --app my_sketch
 ```
 
-When installed, FastLED will automatically use Playwright to open your compiled sketch in a controlled browser environment instead of your system's default browser:
-
-```bash
-$ fastled my_sketch
-```
-
-The Playwright browser provides better automation capabilities and is especially useful for:
+The `--app` flag provides better automation capabilities and is especially useful for:
 - Automated testing of your LED sketches
 - Consistent cross-platform browser behavior
 - Advanced debugging and development workflows
 - Persistent browser sessions that stay open until the FastLED process exits
 
 **Key Benefits:**
-- Automatically enabled when `fastled[full]` is installed - no additional flags needed
+- Triggered by the `--app` flag - automatically downloads browsers if needed
 - The Playwright browser remains open throughout your development session
 - Automatic cleanup when the FastLED process exits
 - Better control over browser behavior and automation capabilities
 - Consistent behavior across different platforms
 
-If Playwright is not installed, the system will gracefully fall back to your default browser.
+If you don't use the `--app` flag, the system will use your default browser.
 
 # Install
 
@@ -110,26 +103,14 @@ This is a python app, so any python package manager will work. We also provide p
 
 `pip install fastled`
 
-### Pip with Playwright Support
-
-`pip install fastled[full]`
-
 ### UV
 
 `uv pip install fastled --system`
 
-### UV with Playwright Support
-
-`uv pip install "fastled[full]" --system`
-
 ### Pipx
 
 `pipx install fastled`
 
-### Pipx with Playwright Support
-
-`pipx install "fastled[full]"`
-
 ### Executables
 
   * Windows: https://github.com/zackees/fastled-wasm/releases/latest/download/fastled-windows-x64.zip
@@ -371,7 +352,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.4.00 - Browser now uses playwright when `--app` flag 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.7 → fastled-1.4.8}/README.md

@@ -43,34 +43,28 @@ $ cd mysketchdirectory
 $ fastled
 ```
 
-## Playwright Browser Support
+## App-like Browser Support
 
-For enhanced browser control and automation capabilities, you can install the full version with Playwright support:
+FastLED includes Playwright for enhanced browser control and automation capabilities. To use the app-like browser experience, use the `--app` flag:
 
 ```bash
-$ pip install fastled[full]
+$ fastled --app my_sketch
 ```
 
-When installed, FastLED will automatically use Playwright to open your compiled sketch in a controlled browser environment instead of your system's default browser:
-
-```bash
-$ fastled my_sketch
-```
-
-The Playwright browser provides better automation capabilities and is especially useful for:
+The `--app` flag provides better automation capabilities and is especially useful for:
 - Automated testing of your LED sketches
 - Consistent cross-platform browser behavior
 - Advanced debugging and development workflows
 - Persistent browser sessions that stay open until the FastLED process exits
 
 **Key Benefits:**
-- Automatically enabled when `fastled[full]` is installed - no additional flags needed
+- Triggered by the `--app` flag - automatically downloads browsers if needed
 - The Playwright browser remains open throughout your development session
 - Automatic cleanup when the FastLED process exits
 - Better control over browser behavior and automation capabilities
 - Consistent behavior across different platforms
 
-If Playwright is not installed, the system will gracefully fall back to your default browser.
+If you don't use the `--app` flag, the system will use your default browser.
 
 # Install
 
@@ -80,26 +74,14 @@ This is a python app, so any python package manager will work. We also provide p
 
 `pip install fastled`
 
-### Pip with Playwright Support
-
-`pip install fastled[full]`
-
 ### UV
 
 `uv pip install fastled --system`
 
-### UV with Playwright Support
-
-`uv pip install "fastled[full]" --system`
-
 ### Pipx
 
 `pipx install fastled`
 
-### Pipx with Playwright Support
-
-`pipx install "fastled[full]"`
-
 ### Executables
 
   * Windows: https://github.com/zackees/fastled-wasm/releases/latest/download/fastled-windows-x64.zip
@@ -341,7 +323,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.4.00 - Browser now uses playwright when `--app` flag 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.7 → fastled-1.4.8}/install

@@ -17,7 +17,7 @@ if ! command -v uv &> /dev/null; then
 fi
 
 uv venv --python 3.11 --seed
-uv pip install -e .[full]
+uv pip install -e .
 
 uv run pip install -r requirements.testing.txt
 uv run pip install -r requirements.docker.txt

{fastled-1.4.7 → fastled-1.4.8}/pyproject.toml

@@ -25,15 +25,11 @@ dependencies = [
     "flask-cors>=4.0.0",
     "livereload",
     "disklru>=2.0.4",
+    "playwright>=1.40.0",
 ]
 
 dynamic = ["version"]
 
-[project.optional-dependencies]
-full = [
-    "playwright>=1.40.0",
-]
-
 [tool.setuptools]
 package-dir = {"" = "src"}
 

{fastled-1.4.7 → fastled-1.4.8}/src/fastled/__init__.py

@@ -81,7 +81,6 @@ 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,
@@ -94,7 +93,6 @@ class Api:
             profile=profile,
             http_port=http_port,
             no_platformio=no_platformio,
-            no_playwright=no_playwright,
         )
 
     @staticmethod
@@ -219,7 +217,7 @@ class Test:
         port: int | None = None,
         compile_server_port: int | None = None,
         open_browser: bool = True,
-        no_playwright: bool = False,
+        app: bool = False,
     ) -> Process:
         from fastled.open_browser import spawn_http_server
 
@@ -231,7 +229,7 @@ class Test:
             port=port,
             compile_server_port=compile_server_port,
             open_browser=open_browser,
-            no_playwright=no_playwright,
+            app=app,
         )
         return proc
 

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

{fastled-1.4.7 → fastled-1.4.8}/src/fastled/args.py

@@ -13,7 +13,7 @@ class Args:
     profile: bool
     force_compile: bool
     no_platformio: bool
-    no_playwright: bool
+    app: bool  # New flag to trigger Playwright browser with browser download if needed
     auto_update: bool | None
     update: bool
     localhost: bool
@@ -52,9 +52,7 @@ 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.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)}"
@@ -87,7 +85,7 @@ class Args:
             profile=args.profile,
             force_compile=args.force_compile,
             no_platformio=args.no_platformio,
-            no_playwright=args.no_playwright,
+            app=args.app,
             auto_update=not args.no_auto_updates,
             update=args.update,
             localhost=args.localhost,

{fastled-1.4.7 → fastled-1.4.8}/src/fastled/client_server.py

@@ -25,16 +25,6 @@ from fastled.web_compile import (
 )
 
 
-def _always_false() -> bool:
-    return False
-
-
-try:
-    from fastled.playwright_browser import is_playwright_available
-except ImportError:
-    is_playwright_available = _always_false
-
-
 def _create_error_html(error_message: str) -> str:
     return f"""<!DOCTYPE html>
 <html>
@@ -277,7 +267,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,
+    app: bool = False,  # Use app-like browser experience
 ) -> int:
     has_checked_newer_version_yet = False
     compile_server: CompileServer | None = None
@@ -365,7 +355,7 @@ def run_client(
                 port=http_port,
                 compile_server_port=port,
                 open_browser=open_web_browser,
-                no_playwright=no_playwright,
+                app=app,
             )
         else:
             print("\nCompilation successful.")
@@ -531,7 +521,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)
+    app = bool(args.app)
 
     if not force_compile and not looks_like_sketch_directory(directory):
         # if there is only one directory in the sketch directory, use that
@@ -594,7 +584,7 @@ def run_client_server(args: Args) -> int:
             profile=profile,
             clear=args.clear,
             no_platformio=no_platformio,
-            no_playwright=no_playwright,
+            app=app,
         )
     except KeyboardInterrupt:
         return 1

{fastled-1.4.7 → fastled-1.4.8}/src/fastled/live_client.py

@@ -23,7 +23,6 @@ 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
@@ -37,7 +36,6 @@ 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:
@@ -57,7 +55,6 @@ 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.7 → fastled-1.4.8}/src/fastled/open_browser.py

@@ -6,16 +6,9 @@ import weakref
 from multiprocessing import Process
 from pathlib import Path
 
+from fastled.playwright_browser import open_with_playwright
 from fastled.server_flask import run_flask_in_thread
 
-try:
-    from fastled.playwright_browser import is_playwright_available, open_with_playwright
-
-    PLAYWRIGHT_AVAILABLE = is_playwright_available()
-except ImportError:
-    PLAYWRIGHT_AVAILABLE = False
-    open_with_playwright = None
-
 # Global reference to keep Playwright browser alive
 _playwright_browser_proxy = None
 
@@ -101,7 +94,7 @@ def spawn_http_server(
     compile_server_port: int,
     port: int | None = None,
     open_browser: bool = True,
-    no_playwright: bool = False,
+    app: bool = False,
 ) -> Process:
 
     if port is not None and not is_port_free(port):
@@ -130,11 +123,15 @@ 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
-            and not no_playwright
-        ):
+        should_use_playwright = app
+
+        if should_use_playwright:
+            if app:
+                # For --app mode, try to install browsers if needed
+                from fastled.playwright_browser import install_playwright_browsers
+
+                install_playwright_browsers()
+
             print(f"Opening FastLED sketch in Playwright browser: {url}")
             print(
                 "Auto-resize enabled: Browser window will automatically adjust to content size"

{fastled-1.4.7 → fastled-1.4.8}/src/fastled/parse_args.py

@@ -121,9 +121,9 @@ def parse_args() -> Args:
         help="Bypass PlatformIO constraints by using local Docker compilation with custom build environment",
     )
     parser.add_argument(
-        "--no-playwright",
+        "--app",
         action="store_true",
-        help="Disable Playwright browser and use default system browser instead",
+        help="Use Playwright app-like browser experience (will download browsers if needed)",
     )
     parser.add_argument(
         "-u",

{fastled-1.4.7 → fastled-1.4.8}/src/fastled/playwright_browser.py

@@ -18,21 +18,6 @@ from typing import Any
 PLAYWRIGHT_DIR = Path.home() / ".fastled" / "playwright"
 PLAYWRIGHT_DIR.mkdir(parents=True, exist_ok=True)
 
-try:
-    from playwright.async_api import Browser, Page, async_playwright
-
-    PLAYWRIGHT_AVAILABLE = True
-except ImportError:
-    PLAYWRIGHT_AVAILABLE = False
-    async_playwright = None
-    Browser = None
-    Page = None
-
-
-def is_playwright_available() -> bool:
-    """Check if Playwright is available."""
-    return PLAYWRIGHT_AVAILABLE
-
 
 def get_chromium_executable_path() -> str | None:
     """Get the path to the custom Chromium executable if it exists."""
@@ -73,10 +58,6 @@ class PlaywrightBrowser:
         Args:
             headless: Whether to run the browser in headless mode
         """
-        if not is_playwright_available():
-            raise ImportError(
-                "Playwright is not installed. Install with: pip install fastled[full]"
-            )
 
         self.headless = headless
         self.auto_resize = True  # Always enable auto-resize
@@ -137,32 +118,28 @@ class PlaywrightBrowser:
     async def start(self) -> None:
         """Start the Playwright browser."""
         if self.browser is None:
-            if is_playwright_available():
-                from playwright.async_api import async_playwright
-
-                self.playwright = async_playwright()
-                playwright = await self.playwright.start()
-
-                # Get custom Chromium executable path if available
-                executable_path = get_chromium_executable_path()
-                launch_kwargs = {
-                    "headless": self.headless,
-                    "args": [
-                        "--disable-dev-shm-usage",
-                        "--disable-web-security",
-                        "--allow-running-insecure-content",
-                    ],
-                }
 
-                if executable_path:
-                    launch_kwargs["executable_path"] = executable_path
-                    print(
-                        f"[PYTHON] Using custom Chromium executable: {executable_path}"
-                    )
+            from playwright.async_api import async_playwright
 
-                self.browser = await playwright.chromium.launch(**launch_kwargs)
-            else:
-                raise RuntimeError("Playwright is not available")
+            self.playwright = async_playwright()
+            playwright = await self.playwright.start()
+
+            # Get custom Chromium executable path if available
+            executable_path = get_chromium_executable_path()
+            launch_kwargs = {
+                "headless": self.headless,
+                "args": [
+                    "--disable-dev-shm-usage",
+                    "--disable-web-security",
+                    "--allow-running-insecure-content",
+                ],
+            }
+
+            if executable_path:
+                launch_kwargs["executable_path"] = executable_path
+                print(f"[PYTHON] Using custom Chromium executable: {executable_path}")
+
+            self.browser = await playwright.chromium.launch(**launch_kwargs)
 
         if self.page is None and self.browser is not None:
             # Detect system device scale factor for natural browser behavior
@@ -378,15 +355,6 @@ def run_playwright_browser(url: str, headless: bool = False) -> None:
         url: The URL to open
         headless: Whether to run in headless mode
     """
-    if not is_playwright_available():
-        warnings.warn(
-            "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 = None
@@ -452,16 +420,6 @@ class PlaywrightBrowserProxy:
             url: The URL to open
             headless: Whether to run in headless mode
         """
-        if not is_playwright_available():
-            warnings.warn(
-                "Playwright is not installed. Install with: pip install fastled[full]. "
-                "Falling back to default browser."
-            )
-            # Fall back to default browser
-            import webbrowser
-
-            webbrowser.open(url)
-            return
 
         try:
             # Run Playwright in a separate process to avoid blocking
@@ -538,8 +496,6 @@ def run_playwright_browser_persistent(url: str, headless: bool = False) -> None:
         url: The URL to open
         headless: Whether to run in headless mode
     """
-    if not is_playwright_available():
-        return
 
     async def main():
         browser = None
@@ -621,8 +577,6 @@ def install_playwright_browsers() -> bool:
     Returns:
         True if installation was successful or browsers were already installed
     """
-    if not PLAYWRIGHT_AVAILABLE:
-        return False
 
     try:
         import os

{fastled-1.4.7 → fastled-1.4.8}/src/fastled.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastled
-Version: 1.4.7
+Version: 1.4.8
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies
@@ -22,8 +22,7 @@ Requires-Dist: Flask>=3.0.0
 Requires-Dist: flask-cors>=4.0.0
 Requires-Dist: livereload
 Requires-Dist: disklru>=2.0.4
-Provides-Extra: full
-Requires-Dist: playwright>=1.40.0; extra == "full"
+Requires-Dist: playwright>=1.40.0
 Dynamic: home-page
 Dynamic: license-file
 Dynamic: maintainer
@@ -73,34 +72,28 @@ $ cd mysketchdirectory
 $ fastled
 ```
 
-## Playwright Browser Support
+## App-like Browser Support
 
-For enhanced browser control and automation capabilities, you can install the full version with Playwright support:
+FastLED includes Playwright for enhanced browser control and automation capabilities. To use the app-like browser experience, use the `--app` flag:
 
 ```bash
-$ pip install fastled[full]
+$ fastled --app my_sketch
 ```
 
-When installed, FastLED will automatically use Playwright to open your compiled sketch in a controlled browser environment instead of your system's default browser:
-
-```bash
-$ fastled my_sketch
-```
-
-The Playwright browser provides better automation capabilities and is especially useful for:
+The `--app` flag provides better automation capabilities and is especially useful for:
 - Automated testing of your LED sketches
 - Consistent cross-platform browser behavior
 - Advanced debugging and development workflows
 - Persistent browser sessions that stay open until the FastLED process exits
 
 **Key Benefits:**
-- Automatically enabled when `fastled[full]` is installed - no additional flags needed
+- Triggered by the `--app` flag - automatically downloads browsers if needed
 - The Playwright browser remains open throughout your development session
 - Automatic cleanup when the FastLED process exits
 - Better control over browser behavior and automation capabilities
 - Consistent behavior across different platforms
 
-If Playwright is not installed, the system will gracefully fall back to your default browser.
+If you don't use the `--app` flag, the system will use your default browser.
 
 # Install
 
@@ -110,26 +103,14 @@ This is a python app, so any python package manager will work. We also provide p
 
 `pip install fastled`
 
-### Pip with Playwright Support
-
-`pip install fastled[full]`
-
 ### UV
 
 `uv pip install fastled --system`
 
-### UV with Playwright Support
-
-`uv pip install "fastled[full]" --system`
-
 ### Pipx
 
 `pipx install fastled`
 
-### Pipx with Playwright Support
-
-`pipx install "fastled[full]"`
-
 ### Executables
 
   * Windows: https://github.com/zackees/fastled-wasm/releases/latest/download/fastled-windows-x64.zip
@@ -371,7 +352,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.4.00 - Browser now uses playwright when `--app` flag 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.7 → fastled-1.4.8}/src/fastled.egg-info/requires.txt

@@ -10,6 +10,4 @@ Flask>=3.0.0
 flask-cors>=4.0.0
 livereload
 disklru>=2.0.4
-
-[full]
 playwright>=1.40.0

{fastled-1.4.7 → fastled-1.4.8}/tests/integration/test_playwright_integration.py

@@ -5,18 +5,12 @@ Unit tests for Playwright integration.
 import unittest
 from unittest.mock import MagicMock, patch
 
-from fastled.playwright_browser import is_playwright_available, open_with_playwright
+from fastled.playwright_browser import open_with_playwright
 
 
 class PlaywrightIntegrationTester(unittest.TestCase):
     """Test Playwright integration functionality."""
 
-    def test_playwright_availability_check(self):
-        """Test that the Playwright availability check works correctly."""
-        # The availability check should return a boolean
-        result = is_playwright_available()
-        self.assertIsInstance(result, bool)
-
     def test_open_with_playwright_fallback(self):
         """Test that open_with_playwright falls back to webbrowser when Playwright is not available."""
         test_url = "http://localhost:8080"