fastled 1.2.54__py3-none-any.whl → 1.2.55__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.54"
+__version__ = "1.2.55"
 
 DOCKER_FILE = (
     "https://raw.githubusercontent.com/zackees/fastled-wasm/refs/heads/main/Dockerfile"

fastled/client_server.py

@@ -7,7 +7,7 @@ from pathlib import Path
 
 from fastled.compile_server import CompileServer
 from fastled.docker_manager import DockerManager
-from fastled.filewatcher import FileWatcherProcess
+from fastled.filewatcher import DebouncedFileWatcherProcess, FileWatcherProcess
 from fastled.keyboard import SpaceBarWatcher
 from fastled.open_browser import open_browser_process
 from fastled.parse_args import Args
@@ -231,9 +231,8 @@ def run_client(
         return 1
 
     excluded_patterns = ["fastled_js"]
-
-    sketch_filewatcher = FileWatcherProcess(
-        directory, excluded_patterns=excluded_patterns
+    debounced_sketch_watcher = DebouncedFileWatcherProcess(
+        FileWatcherProcess(directory, excluded_patterns=excluded_patterns),
     )
 
     source_code_watcher: FileWatcherProcess | None = None
@@ -246,7 +245,7 @@ def run_client(
     def trigger_rebuild_if_sketch_changed(
         last_compiled_result: CompileResult,
     ) -> tuple[bool, CompileResult]:
-        changed_files = sketch_filewatcher.get_all_changes()
+        changed_files = debounced_sketch_watcher.get_all_changes()
         if changed_files:
             print(f"\nChanges detected in {changed_files}")
             last_hash_value = last_compiled_result.hash_value
@@ -301,7 +300,9 @@ def run_client(
                             timeout=1.0
                         )
                         file_changes = source_code_watcher.get_all_changes()
-                        sketch_files_changed = sketch_filewatcher.get_all_changes()
+                        sketch_files_changed = (
+                            debounced_sketch_watcher.get_all_changes()
+                        )
 
                         if file_changes:
                             print(
@@ -331,7 +332,7 @@ def run_client(
         print(f"Error: {e}")
         return 1
     finally:
-        sketch_filewatcher.stop()
+        debounced_sketch_watcher.stop()
         if compile_server:
             compile_server.stop()
         if browser_proc:

fastled/filewatcher.py

@@ -208,6 +208,7 @@ class FileWatcherProcess:
             daemon=True,
         )
         self.process.start()
+        self.global_debounce = FILE_CHANGED_DEBOUNCE_SECONDS
 
     def stop(self):
         self.process.terminate()
@@ -226,3 +227,72 @@ class FileWatcherProcess:
             except Empty:
                 break
         return changed_files
+
+
+# DEBOUNCE_SECONDS = 4
+# LAST_TIME = 0.0
+# WATCHED_FILES: list[str] = []
+
+# def debounced_sketch_filewatcher_get_all_changes() -> list[str]:
+#     nonlocal DEBOUNCE_SECONDS
+#     nonlocal LAST_TIME
+#     nonlocal WATCHED_FILES
+#     current_time = time.time()
+#     new_files = sketch_filewatcher.get_all_changes()
+#     if new_files:
+#         WATCHED_FILES.extend(new_files)
+#         print(f"Changes detected in {new_files}")
+#         LAST_TIME = current_time
+#         return []
+#     diff = current_time - LAST_TIME
+#     if diff > DEBOUNCE_SECONDS and len(WATCHED_FILES) > 0:
+#         LAST_TIME = current_time
+#         WATCHED_FILES, changed_files = [], WATCHED_FILES
+#         changed_files = sorted(list(set(changed_files)))
+#         return changed_files
+#     return []
+
+
+class DebouncedFileWatcherProcess:
+    """
+    Wraps a FileWatcherProcess to batch rapid-fire change events
+    and only emit them once the debounce interval has passed.
+    """
+
+    def __init__(
+        self,
+        watcher: FileWatcherProcess,
+        debounce_seconds: float = FILE_CHANGED_DEBOUNCE_SECONDS,
+    ) -> None:
+        self.watcher = watcher
+        self.debounce_seconds = debounce_seconds
+        self._last_time = 0.0
+        self._watched_files: list[str] = []
+
+    def get_all_changes(self, timeout: float | None = None) -> list[str]:
+        """
+        Polls the underlying watcher for raw events, accumulates them,
+        and once no new events arrive for `debounce_seconds`, flushes
+        a sorted, unique list of paths.
+        """
+        now = time.time()
+        # pull in any new raw events
+        new = self.watcher.get_all_changes(timeout=timeout)
+        if new:
+            self._watched_files.extend(new)
+            # reset the window
+            self._last_time = now
+            return []
+
+        # if the window has elapsed, flush
+        if self._watched_files and (now - self._last_time) > self.debounce_seconds:
+            batch = sorted(set(self._watched_files))
+            self._watched_files.clear()
+            self._last_time = now
+            return batch
+
+        return []
+
+    def stop(self) -> None:
+        """Tear down the underlying watcher process."""
+        self.watcher.stop()

{fastled-1.2.54.dist-info → fastled-1.2.55.dist-info}/METADATA

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

{fastled-1.2.54.dist-info → fastled-1.2.55.dist-info}/RECORD

@@ -1,12 +1,12 @@
-fastled/__init__.py,sha256=1tn764qvEIfcjOPi4adfxROxoe-vfxz8R8RB3jyxC78,6734
+fastled/__init__.py,sha256=6kRImRI2Oc4dHucIY5jBajNGE5d3zpUrExS-ZTRUcow,6734
 fastled/app.py,sha256=Ozn7OJ0rz3CEHsJKMhFLxV7TisRKo4DuFpVhrf5FQNw,3944
 fastled/cli.py,sha256=FjVr31ht0UPlAcmX-84NwfAGMQHTkrCe4o744jCAxiw,375
 fastled/cli_test.py,sha256=qJB9yLRFR3OwOwdIWSQ0fQsWLnA37v5pDccufiP_hTs,512
-fastled/client_server.py,sha256=JSp2vNjkdvKnMrs-_ic4Qutw61uH1aa6pgXrVQ9BpM4,14792
+fastled/client_server.py,sha256=Pr_b_406XpB6QLrlRMV3mwM82x25s1bIGFU0O0XA3yk,14931
 fastled/compile_server.py,sha256=ul3eiZNX2wwmInooo3PJC3_kNpdejYVDIo94G3sV9HQ,2941
 fastled/compile_server_impl.py,sha256=xhC7WBlIfvghgpxAP8VwBeM13NuTA99cI47prODW-IU,9927
 fastled/docker_manager.py,sha256=VVyfl4HNsSB95nlENuccZFR0qL3Y0ZJgPCFyHKa9A14,31459
-fastled/filewatcher.py,sha256=h7GKpJbXSd9XaCXmdqJ5cl_EWoAC7IBmJxlYswSm3cs,7534
+fastled/filewatcher.py,sha256=40XZ2euBg5ZMHsjv8obxHApVAUE5ztUEd7FTGqtgsMc,9826
 fastled/interactive_srcs.py,sha256=F5nHdJc60xsnmOtnKhngE9JytqGn56PmYw_MVSIX1ac,138
 fastled/keyboard.py,sha256=UTAsqCn1UMYnB8YDzENiLTj4GeL45tYfEcO7_5fLFEg,3556
 fastled/live_client.py,sha256=MDauol0mxtXggV1Pv9ahC0Jjg_4wnnV6FjGEtdd9cxU,2763
@@ -28,9 +28,9 @@ fastled/site/build.py,sha256=pjsaeHQQh_Zdh1g5Q78lYlUT7UPDFuNgW5YZkpsPxWc,14436
 fastled/site/examples.py,sha256=s6vj2zJc6BfKlnbwXr1QWY1mzuDBMt6j5MEBOWjO_U8,155
 fastled/test/can_run_local_docker_tests.py,sha256=LEuUbHctRhNNFWcvnz2kEGmjDJeXO4c3kNpizm3yVJs,400
 fastled/test/examples.py,sha256=GfaHeY1E8izBl6ZqDVjz--RHLyVR4NRnQ5pBesCFJFY,1673
-fastled-1.2.54.dist-info/licenses/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
-fastled-1.2.54.dist-info/METADATA,sha256=O_S9Qgxlm_1ePE727EuyUmmUB0GzrvaIP4etAtHcjgY,21668
-fastled-1.2.54.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-fastled-1.2.54.dist-info/entry_points.txt,sha256=RCwmzCSOS4-C2i9EziANq7Z2Zb4KFnEMR1FQC0bBwAw,101
-fastled-1.2.54.dist-info/top_level.txt,sha256=Bbv5kpJpZhWNCvDF4K0VcvtBSDMa8B7PTOrZa9CezHY,8
-fastled-1.2.54.dist-info/RECORD,,
+fastled-1.2.55.dist-info/licenses/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
+fastled-1.2.55.dist-info/METADATA,sha256=fLJj2AsQnGgflwpxrBCI-Ktt047LhKacc_1mc2Kr0sU,21668
+fastled-1.2.55.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+fastled-1.2.55.dist-info/entry_points.txt,sha256=RCwmzCSOS4-C2i9EziANq7Z2Zb4KFnEMR1FQC0bBwAw,101
+fastled-1.2.55.dist-info/top_level.txt,sha256=Bbv5kpJpZhWNCvDF4K0VcvtBSDMa8B7PTOrZa9CezHY,8
+fastled-1.2.55.dist-info/RECORD,,