fastled 1.2.67__py3-none-any.whl → 1.2.68__py3-none-any.whl

fastled/__init__.py

@@ -13,7 +13,7 @@ from .types import BuildMode, CompileResult, CompileServerError
 # 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.2.67"
+__version__ = "1.2.68"
 
 DOCKER_FILE = (
     "https://raw.githubusercontent.com/zackees/fastled-wasm/refs/heads/main/Dockerfile"
@@ -137,7 +137,9 @@ class Docker:
     def is_running() -> bool:
         from fastled.docker_manager import DockerManager
 
-        return DockerManager.is_running()
+        ok: bool
+        ok, _ = DockerManager.is_running()
+        return ok
 
     @staticmethod
     def is_container_running(container_name: str | None = None) -> bool:

fastled/compile_server.py

@@ -59,7 +59,8 @@ class CompileServer:
 
     @property
     def running(self) -> bool:
-        return self.impl.running
+        ok, _ = self.impl.running
+        return ok
 
     @property
     def fastled_src_dir(self) -> Path | None:

fastled/compile_server_impl.py

@@ -1,6 +1,7 @@
 import subprocess
 import sys
 import time
+import traceback
 import warnings
 from datetime import datetime, timezone
 from pathlib import Path
@@ -111,14 +112,24 @@ class CompileServerImpl:
         project_init(example=example, outputdir=outputdir)
 
     @property
-    def running(self) -> bool:
+    def running(self) -> tuple[bool, Exception | None]:
         if not self._port:
-            return False
+            return False, Exception("Docker hasn't been initialzed with a port yet")
         if not DockerManager.is_docker_installed():
-            return False
-        if not DockerManager.is_running():
-            return False
-        return self.docker.is_container_running(self.container_name)
+            return False, Exception("Docker is not installed")
+        docker_running, err = self.docker.is_running()
+        if not docker_running:
+            IS_MAC = sys.platform == "darwin"
+            if IS_MAC:
+                if "FileNotFoundError" in str(err):
+                    traceback.print_exc()
+                    print("\n\nNone fatal debug print for MacOS\n")
+            return False, err
+        ok: bool = self.docker.is_container_running(self.container_name)
+        if ok:
+            return True, None
+        else:
+            return False, Exception("Docker is not running")
 
     def using_fastled_src_dir_volume(self) -> bool:
         out = self.fastled_src_dir is not None

fastled/docker_manager.py

@@ -201,24 +201,24 @@ class DockerManager:
             return False
 
     @staticmethod
-    def is_running() -> bool:
+    def is_running() -> tuple[bool, Exception | None]:
         """Check if Docker is running by pinging the Docker daemon."""
 
         if not DockerManager.is_docker_installed():
             print("Docker is not installed.")
-            return False
+            return False, Exception("Docker is not installed.")
         try:
             # self.client.ping()
             client = docker.from_env()
             client.ping()
             print("Docker is running.")
-            return True
+            return True, None
         except DockerException as e:
             print(f"Docker is not running: {str(e)}")
-            return False
+            return False, e
         except Exception as e:
             print(f"Error pinging Docker daemon: {str(e)}")
-            return False
+            return False, e
 
     def start(self) -> bool:
         """Attempt to start Docker Desktop (or the Docker daemon) automatically."""

fastled/project_init.py

@@ -1,129 +1,129 @@
-import _thread
-import threading
-import time
-import zipfile
-from pathlib import Path
-
-import httpx
-
-from fastled.settings import DEFAULT_URL
-from fastled.spinner import Spinner
-
-DEFAULT_EXAMPLE = "wasm"
-
-
-def get_examples(host: str | None = None) -> list[str]:
-    host = host or DEFAULT_URL
-    url_info = f"{host}/info"
-    response = httpx.get(url_info, timeout=4)
-    response.raise_for_status()
-    examples: list[str] = response.json()["examples"]
-    return sorted(examples)
-
-
-def _prompt_for_example() -> str:
-    examples = get_examples()
-    while True:
-        print("Available examples:")
-        for i, example in enumerate(examples):
-            print(f"  [{i+1}]: {example}")
-        answer = input("Enter the example number or name: ").strip()
-        if answer.isdigit():
-            example_num = int(answer) - 1
-            if example_num < 0 or example_num >= len(examples):
-                print("Invalid example number")
-                continue
-            return examples[example_num]
-        elif answer in examples:
-            return answer
-
-
-class DownloadThread(threading.Thread):
-    def __init__(self, url: str, json: str):
-        super().__init__(daemon=True)
-        self.url = url
-        self.json = json
-        self.bytes_downloaded = 0
-        self.content: bytes | None = None
-        self.error: Exception | None = None
-        self.success = False
-
-    def run(self) -> None:
-        timeout = httpx.Timeout(5.0, connect=5.0, read=120.0, write=30.0)
-        try:
-            with httpx.Client(timeout=timeout) as client:
-                with client.stream("POST", self.url, json=self.json) as response:
-                    response.raise_for_status()
-                    content = b""
-                    for chunk in response.iter_bytes():
-                        content += chunk
-                        self.bytes_downloaded += len(chunk)
-                    self.content = content
-                    self.success = True
-        except KeyboardInterrupt:
-            self.error = RuntimeError("Download cancelled")
-            _thread.interrupt_main()
-        except Exception as e:
-            self.error = e
-
-
-def project_init(
-    example: str | None = "PROMPT",  # prompt for example
-    outputdir: Path | None = None,
-    host: str | None = None,
-) -> Path:
-    """
-    Initialize a new FastLED project.
-    """
-    host = host or DEFAULT_URL
-    outputdir = Path(outputdir) if outputdir is not None else Path("fastled")
-    outputdir.mkdir(exist_ok=True, parents=True)
-    if example == "PROMPT" or example is None:
-        try:
-            example = _prompt_for_example()
-        except httpx.HTTPStatusError:
-            print(
-                f"Failed to fetch examples, using default example '{DEFAULT_EXAMPLE}'"
-            )
-            example = DEFAULT_EXAMPLE
-    assert example is not None
-    endpoint_url = f"{host}/project/init"
-    json = example
-    print(f"Initializing project with example '{example}', url={endpoint_url}")
-
-    # Start download thread
-    download_thread = DownloadThread(endpoint_url, json)
-    # spinner = Spinner("Downloading project...")
-    with Spinner(f"Downloading project {example}..."):
-        download_thread.start()
-        while download_thread.is_alive():
-            time.sleep(0.1)
-
-    print()  # New line after progress
-    download_thread.join()
-
-    # Check for errors
-    if not download_thread.success:
-        assert download_thread.error is not None
-        raise download_thread.error
-
-    content = download_thread.content
-    assert content is not None
-    tmpzip = outputdir / "fastled.zip"
-    outputdir.mkdir(exist_ok=True)
-    tmpzip.write_bytes(content)
-    with zipfile.ZipFile(tmpzip, "r") as zip_ref:
-        zip_ref.extractall(outputdir)
-    tmpzip.unlink()
-    out = outputdir / example
-    print(f"Project initialized at {out}")
-    assert out.exists()
-    return out
-
-
-def unit_test() -> None:
-    project_init()
-
-
-if __name__ == "__main__":
-    unit_test()
+import _thread
+import threading
+import time
+import zipfile
+from pathlib import Path
+
+import httpx
+
+from fastled.settings import DEFAULT_URL
+from fastled.spinner import Spinner
+
+DEFAULT_EXAMPLE = "wasm"
+
+
+def get_examples(host: str | None = None) -> list[str]:
+    host = host or DEFAULT_URL
+    url_info = f"{host}/info"
+    response = httpx.get(url_info, timeout=4)
+    response.raise_for_status()
+    examples: list[str] = response.json()["examples"]
+    return sorted(examples)
+
+
+def _prompt_for_example() -> str:
+    examples = get_examples()
+    while True:
+        print("Available examples:")
+        for i, example in enumerate(examples):
+            print(f"  [{i+1}]: {example}")
+        answer = input("Enter the example number or name: ").strip()
+        if answer.isdigit():
+            example_num = int(answer) - 1
+            if example_num < 0 or example_num >= len(examples):
+                print("Invalid example number")
+                continue
+            return examples[example_num]
+        elif answer in examples:
+            return answer
+
+
+class DownloadThread(threading.Thread):
+    def __init__(self, url: str, json: str):
+        super().__init__(daemon=True)
+        self.url = url
+        self.json = json
+        self.bytes_downloaded = 0
+        self.content: bytes | None = None
+        self.error: Exception | None = None
+        self.success = False
+
+    def run(self) -> None:
+        timeout = httpx.Timeout(5.0, connect=5.0, read=120.0, write=30.0)
+        try:
+            with httpx.Client(timeout=timeout) as client:
+                with client.stream("POST", self.url, json=self.json) as response:
+                    response.raise_for_status()
+                    content = b""
+                    for chunk in response.iter_bytes():
+                        content += chunk
+                        self.bytes_downloaded += len(chunk)
+                    self.content = content
+                    self.success = True
+        except KeyboardInterrupt:
+            self.error = RuntimeError("Download cancelled")
+            _thread.interrupt_main()
+        except Exception as e:
+            self.error = e
+
+
+def project_init(
+    example: str | None = "PROMPT",  # prompt for example
+    outputdir: Path | None = None,
+    host: str | None = None,
+) -> Path:
+    """
+    Initialize a new FastLED project.
+    """
+    host = host or DEFAULT_URL
+    outputdir = Path(outputdir) if outputdir is not None else Path("fastled")
+    outputdir.mkdir(exist_ok=True, parents=True)
+    if example == "PROMPT" or example is None:
+        try:
+            example = _prompt_for_example()
+        except httpx.HTTPStatusError:
+            print(
+                f"Failed to fetch examples, using default example '{DEFAULT_EXAMPLE}'"
+            )
+            example = DEFAULT_EXAMPLE
+    assert example is not None
+    endpoint_url = f"{host}/project/init"
+    json = example
+    print(f"Initializing project with example '{example}', url={endpoint_url}")
+
+    # Start download thread
+    download_thread = DownloadThread(endpoint_url, json)
+    # spinner = Spinner("Downloading project...")
+    with Spinner(f"Downloading project {example}..."):
+        download_thread.start()
+        while download_thread.is_alive():
+            time.sleep(0.1)
+
+    print()  # New line after progress
+    download_thread.join()
+
+    # Check for errors
+    if not download_thread.success:
+        assert download_thread.error is not None
+        raise download_thread.error
+
+    content = download_thread.content
+    assert content is not None
+    tmpzip = outputdir / "fastled.zip"
+    outputdir.mkdir(exist_ok=True)
+    tmpzip.write_bytes(content)
+    with zipfile.ZipFile(tmpzip, "r") as zip_ref:
+        zip_ref.extractall(outputdir)
+    tmpzip.unlink()
+    out = outputdir / example
+    print(f"Project initialized at {out}")
+    assert out.exists()
+    return out
+
+
+def unit_test() -> None:
+    project_init()
+
+
+if __name__ == "__main__":
+    unit_test()

fastled/server_flask.py

@@ -1,152 +1,152 @@
-import argparse
-from multiprocessing import Process
-from pathlib import Path
-
-from livereload import Server
-
-
-def _run_flask_server(
-    fastled_js: Path,
-    port: int,
-    certfile: Path | None = None,
-    keyfile: Path | None = None,
-) -> None:
-    """Run Flask server with live reload in a subprocess
-
-    Args:
-        fastled_js: Path to the fastled_js directory
-        port: Port to run the server on
-        certfile: Path to the SSL certificate file
-        keyfile: Path to the SSL key file
-    """
-    try:
-        from flask import Flask, send_from_directory
-
-        app = Flask(__name__)
-
-        # Must be a full path or flask will fail to find the file.
-        fastled_js = fastled_js.resolve()
-
-        @app.route("/")
-        def serve_index():
-            return send_from_directory(fastled_js, "index.html")
-
-        @app.route("/<path:path>")
-        def serve_files(path):
-            response = send_from_directory(fastled_js, path)
-            # Some servers don't set the Content-Type header for a bunch of files.
-            if path.endswith(".js"):
-                response.headers["Content-Type"] = "application/javascript"
-            if path.endswith(".css"):
-                response.headers["Content-Type"] = "text/css"
-            if path.endswith(".wasm"):
-                response.headers["Content-Type"] = "application/wasm"
-            if path.endswith(".json"):
-                response.headers["Content-Type"] = "application/json"
-            if path.endswith(".png"):
-                response.headers["Content-Type"] = "image/png"
-            if path.endswith(".jpg"):
-                response.headers["Content-Type"] = "image/jpeg"
-            if path.endswith(".jpeg"):
-                response.headers["Content-Type"] = "image/jpeg"
-            if path.endswith(".gif"):
-                response.headers["Content-Type"] = "image/gif"
-            if path.endswith(".svg"):
-                response.headers["Content-Type"] = "image/svg+xml"
-            if path.endswith(".ico"):
-                response.headers["Content-Type"] = "image/x-icon"
-            if path.endswith(".html"):
-                response.headers["Content-Type"] = "text/html"
-
-            # now also add headers to force no caching
-            response.headers["Cache-Control"] = "no-cache, no-store, must-revalidate"
-            response.headers["Pragma"] = "no-cache"
-            response.headers["Expires"] = "0"
-            return response
-
-        server = Server(app.wsgi_app)
-        # Watch index.html for changes
-        server.watch(str(fastled_js / "index.html"))
-        # server.watch(str(fastled_js / "index.js"))
-        # server.watch(str(fastled_js / "index.css"))
-        # Start the server
-        server.serve(port=port, debug=True)
-    except KeyboardInterrupt:
-        import _thread
-
-        _thread.interrupt_main()
-    except Exception as e:
-        print(f"Failed to run Flask server: {e}")
-        import _thread
-
-        _thread.interrupt_main()
-
-
-def run(
-    port: int, cwd: Path, certfile: Path | None = None, keyfile: Path | None = None
-) -> None:
-    """Run the Flask server."""
-    try:
-        _run_flask_server(cwd, port, certfile, keyfile)
-        import warnings
-
-        warnings.warn("Flask server has stopped")
-    except KeyboardInterrupt:
-        import _thread
-
-        _thread.interrupt_main()
-        pass
-
-
-def parse_args() -> argparse.Namespace:
-    """Parse the command line arguments."""
-    parser = argparse.ArgumentParser(
-        description="Open a browser to the fastled_js directory"
-    )
-    parser.add_argument(
-        "fastled_js", type=Path, help="Path to the fastled_js directory"
-    )
-    parser.add_argument(
-        "--port",
-        "-p",
-        type=int,
-        required=True,
-        help="Port to run the server on (default: %(default)s)",
-    )
-    parser.add_argument(
-        "--certfile",
-        type=Path,
-        help="Path to the SSL certificate file for HTTPS",
-    )
-    parser.add_argument(
-        "--keyfile",
-        type=Path,
-        help="Path to the SSL key file for HTTPS",
-    )
-    return parser.parse_args()
-
-
-def run_flask_server_process(
-    port: int,
-    cwd: Path | None = None,
-    certfile: Path | None = None,
-    keyfile: Path | None = None,
-) -> Process:
-    """Run the Flask server in a separate process."""
-    cwd = cwd or Path(".")
-    process = Process(
-        target=run,
-        args=(port, cwd, certfile, keyfile),
-    )
-    process.start()
-    return process
-
-
-def main() -> None:
-    """Main function."""
-    args = parse_args()
-    run(args.port, args.fastled_js, args.certfile, args.keyfile)
-
-
-if __name__ == "__main__":
-    main()
+import argparse
+from multiprocessing import Process
+from pathlib import Path
+
+from livereload import Server
+
+
+def _run_flask_server(
+    fastled_js: Path,
+    port: int,
+    certfile: Path | None = None,
+    keyfile: Path | None = None,
+) -> None:
+    """Run Flask server with live reload in a subprocess
+
+    Args:
+        fastled_js: Path to the fastled_js directory
+        port: Port to run the server on
+        certfile: Path to the SSL certificate file
+        keyfile: Path to the SSL key file
+    """
+    try:
+        from flask import Flask, send_from_directory
+
+        app = Flask(__name__)
+
+        # Must be a full path or flask will fail to find the file.
+        fastled_js = fastled_js.resolve()
+
+        @app.route("/")
+        def serve_index():
+            return send_from_directory(fastled_js, "index.html")
+
+        @app.route("/<path:path>")
+        def serve_files(path):
+            response = send_from_directory(fastled_js, path)
+            # Some servers don't set the Content-Type header for a bunch of files.
+            if path.endswith(".js"):
+                response.headers["Content-Type"] = "application/javascript"
+            if path.endswith(".css"):
+                response.headers["Content-Type"] = "text/css"
+            if path.endswith(".wasm"):
+                response.headers["Content-Type"] = "application/wasm"
+            if path.endswith(".json"):
+                response.headers["Content-Type"] = "application/json"
+            if path.endswith(".png"):
+                response.headers["Content-Type"] = "image/png"
+            if path.endswith(".jpg"):
+                response.headers["Content-Type"] = "image/jpeg"
+            if path.endswith(".jpeg"):
+                response.headers["Content-Type"] = "image/jpeg"
+            if path.endswith(".gif"):
+                response.headers["Content-Type"] = "image/gif"
+            if path.endswith(".svg"):
+                response.headers["Content-Type"] = "image/svg+xml"
+            if path.endswith(".ico"):
+                response.headers["Content-Type"] = "image/x-icon"
+            if path.endswith(".html"):
+                response.headers["Content-Type"] = "text/html"
+
+            # now also add headers to force no caching
+            response.headers["Cache-Control"] = "no-cache, no-store, must-revalidate"
+            response.headers["Pragma"] = "no-cache"
+            response.headers["Expires"] = "0"
+            return response
+
+        server = Server(app.wsgi_app)
+        # Watch index.html for changes
+        server.watch(str(fastled_js / "index.html"))
+        # server.watch(str(fastled_js / "index.js"))
+        # server.watch(str(fastled_js / "index.css"))
+        # Start the server
+        server.serve(port=port, debug=True)
+    except KeyboardInterrupt:
+        import _thread
+
+        _thread.interrupt_main()
+    except Exception as e:
+        print(f"Failed to run Flask server: {e}")
+        import _thread
+
+        _thread.interrupt_main()
+
+
+def run(
+    port: int, cwd: Path, certfile: Path | None = None, keyfile: Path | None = None
+) -> None:
+    """Run the Flask server."""
+    try:
+        _run_flask_server(cwd, port, certfile, keyfile)
+        import warnings
+
+        warnings.warn("Flask server has stopped")
+    except KeyboardInterrupt:
+        import _thread
+
+        _thread.interrupt_main()
+        pass
+
+
+def parse_args() -> argparse.Namespace:
+    """Parse the command line arguments."""
+    parser = argparse.ArgumentParser(
+        description="Open a browser to the fastled_js directory"
+    )
+    parser.add_argument(
+        "fastled_js", type=Path, help="Path to the fastled_js directory"
+    )
+    parser.add_argument(
+        "--port",
+        "-p",
+        type=int,
+        required=True,
+        help="Port to run the server on (default: %(default)s)",
+    )
+    parser.add_argument(
+        "--certfile",
+        type=Path,
+        help="Path to the SSL certificate file for HTTPS",
+    )
+    parser.add_argument(
+        "--keyfile",
+        type=Path,
+        help="Path to the SSL key file for HTTPS",
+    )
+    return parser.parse_args()
+
+
+def run_flask_server_process(
+    port: int,
+    cwd: Path | None = None,
+    certfile: Path | None = None,
+    keyfile: Path | None = None,
+) -> Process:
+    """Run the Flask server in a separate process."""
+    cwd = cwd or Path(".")
+    process = Process(
+        target=run,
+        args=(port, cwd, certfile, keyfile),
+    )
+    process.start()
+    return process
+
+
+def main() -> None:
+    """Main function."""
+    args = parse_args()
+    run(args.port, args.fastled_js, args.certfile, args.keyfile)
+
+
+if __name__ == "__main__":
+    main()