fastled 1.4.36__tar.gz → 1.4.39__tar.gz

fastled-1.4.39/.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(python:*)",
+      "Bash(uv run:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

{fastled-1.4.36 → fastled-1.4.39}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastled
-Version: 1.4.36
+Version: 1.4.39
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies

fastled-1.4.39/requirements.docker.txt

@@ -0,0 +1 @@
+fastled-wasm-server>=1.1.44

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

{fastled-1.4.36 → fastled-1.4.39}/src/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-1.4.36 → fastled-1.4.39}/src/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-1.4.39/src/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-1.4.36 → fastled-1.4.39}/src/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-1.4.36 → fastled-1.4.39}/src/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-1.4.36 → fastled-1.4.39}/src/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-1.4.36 → fastled-1.4.39}/src/fastled.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastled
-Version: 1.4.36
+Version: 1.4.39
 Summary: FastLED Wasm Compiler
 Home-page: https://github.com/zackees/fastled-wasm
 Maintainer: Zachary Vorhies

{fastled-1.4.36 → fastled-1.4.39}/src/fastled.egg-info/SOURCES.txt

@@ -30,6 +30,7 @@ task.md
 task2.md
 test
 upload_package.sh
+.claude/settings.local.json
 .github/workflows/build_multi_docker_image.yml
 .github/workflows/build_webpage.yml
 .github/workflows/lint.yml
@@ -64,6 +65,7 @@ src/fastled/docker_manager.py
 src/fastled/emoji_util.py
 src/fastled/filewatcher.py
 src/fastled/find_good_connection.py
+src/fastled/header_dump.py
 src/fastled/interruptible_http.py
 src/fastled/keyboard.py
 src/fastled/keyz.py
@@ -123,6 +125,7 @@ tests/unit/test_docker_linux_on_windows.py
 tests/unit/test_embedded_data.py
 tests/unit/test_filechanger.py
 tests/unit/test_flask_headers.py
+tests/unit/test_header_dump.py
 tests/unit/test_http_server.py
 tests/unit/test_manual_api_invocation.py
 tests/unit/test_no_platformio_compile.py

fastled-1.4.39/tests/unit/test_header_dump.py

@@ -0,0 +1,120 @@
+"""
+Test header dump functionality for EMSDK headers export.
+"""
+
+import unittest
+from pathlib import Path
+from tempfile import TemporaryDirectory
+
+from fastled import Test
+from fastled.compile_server import CompileServer
+from fastled.header_dump import dump_emsdk_headers
+
+
+def _enabled() -> bool:
+    """Check if this system can run the tests."""
+    return Test.can_run_local_docker_tests()
+
+
+class HeaderDumpTester(unittest.TestCase):
+    """Test header dump functionality."""
+
+    @unittest.skipUnless(_enabled(), "Skipping test on non-Linux system on github")
+    def test_compile_server_header_dump(self) -> None:
+        """Test that EMSDK headers can be dumped from a live CompileServer."""
+
+        server = CompileServer(auto_start=True)
+        try:
+            with TemporaryDirectory() as tmpdir:
+                output_path = Path(tmpdir) / "emsdk_headers.zip"
+
+                # Test the server's get_emsdk_headers method directly
+                server.get_emsdk_headers(output_path)
+
+                # Verify the ZIP file was created
+                self.assertTrue(
+                    output_path.exists(), "EMSDK headers ZIP file was not created"
+                )
+
+                # Verify it's not empty
+                self.assertGreater(
+                    output_path.stat().st_size, 0, "EMSDK headers ZIP file is empty"
+                )
+
+                # Verify it's a valid ZIP file by checking the magic header
+                with open(output_path, "rb") as f:
+                    header = f.read(4)
+                    self.assertEqual(
+                        header[:2], b"PK", "File does not appear to be a valid ZIP file"
+                    )
+        finally:
+            # Stop the server
+            server.stop()
+
+            # Verify server stopped
+            self.assertFalse(server.running, "Server did not stop")
+
+    @unittest.skipUnless(_enabled(), "Skipping test on non-Linux system on github")
+    def test_dump_with_server_url(self) -> None:
+        """Test that EMSDK headers can be dumped using a specific server URL."""
+
+        server = CompileServer(auto_start=True)
+        try:
+            with TemporaryDirectory() as tmpdir:
+                output_path = Path(tmpdir) / "emsdk_headers_url.zip"
+
+                # Use dump_emsdk_headers with the server's URL
+                server_url = server.url()
+                dump_emsdk_headers(output_path, server_url=server_url)
+
+                # Verify the ZIP file was created
+                self.assertTrue(
+                    output_path.exists(), "EMSDK headers ZIP file was not created"
+                )
+
+                # Verify it's not empty
+                self.assertGreater(
+                    output_path.stat().st_size, 0, "EMSDK headers ZIP file is empty"
+                )
+        finally:
+            # Stop the server
+            server.stop()
+
+            # Verify server stopped
+            self.assertFalse(server.running, "Server did not stop")
+
+    def test_filepath_validation(self) -> None:
+        """Test that filepath validation works correctly."""
+
+        with TemporaryDirectory() as tmpdir:
+            invalid_path = Path(tmpdir) / "headers.txt"  # Wrong extension
+
+            # Should raise ValueError for non-.zip files
+            with self.assertRaises(ValueError) as context:
+                dump_emsdk_headers(invalid_path, server_url="http://example.com")
+
+            self.assertIn("must end with .zip", str(context.exception))
+
+    @unittest.skipUnless(_enabled(), "Skipping test on non-Linux system on github")
+    def test_dump_with_auto_fallback(self) -> None:
+        """Test dump_emsdk_headers with None server_url (auto local server creation)."""
+
+        with TemporaryDirectory() as tmpdir:
+            output_path = Path(tmpdir) / "emsdk_headers_auto.zip"
+
+            # Test with None server_url - should create local server automatically
+            dump_emsdk_headers(output_path, server_url=None)
+
+            # Verify the ZIP file was created
+            self.assertTrue(
+                output_path.exists(), "EMSDK headers ZIP file was not created"
+            )
+
+            # Verify it's not empty
+            self.assertGreater(
+                output_path.stat().st_size, 0, "EMSDK headers ZIP file is empty"
+            )
+
+
+if __name__ == "__main__":
+    unittest.main()

fastled-1.4.36/requirements.docker.txt

@@ -1 +0,0 @@
-fastled-wasm-server>=1.1.42