fastled 1.2.96__py3-none-any.whl → 1.2.97__py3-none-any.whl

fastled/open_browser.py

@@ -1,137 +1,137 @@
-import atexit
-import random
-import sys
-import time
-import weakref
-from multiprocessing import Process
-from pathlib import Path
-
-from fastled.server_flask import run_flask_in_thread
-
-DEFAULT_PORT = 8089  # different than live version.
-PYTHON_EXE = sys.executable
-
-# Use a weak reference set to track processes without preventing garbage collection
-_WEAK_CLEANUP_SET = weakref.WeakSet()
-
-
-def add_cleanup(proc: Process) -> None:
-    """Add a process to the cleanup list using weak references"""
-    _WEAK_CLEANUP_SET.add(proc)
-
-    # Register a cleanup function that checks if the process is still alive
-    def cleanup_if_alive():
-        if proc.is_alive():
-            try:
-                proc.terminate()
-                proc.join(timeout=1.0)
-                if proc.is_alive():
-                    proc.kill()
-            except Exception:
-                pass
-
-    atexit.register(cleanup_if_alive)
-
-
-def is_port_free(port: int) -> bool:
-    """Check if a port is free"""
-    import httpx
-
-    try:
-        response = httpx.get(f"http://localhost:{port}", timeout=1)
-        response.raise_for_status()
-        return False
-    except (httpx.HTTPError, httpx.ConnectError):
-        return True
-
-
-def find_free_port(start_port: int) -> int:
-    """Find a free port starting at start_port"""
-    for port in range(start_port, start_port + 100, 2):
-        if is_port_free(port):
-            print(f"Found free port: {port}")
-            return port
-        else:
-            print(f"Port {port} is in use, finding next")
-    raise ValueError("Could not find a free port")
-
-
-def wait_for_server(port: int, timeout: int = 10) -> None:
-    """Wait for the server to start."""
-    from httpx import get
-
-    future_time = time.time() + timeout
-    while future_time > time.time():
-        try:
-            url = f"http://localhost:{port}"
-            # print(f"Waiting for server to start at {url}")
-            response = get(url, timeout=1)
-            if response.status_code == 200:
-                return
-        except Exception:
-            continue
-    raise TimeoutError("Could not connect to server")
-
-
-def spawn_http_server(
-    fastled_js: Path,
-    compile_server_port: int,
-    port: int | None = None,
-    open_browser: bool = True,
-) -> Process:
-
-    if port is not None and not is_port_free(port):
-        raise ValueError(f"Port {port} was specified but in use")
-    if port is None:
-        offset = random.randint(0, 100)
-        port = find_free_port(DEFAULT_PORT + offset)
-
-    # port: int,
-    # cwd: Path,
-    # compile_server_port: int,
-    # certfile: Path | None = None,
-    # keyfile: Path | None = None,
-
-    proc = Process(
-        target=run_flask_in_thread,
-        args=(port, fastled_js, compile_server_port),
-        daemon=True,
-    )
-    add_cleanup(proc)
-    proc.start()
-
-    # Add to cleanup set with weak reference
-    add_cleanup(proc)
-
-    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,
-        )
-    return proc
-
-
-if __name__ == "__main__":
-    import argparse
-
-    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",
-        type=int,
-        default=DEFAULT_PORT,
-        help=f"Port to run the server on (default: {DEFAULT_PORT})",
-    )
-    args = parser.parse_args()
-
-    proc = spawn_http_server(args.fastled_js, args.port, open_browser=True)
-    proc.join()
+import atexit
+import random
+import sys
+import time
+import weakref
+from multiprocessing import Process
+from pathlib import Path
+
+from fastled.server_flask import run_flask_in_thread
+
+DEFAULT_PORT = 8089  # different than live version.
+PYTHON_EXE = sys.executable
+
+# Use a weak reference set to track processes without preventing garbage collection
+_WEAK_CLEANUP_SET = weakref.WeakSet()
+
+
+def add_cleanup(proc: Process) -> None:
+    """Add a process to the cleanup list using weak references"""
+    _WEAK_CLEANUP_SET.add(proc)
+
+    # Register a cleanup function that checks if the process is still alive
+    def cleanup_if_alive():
+        if proc.is_alive():
+            try:
+                proc.terminate()
+                proc.join(timeout=1.0)
+                if proc.is_alive():
+                    proc.kill()
+            except Exception:
+                pass
+
+    atexit.register(cleanup_if_alive)
+
+
+def is_port_free(port: int) -> bool:
+    """Check if a port is free"""
+    import httpx
+
+    try:
+        response = httpx.get(f"http://localhost:{port}", timeout=1)
+        response.raise_for_status()
+        return False
+    except (httpx.HTTPError, httpx.ConnectError):
+        return True
+
+
+def find_free_port(start_port: int) -> int:
+    """Find a free port starting at start_port"""
+    for port in range(start_port, start_port + 100, 2):
+        if is_port_free(port):
+            print(f"Found free port: {port}")
+            return port
+        else:
+            print(f"Port {port} is in use, finding next")
+    raise ValueError("Could not find a free port")
+
+
+def wait_for_server(port: int, timeout: int = 10) -> None:
+    """Wait for the server to start."""
+    from httpx import get
+
+    future_time = time.time() + timeout
+    while future_time > time.time():
+        try:
+            url = f"http://localhost:{port}"
+            # print(f"Waiting for server to start at {url}")
+            response = get(url, timeout=1)
+            if response.status_code == 200:
+                return
+        except Exception:
+            continue
+    raise TimeoutError("Could not connect to server")
+
+
+def spawn_http_server(
+    fastled_js: Path,
+    compile_server_port: int,
+    port: int | None = None,
+    open_browser: bool = True,
+) -> Process:
+
+    if port is not None and not is_port_free(port):
+        raise ValueError(f"Port {port} was specified but in use")
+    if port is None:
+        offset = random.randint(0, 100)
+        port = find_free_port(DEFAULT_PORT + offset)
+
+    # port: int,
+    # cwd: Path,
+    # compile_server_port: int,
+    # certfile: Path | None = None,
+    # keyfile: Path | None = None,
+
+    proc = Process(
+        target=run_flask_in_thread,
+        args=(port, fastled_js, compile_server_port),
+        daemon=True,
+    )
+    add_cleanup(proc)
+    proc.start()
+
+    # Add to cleanup set with weak reference
+    add_cleanup(proc)
+
+    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,
+        )
+    return proc
+
+
+if __name__ == "__main__":
+    import argparse
+
+    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",
+        type=int,
+        default=DEFAULT_PORT,
+        help=f"Port to run the server on (default: {DEFAULT_PORT})",
+    )
+    args = parser.parse_args()
+
+    proc = spawn_http_server(args.fastled_js, args.port, open_browser=True)
+    proc.join()

fastled/print_filter.py

@@ -1,190 +1,190 @@
-import re
-import zlib
-from abc import ABC, abstractmethod
-from dataclasses import dataclass
-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
-
-
-def _handle_fastled_src(line: str) -> str:
-    return line.replace("fastled/src", "src")
-
-
-class PrintFilterDefault(PrintFilter):
-    """Provides default filtering for FastLED output."""
-
-    def filter(self, text: str) -> str:
-        return text
-
-
-class PrintFilterFastled(PrintFilter):
-    """Provides filtering for FastLED output so that source files match up with local names."""
-
-    def __init__(self, echo: bool = True) -> None:
-        super().__init__(echo)
-        self.build_started = False
-        # self.compile_link_active = False
-        # self.compile_link_filter:
-
-    def filter(self, text: str) -> str:
-        lines = text.splitlines()
-        out: list[str] = []
-        for line in lines:
-            ## DEBUG DO NOT SUBMIT
-            # print(line)
-            if "# WASM is building" in line:
-                self.build_started = True
-            line = _handle_fastled_src(
-                line
-            )  # Always convert fastled/src to src for file matchups.
-            if self.build_started or " error: " in line:
-                line = _handle_ino_cpp(line)
-            out.append(line)
-        text = "\n".join(out)
-        return text
-
-
-class CompileOrLink(Enum):
-    COMPILE = "compile"
-    LINK = "link"
-
-
-@dataclass
-class BuildArtifact:
-    timestamp: float
-    input_artifact: str | None
-    output_artifact: str | None
-    build_flags: str
-    compile_or_link: CompileOrLink
-    hash: int
-
-    def __str__(self) -> str:
-        return f"{self.timestamp} {self.output_artifact} {self.build_flags} {self.compile_or_link} {self.hash}"
-
-    @staticmethod
-    def parse(input_str: str) -> "BuildArtifact | None":
-        """
-        Parse a single build-log line of the form:
-          "<timestamp> ... <some .cpp or .h file> ... <flags>"
-
-        Returns a BuildArtifact, or None if parsing failed.
-        """
-        return _parse(input_str)
-
-
-class TokenFilter(ABC):
-    @abstractmethod
-    def extract(self, tokens: list[str]) -> str | None:
-        """
-        Scan `tokens`, remove any tokens this filter is responsible for,
-        and return the extracted string (or None if not found/invalid).
-        """
-        ...
-
-
-class TimestampFilter(TokenFilter):
-    def extract(self, tokens: list[str]) -> str | None:
-        if not tokens:
-            return None
-        candidate = tokens[0]
-        try:
-            _ = float(candidate)
-            return tokens.pop(0)
-        except ValueError:
-            return None
-
-
-class InputArtifactFilter(TokenFilter):
-    def extract(self, tokens: list[str]) -> str | None:
-        for i, tok in enumerate(tokens):
-            if tok.endswith(".cpp") or tok.endswith(".h"):
-                return tokens.pop(i)
-        return None
-
-
-class OutputArtifactFilter(TokenFilter):
-    def extract(self, tokens: list[str]) -> str | None:
-        for i, tok in enumerate(tokens):
-            if tok == "-o" and i + 1 < len(tokens):
-                tokens.pop(i)  # drop '-o'
-                return tokens.pop(i)  # drop & return artifact
-        return None
-
-
-class ActionFilter(TokenFilter):
-    def extract(self, tokens: list[str]) -> str | None:
-        if "-c" in tokens:
-            return CompileOrLink.COMPILE.value
-        return CompileOrLink.LINK.value
-
-
-def _parse(line: str) -> BuildArtifact | None:
-    tokens = line.strip().split()
-    if not tokens:
-        return None
-
-    # instantiate in the order we need them
-    filters: list[TokenFilter] = [
-        TimestampFilter(),
-        InputArtifactFilter(),
-        OutputArtifactFilter(),
-        ActionFilter(),
-    ]
-
-    # apply each filter
-    raw_ts = filters[0].extract(tokens)
-    raw_in = filters[1].extract(tokens)
-    raw_out = filters[2].extract(tokens)
-    raw_act = filters[3].extract(tokens)
-
-    if raw_ts is None or raw_in is None or raw_act is None:
-        return None
-
-    # the rest of `tokens` are the flags
-    flags_str = " ".join(tokens)
-    h = zlib.adler32(flags_str.encode("utf-8"))
-
-    return BuildArtifact(
-        timestamp=float(raw_ts),
-        input_artifact=raw_in,
-        output_artifact=raw_out,
-        build_flags=flags_str,
-        compile_or_link=CompileOrLink(raw_act),
-        hash=h,
-    )
+import re
+import zlib
+from abc import ABC, abstractmethod
+from dataclasses import dataclass
+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
+
+
+def _handle_fastled_src(line: str) -> str:
+    return line.replace("fastled/src", "src")
+
+
+class PrintFilterDefault(PrintFilter):
+    """Provides default filtering for FastLED output."""
+
+    def filter(self, text: str) -> str:
+        return text
+
+
+class PrintFilterFastled(PrintFilter):
+    """Provides filtering for FastLED output so that source files match up with local names."""
+
+    def __init__(self, echo: bool = True) -> None:
+        super().__init__(echo)
+        self.build_started = False
+        # self.compile_link_active = False
+        # self.compile_link_filter:
+
+    def filter(self, text: str) -> str:
+        lines = text.splitlines()
+        out: list[str] = []
+        for line in lines:
+            ## DEBUG DO NOT SUBMIT
+            # print(line)
+            if "# WASM is building" in line:
+                self.build_started = True
+            line = _handle_fastled_src(
+                line
+            )  # Always convert fastled/src to src for file matchups.
+            if self.build_started or " error: " in line:
+                line = _handle_ino_cpp(line)
+            out.append(line)
+        text = "\n".join(out)
+        return text
+
+
+class CompileOrLink(Enum):
+    COMPILE = "compile"
+    LINK = "link"
+
+
+@dataclass
+class BuildArtifact:
+    timestamp: float
+    input_artifact: str | None
+    output_artifact: str | None
+    build_flags: str
+    compile_or_link: CompileOrLink
+    hash: int
+
+    def __str__(self) -> str:
+        return f"{self.timestamp} {self.output_artifact} {self.build_flags} {self.compile_or_link} {self.hash}"
+
+    @staticmethod
+    def parse(input_str: str) -> "BuildArtifact | None":
+        """
+        Parse a single build-log line of the form:
+          "<timestamp> ... <some .cpp or .h file> ... <flags>"
+
+        Returns a BuildArtifact, or None if parsing failed.
+        """
+        return _parse(input_str)
+
+
+class TokenFilter(ABC):
+    @abstractmethod
+    def extract(self, tokens: list[str]) -> str | None:
+        """
+        Scan `tokens`, remove any tokens this filter is responsible for,
+        and return the extracted string (or None if not found/invalid).
+        """
+        ...
+
+
+class TimestampFilter(TokenFilter):
+    def extract(self, tokens: list[str]) -> str | None:
+        if not tokens:
+            return None
+        candidate = tokens[0]
+        try:
+            _ = float(candidate)
+            return tokens.pop(0)
+        except ValueError:
+            return None
+
+
+class InputArtifactFilter(TokenFilter):
+    def extract(self, tokens: list[str]) -> str | None:
+        for i, tok in enumerate(tokens):
+            if tok.endswith(".cpp") or tok.endswith(".h"):
+                return tokens.pop(i)
+        return None
+
+
+class OutputArtifactFilter(TokenFilter):
+    def extract(self, tokens: list[str]) -> str | None:
+        for i, tok in enumerate(tokens):
+            if tok == "-o" and i + 1 < len(tokens):
+                tokens.pop(i)  # drop '-o'
+                return tokens.pop(i)  # drop & return artifact
+        return None
+
+
+class ActionFilter(TokenFilter):
+    def extract(self, tokens: list[str]) -> str | None:
+        if "-c" in tokens:
+            return CompileOrLink.COMPILE.value
+        return CompileOrLink.LINK.value
+
+
+def _parse(line: str) -> BuildArtifact | None:
+    tokens = line.strip().split()
+    if not tokens:
+        return None
+
+    # instantiate in the order we need them
+    filters: list[TokenFilter] = [
+        TimestampFilter(),
+        InputArtifactFilter(),
+        OutputArtifactFilter(),
+        ActionFilter(),
+    ]
+
+    # apply each filter
+    raw_ts = filters[0].extract(tokens)
+    raw_in = filters[1].extract(tokens)
+    raw_out = filters[2].extract(tokens)
+    raw_act = filters[3].extract(tokens)
+
+    if raw_ts is None or raw_in is None or raw_act is None:
+        return None
+
+    # the rest of `tokens` are the flags
+    flags_str = " ".join(tokens)
+    h = zlib.adler32(flags_str.encode("utf-8"))
+
+    return BuildArtifact(
+        timestamp=float(raw_ts),
+        input_artifact=raw_in,
+        output_artifact=raw_out,
+        build_flags=flags_str,
+        compile_or_link=CompileOrLink(raw_act),
+        hash=h,
+    )