fastled 1.3.38__tar.gz → 1.4.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastled
-Version: 1.3.38
+Version: 1.4.0
 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,34 @@ $ 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]
+```
+
+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:
+- 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
+- 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.
 
 # Install
 
@@ -81,14 +110,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.38/PKG-INFO → fastled-1.4.0/README.md

@@ -1,31 +1,3 @@
-Metadata-Version: 2.4
-Name: fastled
-Version: 1.3.38
-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,34 @@ $ 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]
+```
+
+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:
+- 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
+- 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.
 
 # Install
 
@@ -81,14 +80,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.38 → fastled-1.4.0}/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.38 → fastled-1.4.0}/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.38 → fastled-1.4.0}/src/fastled/__init__.py

@@ -95,7 +95,6 @@ class Api:
         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,

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

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

@@ -25,6 +25,16 @@ 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>

{fastled-1.3.38 → fastled-1.4.0}/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
 
@@ -105,14 +128,23 @@ 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 PLAYWRIGHT_AVAILABLE and open_with_playwright is not None:
+            print(f"Opening FastLED sketch in Playwright browser: {url}")
+            print(
+                "Auto-resize enabled: Browser window will automatically adjust to content size"
+            )
+            global _playwright_browser_proxy
+            _playwright_browser_proxy = open_with_playwright(url)
+        else:
+            print(f"Opening browser to {url}")
+            import webbrowser
+
+            webbrowser.open(
+                url=url,
+                new=1,
+                autoraise=True,
+            )
     return proc
 
 

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

@@ -82,8 +82,8 @@ def parse_args() -> Args:
     parser.add_argument(
         "--ram-disk-size",
         type=str,
-        default="0",
-        help="Set the size of the ramdisk for the docker container. Use suffixes like '25mb' or '1gb'.",
+        default="1gb",
+        help="Size of the RAM disk for compilation (e.g., '1gb', '512mb')",
     )
     parser.add_argument(
         "--web",
@@ -113,7 +113,7 @@ def parse_args() -> Args:
     parser.add_argument(
         "--no-auto-updates",
         action="store_true",
-        help="Disable automatic updates of the wasm compiler image when using docker.",
+        help="Disable automatic updates of the wasm compiler image when using docker. (Default: False)",
     )
     parser.add_argument(
         "--no-platformio",