fastled 1.4.36__py3-none-any.whl → 1.4.38__py3-none-any.whl

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

fastled/compile_server.py

@@ -101,3 +101,9 @@ class CompileServer:
 
     def process_running(self) -> bool:
         return self.impl.process_running()
+
+    def get_emsdk_headers(self, filepath: Path) -> None:
+        """Get EMSDK headers ZIP data from the server and save to filepath."""
+        if not str(filepath).endswith(".zip"):
+            raise ValueError("Filepath must end with .zip")
+        return self.impl.get_emsdk_headers(filepath)

fastled/compile_server_impl.py

@@ -338,3 +338,14 @@ class CompileServerImpl:
         self.docker.suspend_container(self.container_name)
         self._port = 0
         print("Compile server stopped")
+
+    def get_emsdk_headers(self, filepath: Path) -> None:
+        """Get EMSDK headers ZIP data from the server and save to filepath."""
+        from fastled.util import download_emsdk_headers
+
+        if not self._port:
+            raise RuntimeError("Server has not been started yet")
+        if not self.ping():
+            raise RuntimeError("Server is not running")
+
+        download_emsdk_headers(self.url(), filepath)

fastled/header_dump.py

@@ -0,0 +1,63 @@
+"""Header dump functionality for EMSDK headers export."""
+
+import sys
+from pathlib import Path
+
+
+def dump_emsdk_headers(output_path: Path | str, server_url: str | None = None) -> None:
+    """
+    Dump EMSDK headers to a specified path.
+
+    Args:
+        output_path: Path where to save the headers ZIP file
+        server_url: URL of the server. If None, tries to create local server first,
+                   then falls back to remote server if local fails.
+    """
+    from fastled import Api
+    from fastled.settings import DEFAULT_URL
+    from fastled.util import download_emsdk_headers
+
+    # Convert to Path if string
+    if isinstance(output_path, str):
+        output_path = Path(output_path)
+
+    ends_with_zip = output_path.suffix == ".zip"
+    if not ends_with_zip:
+        raise ValueError(f"{output_path} must end with .zip")
+
+    try:
+        if server_url is not None:
+            # Use the provided server URL
+            download_emsdk_headers(server_url, output_path)
+            print(f"SUCCESS: EMSDK headers exported to {output_path}")
+        else:
+            # Try to create local server first
+            try:
+                with Api.server() as server:
+                    base_url = server.url()
+                    download_emsdk_headers(base_url, output_path)
+                    print(
+                        f"SUCCESS: EMSDK headers exported to {output_path} (using local server)"
+                    )
+            except Exception as local_error:
+                print(
+                    f"WARNING: Local server failed ({local_error}), falling back to remote server"
+                )
+                # Fall back to remote server
+                download_emsdk_headers(DEFAULT_URL, output_path)
+                print(
+                    f"SUCCESS: EMSDK headers exported to {output_path} (using remote server)"
+                )
+
+    except Exception as e:
+        print(f"ERROR: Exception during header dump: {e}")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        print("Usage: python -m fastled.header_dump <output_path>")
+        sys.exit(1)
+
+    output_path = sys.argv[1]
+    dump_emsdk_headers(output_path)

fastled/live_client.py

@@ -99,3 +99,15 @@ class LiveClient:
 
     def __exit__(self, exc_type, exc_value, traceback) -> None:
         self.finalize()
+
+    def get_emsdk_headers(self, filepath: Path) -> None:
+        """Get EMSDK headers ZIP data from the server and save to filepath."""
+        if isinstance(self.host, CompileServer):
+            self.host.get_emsdk_headers(filepath)
+        else:
+            # Handle string host or None case by using web_compile approach
+            from fastled.settings import DEFAULT_URL
+            from fastled.util import download_emsdk_headers
+
+            base_url = self.host if isinstance(self.host, str) else DEFAULT_URL
+            download_emsdk_headers(base_url, filepath)

fastled/parse_args.py

@@ -36,6 +36,7 @@ FastLED WASM Compiler - Useful options:
   --update              Update the docker image for the wasm compiler
   --background-update   Update the docker image in the background after compilation
   --purge               Remove all FastLED containers and images
+  --emsdk-headers <path> Export EMSDK headers ZIP to specified path
   --version             Show version information
   --help                Show detailed help
 Examples:
@@ -209,6 +210,14 @@ def parse_args() -> Args:
 
     args = parser.parse_args()
 
+    # Handle --emsdk-headers early before other processing
+    if args.emsdk_headers:
+        from fastled.header_dump import dump_emsdk_headers
+
+        out_path = args.emsdk_headers
+        dump_emsdk_headers(out_path)
+        sys.exit(0)
+
     # Auto-enable app mode if debug is used and Playwright cache exists
     if args.debug and not args.app:
         playwright_dir = Path.home() / ".fastled" / "playwright"

fastled/print_filter.py

@@ -1,52 +1,52 @@
-import re
-from abc import ABC, abstractmethod
-from enum import Enum
-
-
-class PrintFilter(ABC):
-    """Abstract base class for filtering text output."""
-
-    def __init__(self, echo: bool = True) -> None:
-        self.echo = echo
-
-    @abstractmethod
-    def filter(self, text: str) -> str:
-        """Filter the text according to implementation-specific rules."""
-        pass
-
-    def print(self, text: str | bytes) -> str:
-        """Prints the text to the console after filtering."""
-        if isinstance(text, bytes):
-            text = text.decode("utf-8")
-        text = self.filter(text)
-        if self.echo:
-            print(text, end="")
-        return text
-
-
-def _handle_ino_cpp(line: str) -> str:
-    if ".ino.cpp" in line[0:30]:
-        # Extract the filename without path and extension
-        match = re.search(r"src/([^/]+)\.ino\.cpp", line)
-        if match:
-            filename = match.group(1)
-            # Replace with examples/Filename/Filename.ino format
-            line = line.replace(
-                f"src/{filename}.ino.cpp", f"examples/{filename}/{filename}.ino"
-            )
-        else:
-            # Fall back to simple extension replacement if regex doesn't match
-            line = line.replace(".ino.cpp", ".ino")
-    return line
-
-
-class PrintFilterDefault(PrintFilter):
-    """Provides default filtering for FastLED output."""
-
-    def filter(self, text: str) -> str:
-        return text
-
-
-class CompileOrLink(Enum):
-    COMPILE = "compile"
-    LINK = "link"
+import re
+from abc import ABC, abstractmethod
+from enum import Enum
+
+
+class PrintFilter(ABC):
+    """Abstract base class for filtering text output."""
+
+    def __init__(self, echo: bool = True) -> None:
+        self.echo = echo
+
+    @abstractmethod
+    def filter(self, text: str) -> str:
+        """Filter the text according to implementation-specific rules."""
+        pass
+
+    def print(self, text: str | bytes) -> str:
+        """Prints the text to the console after filtering."""
+        if isinstance(text, bytes):
+            text = text.decode("utf-8")
+        text = self.filter(text)
+        if self.echo:
+            print(text, end="")
+        return text
+
+
+def _handle_ino_cpp(line: str) -> str:
+    if ".ino.cpp" in line[0:30]:
+        # Extract the filename without path and extension
+        match = re.search(r"src/([^/]+)\.ino\.cpp", line)
+        if match:
+            filename = match.group(1)
+            # Replace with examples/Filename/Filename.ino format
+            line = line.replace(
+                f"src/{filename}.ino.cpp", f"examples/{filename}/{filename}.ino"
+            )
+        else:
+            # Fall back to simple extension replacement if regex doesn't match
+            line = line.replace(".ino.cpp", ".ino")
+    return line
+
+
+class PrintFilterDefault(PrintFilter):
+    """Provides default filtering for FastLED output."""
+
+    def filter(self, text: str) -> str:
+        return text
+
+
+class CompileOrLink(Enum):
+    COMPILE = "compile"
+    LINK = "link"

fastled/util.py

@@ -52,3 +52,37 @@ def find_free_port(start_port: int, end_port: int) -> int | None:
         f"No free port found in the range {start_port}-{end_port}. Using {start_port}."
     )
     return None
+
+
+def download_emsdk_headers(base_url: str, filepath: Path) -> None:
+    """Download EMSDK headers from the specified URL and save to filepath.
+
+    Args:
+        base_url: Base URL of the server (e.g., 'http://localhost:8080')
+        filepath: Path where to save the headers ZIP file (must end with .zip)
+
+    Raises:
+        ValueError: If filepath doesn't end with .zip
+        RuntimeError: If download fails or server returns error
+    """
+    if not str(filepath).endswith(".zip"):
+        raise ValueError("Filepath must end with .zip")
+
+    import httpx
+
+    try:
+        timeout = httpx.Timeout(30.0, read=30.0)
+        with httpx.stream(
+            "GET", f"{base_url}/headers/emsdk", timeout=timeout
+        ) as response:
+            if response.status_code == 200:
+                filepath.parent.mkdir(parents=True, exist_ok=True)
+                with open(filepath, "wb") as f:
+                    for chunk in response.iter_bytes(chunk_size=512000):
+                        f.write(chunk)
+            else:
+                raise RuntimeError(
+                    f"Failed to get EMSDK headers: HTTP {response.status_code}"
+                )
+    except Exception as e:
+        raise RuntimeError(f"Error downloading EMSDK headers: {e}") from e

fastled/version.py

@@ -1,41 +1,41 @@
-from concurrent.futures import Future, ThreadPoolExecutor
-
-import httpx
-
-from fastled.__version__ import __version_url_latest__
-
-
-def _fetch_version() -> str | Exception:
-    """
-    Helper function to fetch the latest version from the GitHub repository.
-    """
-    try:
-        response = httpx.get(__version_url_latest__)
-        response.raise_for_status()
-        # Extract the version string from the response text
-        version_line = response.text.split("__version__ = ")[1].split('"')[1]
-        return version_line
-    except Exception as e:
-        return e
-
-
-def get_latest_version() -> Future[str | Exception]:
-    """
-    Fetch the latest version from the GitHub repository.
-    Returns a future that will resolve with the version string or an exception.
-    """
-    executor = ThreadPoolExecutor()
-    return executor.submit(_fetch_version)
-
-
-def unit_test() -> None:
-    future = get_latest_version()
-    latest_version = future.result()  # Wait for the future to complete
-    if isinstance(latest_version, Exception):
-        print(f"Error fetching latest version: {latest_version}")
-    else:
-        print(f"Latest version: {latest_version}")
-
-
-if __name__ == "__main__":
-    unit_test()
+from concurrent.futures import Future, ThreadPoolExecutor
+
+import httpx
+
+from fastled.__version__ import __version_url_latest__
+
+
+def _fetch_version() -> str | Exception:
+    """
+    Helper function to fetch the latest version from the GitHub repository.
+    """
+    try:
+        response = httpx.get(__version_url_latest__)
+        response.raise_for_status()
+        # Extract the version string from the response text
+        version_line = response.text.split("__version__ = ")[1].split('"')[1]
+        return version_line
+    except Exception as e:
+        return e
+
+
+def get_latest_version() -> Future[str | Exception]:
+    """
+    Fetch the latest version from the GitHub repository.
+    Returns a future that will resolve with the version string or an exception.
+    """
+    executor = ThreadPoolExecutor()
+    return executor.submit(_fetch_version)
+
+
+def unit_test() -> None:
+    future = get_latest_version()
+    latest_version = future.result()  # Wait for the future to complete
+    if isinstance(latest_version, Exception):
+        print(f"Error fetching latest version: {latest_version}")
+    else:
+        print(f"Latest version: {latest_version}")
+
+
+if __name__ == "__main__":
+    unit_test()