fastled 1.3.37__tar.gz → 1.3.39__tar.gz

{fastled-1.3.37/src/fastled.egg-info → fastled-1.3.39}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastled
-Version: 1.3.37
+Version: 1.3.39
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies
@@ -22,6 +22,8 @@ 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"
 Dynamic: home-page
 Dynamic: license-file
 Dynamic: maintainer
@@ -71,7 +73,33 @@ $ cd mysketchdirectory
 $ fastled
 ```
 
+## Playwright Browser Support
 
+For enhanced browser control and automation capabilities, you can install the full version with Playwright support:
+
+```bash
+$ pip install fastled[full]
+```
+
+This enables the `--playwright` flag which opens your compiled sketch in a Playwright-controlled browser instead of your system's default browser:
+
+```bash
+$ fastled my_sketch --playwright
+```
+
+The Playwright browser 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:**
+- 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 and you use the `--playwright` flag, the system will gracefully fall back to your default browser.
 
 # Install
 
@@ -81,14 +109,26 @@ 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

fastled-1.3.37/PKG-INFO → fastled-1.3.39/README.md

@@ -1,31 +1,3 @@
-Metadata-Version: 2.4
-Name: fastled
-Version: 1.3.37
-Summary: FastLED Wasm Compiler
-Home-page: https://github.com/zackees/fastled-wasm
-Maintainer: Zachary Vorhies
-License: BSD 3-Clause License
-Keywords: template-python-cmd
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: watchdog>=6.0.0
-Requires-Dist: docker>=7.1.0
-Requires-Dist: filelock>=3.16.1
-Requires-Dist: appdirs>=1.4.4
-Requires-Dist: rapidfuzz>=3.10.1
-Requires-Dist: progress>=1.6
-Requires-Dist: watchfiles>=1.0.5
-Requires-Dist: Flask>=3.0.0
-Requires-Dist: flask-cors>=4.0.0
-Requires-Dist: livereload
-Requires-Dist: disklru>=2.0.4
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: maintainer
-
 # FastLED Wasm compiler
 
 [![Linting](https://github.com/zackees/fastled-wasm/actions/workflows/lint.yml/badge.svg)](https://github.com/zackees/fastled-wasm/actions/workflows/lint.yml)
@@ -71,7 +43,33 @@ $ cd mysketchdirectory
 $ fastled
 ```
 
+## Playwright Browser Support
+
+For enhanced browser control and automation capabilities, you can install the full version with Playwright support:
+
+```bash
+$ pip install fastled[full]
+```
+
+This enables the `--playwright` flag which opens your compiled sketch in a Playwright-controlled browser instead of your system's default browser:
+
+```bash
+$ fastled my_sketch --playwright
+```
 
+The Playwright browser 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:**
+- 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 and you use the `--playwright` flag, the system will gracefully fall back to your default browser.
 
 # Install
 
@@ -81,14 +79,26 @@ 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

{fastled-1.3.37 → fastled-1.3.39}/install

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

{fastled-1.3.37 → fastled-1.3.39}/pyproject.toml

@@ -29,6 +29,11 @@ dependencies = [
 
 dynamic = ["version"]
 
+[project.optional-dependencies]
+full = [
+    "playwright>=1.40.0",
+]
+
 [tool.setuptools]
 package-dir = {"" = "src"}
 

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

{fastled-1.3.37 → fastled-1.3.39}/src/fastled/args.py

@@ -23,6 +23,8 @@ class Args:
     quick: bool
     release: bool
     ram_disk_size: str  # suffixed liked "25mb" or "1gb"
+    playwright: bool = False  # Use Playwright browser instead of system default
+    no_playwright_auto_resize: bool = False  # Disable Playwright auto-resize
     clear = False  # Force the last running container to be removed. Useful for benchmarking.
 
     @staticmethod
@@ -66,6 +68,12 @@ class Args:
         assert isinstance(
             args.release, bool
         ), f"expected bool, got {type(args.release)}"
+        assert isinstance(
+            args.playwright, bool
+        ), f"expected bool, got {type(args.playwright)}"
+        assert isinstance(
+            args.no_playwright_auto_resize, bool
+        ), f"expected bool, got {type(args.no_playwright_auto_resize)}"
 
         init: bool | str = False
         if args.init is None:
@@ -93,4 +101,6 @@ class Args:
             quick=args.quick,
             release=args.release,
             ram_disk_size=args.ram_disk_size,
+            playwright=args.playwright,
+            no_playwright_auto_resize=args.no_playwright_auto_resize,
         )

{fastled-1.3.37 → fastled-1.3.39}/src/fastled/client_server.py

@@ -1,4 +1,5 @@
 import shutil
+import sys
 import tempfile
 import threading
 import time
@@ -67,7 +68,20 @@ def TEST_BEFORE_COMPILE(url) -> None:
 def _chunked_print(stdout: str) -> None:
     lines = stdout.splitlines()
     for line in lines:
-        print(line)
+        try:
+            print(line)
+        except UnicodeEncodeError:
+            # On Windows, the console may not support Unicode characters
+            # Try to encode the line with the console's encoding and replace problematic characters
+            try:
+                console_encoding = sys.stdout.encoding or "utf-8"
+                encoded_line = line.encode(console_encoding, errors="replace").decode(
+                    console_encoding
+                )
+                print(encoded_line)
+            except Exception:
+                # If all else fails, just print the line without problematic characters
+                print(line.encode("ascii", errors="replace").decode("ascii"))
 
 
 def _run_web_compiler(
@@ -244,6 +258,8 @@ def run_client(
     ) = None,  # None means auto select a free port, http_port < 0 means no server.
     clear: bool = False,
     no_platformio: bool = False,
+    use_playwright: bool = False,
+    playwright_auto_resize: bool = True,
 ) -> int:
     has_checked_newer_version_yet = False
     compile_server: CompileServer | None = None
@@ -324,6 +340,8 @@ def run_client(
                 port=http_port,
                 compile_server_port=port,
                 open_browser=open_web_browser,
+                use_playwright=use_playwright,
+                playwright_auto_resize=playwright_auto_resize,
             )
         else:
             print("\nCompilation successful.")
@@ -546,6 +564,8 @@ def run_client_server(args: Args) -> int:
             profile=profile,
             clear=args.clear,
             no_platformio=no_platformio,
+            use_playwright=args.playwright,
+            playwright_auto_resize=not args.no_playwright_auto_resize,
         )
     except KeyboardInterrupt:
         return 1

{fastled-1.3.37 → fastled-1.3.39}/src/fastled/open_browser.py

@@ -8,6 +8,29 @@ from pathlib import Path
 
 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
+
+
+def cleanup_playwright_browser() -> None:
+    """Clean up the Playwright browser on exit."""
+    global _playwright_browser_proxy
+    if _playwright_browser_proxy:
+        _playwright_browser_proxy.close()
+        _playwright_browser_proxy = None
+
+
+# Register cleanup function
+atexit.register(cleanup_playwright_browser)
+
 DEFAULT_PORT = 8089  # different than live version.
 PYTHON_EXE = sys.executable
 
@@ -78,6 +101,8 @@ def spawn_http_server(
     compile_server_port: int,
     port: int | None = None,
     open_browser: bool = True,
+    use_playwright: bool = False,
+    playwright_auto_resize: bool = True,
 ) -> Process:
 
     if port is not None and not is_port_free(port):
@@ -105,14 +130,38 @@ def spawn_http_server(
 
     wait_for_server(port)
     if open_browser:
-        print(f"Opening browser to http://localhost:{port}")
-        import webbrowser
-
-        webbrowser.open(
-            url=f"http://localhost:{port}",
-            new=1,
-            autoraise=True,
-        )
+        url = f"http://localhost:{port}"
+        if use_playwright and PLAYWRIGHT_AVAILABLE and open_with_playwright is not None:
+            print(f"Opening FastLED sketch in Playwright browser: {url}")
+            if playwright_auto_resize:
+                print(
+                    "Auto-resize enabled: Browser window will automatically adjust to content size"
+                )
+            global _playwright_browser_proxy
+            _playwright_browser_proxy = open_with_playwright(
+                url, auto_resize=playwright_auto_resize
+            )
+        elif use_playwright and not PLAYWRIGHT_AVAILABLE:
+            print(
+                "Playwright requested but not available. Install with: pip install fastled[full]"
+            )
+            print(f"Falling back to system browser: {url}")
+            import webbrowser
+
+            webbrowser.open(
+                url=url,
+                new=1,
+                autoraise=True,
+            )
+        else:
+            print(f"Opening browser to {url}")
+            import webbrowser
+
+            webbrowser.open(
+                url=url,
+                new=1,
+                autoraise=True,
+            )
     return proc
 
 

{fastled-1.3.37 → fastled-1.3.39}/src/fastled/parse_args.py

@@ -35,12 +35,15 @@ FastLED WASM Compiler - Useful options:
   --profile             Enable profiling the C++ build system
   --update              Update the docker image for the wasm compiler
   --purge               Remove all FastLED containers and images
+  --playwright          Use Playwright browser (requires 'pip install fastled[full]')
+  --no-playwright-auto-resize  Disable automatic window resizing in Playwright
   --version             Show version information
   --help                Show detailed help
 Examples:
   fastled (will auto detect the sketch directory and prompt you)
   fastled my_sketch
   fastled my_sketch --web (compiles using the web compiler only)
+  fastled my_sketch --playwright (opens in Playwright browser)
   fastled --init Blink (initializes a new sketch directory with the Blink example)
   fastled --server (runs the compiler server in the current directory)
 
@@ -158,6 +161,18 @@ def parse_args() -> Args:
         help="Remove all FastLED containers and images",
     )
 
+    parser.add_argument(
+        "--playwright",
+        action="store_true",
+        help="Use Playwright browser instead of system default (requires 'pip install fastled[full]')",
+    )
+
+    parser.add_argument(
+        "--no-playwright-auto-resize",
+        action="store_true",
+        help="Disable automatic window resizing in Playwright browser",
+    )
+
     build_mode = parser.add_mutually_exclusive_group()
     build_mode.add_argument("--debug", action="store_true", help="Build in debug mode")
     build_mode.add_argument(