2. add morebuiltins.funcs.debounce decorator to debounce function calls.

Author: ClericPy

CHANGELOG.md

@@ -2,7 +2,7 @@
 
 ### 1.3.5 (2025-10-15)
 1. fix writer.wait_closed() ConnectionResetError in ipc.py, proxy_checker.py, log_server.py
-2. 
+2. add `morebuiltins.funcs.debounce` decorator to debounce function calls.
 
 ### 1.3.4 (2025-10-15)
 1. fix `morebuiltins.utils.gen_id` wrong length issue.

README.md

@@ -178,6 +178,8 @@ print(morebuiltins.__file__)
 
 3.12 `check_recursion` - Check if a function is recursive by inspecting its AST.
 
+3.13 `debounce` - Debounce a function, delaying its execution until after a specified wait time.
+
 
 ## 4. morebuiltins.ipc
 

doc.md

@@ -1796,6 +1796,34 @@ Demo::
 ---
 
 
+
+3.13 `debounce` - Debounce a function, delaying its execution until after a specified wait time.
+
+
+```python
+
+Args:
+    wait (float): The amount of time to wait before executing the function.
+
+Demo::
+
+    >>> @debounce(0.1)
+    ... def test():
+    ...     print("Function executed")
+    >>> test()
+    Function executed
+    >>> test()
+    >>> time.sleep(0.1)
+    >>> test()
+    Function executed
+    >>> test()
+
+```
+
+
+---
+
+
 ## 4. morebuiltins.ipc
 
 

morebuiltins/cmd/log_server.py

@@ -115,6 +115,18 @@ def from_dict(cls, **kwargs):
         kwargs = {k: v for k, v in kwargs.items() if k in cls.__annotations__}
         return cls(**kwargs)
 
+    @staticmethod
+    def level_to_name(level: int):
+        levelToName = {
+            logging.CRITICAL: "CRITICAL",
+            logging.ERROR: "ERROR",
+            logging.WARNING: "WARNING",
+            logging.INFO: "INFO",
+            logging.DEBUG: "DEBUG",
+            logging.NOTSET: "NOTSET",
+        }
+        return levelToName.get(level, f"Level {level}")
+
     def to_dict_with_meta(self) -> dict:
         meta: dict = {
             "create_time": self.create_time,
@@ -125,9 +137,7 @@ def to_dict_with_meta(self) -> dict:
         # base64 formatter
         meta["formatter"] = self.pickle_to_base64(self.formatter)
         # int to str
-        meta["level_specs"] = [
-            logging.getLevelName(level) for level in self.level_specs
-        ]
+        meta["level_specs"] = [self.level_to_name(level) for level in self.level_specs]
         return meta
 
     def __eq__(self, other):
@@ -392,7 +402,7 @@ def send_log(
             "args": (),
             "msg": msg,
             "levelno": level,
-            "levelname": logging.getLevelName(level),
+            "levelname": LogSetting.level_to_name(level),
             "exc_info": {},
         }
         if init_setting:
@@ -565,7 +575,9 @@ def write_queue_consumer(self):
                     if setting.level_specs:
                         for levelno in setting.level_specs:
                             levelname = (
-                                logging.getLevelName(levelno).lower().replace(" ", "-")
+                                LogSetting.level_to_name(levelno)
+                                .lower()
+                                .replace(" ", "-")
                             )
                             alias_name = f"{name}_{levelname}"
                             targets.extend(
@@ -903,7 +915,7 @@ def sync_test():
 
 
 def entrypoint():
-    # return sync_test()
+    return sync_test()
     return asyncio.run(main())
 
 

morebuiltins/funcs.py

@@ -22,7 +22,6 @@
     Optional,
     OrderedDict,
     Set,
-    Tuple,
     Union,
 )
 from weakref import WeakSet
@@ -40,6 +39,7 @@
     "get_function",
     "to_thread",
     "check_recursion",
+    "debounce",
 ]
 
 
@@ -893,32 +893,32 @@ def calculate_and_print_stats(self, func_name: str):
 def line_profiler(func: Callable) -> Callable:
     """Decorator to profile a function line-by-line.
 
-    Demo usage:
-        >>> import sys, io
-        >>> LineProfiler.stdout = io.StringIO()  # Redirect stdout to capture print output
-        >>> @line_profiler
-        ... def example_function():
-        ...     result = 0
-        ...     for i in range(10):
-        ...         result += i  # Simulate some work
-        ...     return result
-        >>> example_function()
-        45
-        >>> output = LineProfiler.stdout.getvalue()
-        >>> output.splitlines()[0].startswith("=" * 95) and "`example_function` profiling report:" in output
-        True
-        >>> LineProfiler.stdout = sys.stdout  # Restore original stdout
-
-===============================================================================================
-`example_function` profiling report:
-Start at 2025-07-26 17:09:58 | Total: 1.122 ms
-===============================================================================================
-  Line    %    Total(ms)    Count      Avg(ms)  Source Code
------------------------------------------------------------------------------------------------
-     3   73        0.825        1        0.825  -
-     4    3        0.040       11        0.004  -
-     5    4        0.050       10        0.005  -
-===============================================================================================
+        Demo usage:
+            >>> import sys, io
+            >>> LineProfiler.stdout = io.StringIO()  # Redirect stdout to capture print output
+            >>> @line_profiler
+            ... def example_function():
+            ...     result = 0
+            ...     for i in range(10):
+            ...         result += i  # Simulate some work
+            ...     return result
+            >>> example_function()
+            45
+            >>> output = LineProfiler.stdout.getvalue()
+            >>> output.splitlines()[0].startswith("=" * 95) and "`example_function` profiling report:" in output
+            True
+            >>> LineProfiler.stdout = sys.stdout  # Restore original stdout
+
+    ===============================================================================================
+    `example_function` profiling report:
+    Start at 2025-07-26 17:09:58 | Total: 1.122 ms
+    ===============================================================================================
+      Line    %    Total(ms)    Count      Avg(ms)  Source Code
+    -----------------------------------------------------------------------------------------------
+         3   73        0.825        1        0.825  -
+         4    3        0.040       11        0.004  -
+         5    4        0.050       10        0.005  -
+    ===============================================================================================
     """
 
     @wraps(func)
@@ -946,6 +946,52 @@ def wrapper(*args, **kwargs):
     return wrapper
 
 
+def debounce(wait: float):
+    """Debounce a function, delaying its execution until after a specified wait time.
+
+    Args:
+        wait (float): The amount of time to wait before executing the function.
+
+    Demo::
+
+        >>> @debounce(0.1)
+        ... def test():
+        ...     print("Function executed")
+        >>> test()
+        Function executed
+        >>> test()
+        >>> time.sleep(0.1)
+        >>> test()
+        Function executed
+        >>> test()
+    """
+    def decorator(fn):
+        last_call = 0
+
+        async def async_wrapper(*args, **kwargs):
+            nonlocal last_call
+            current_time = time.time()
+            if current_time - last_call < wait:
+                return
+            last_call = current_time
+            return await fn(*args, **kwargs)
+
+        def sync_wrapper(*args, **kwargs):
+            nonlocal last_call
+            current_time = time.time()
+            if current_time - last_call < wait:
+                return
+            last_call = current_time
+            return fn(*args, **kwargs)
+
+        if asyncio.iscoroutinefunction(fn):
+            return async_wrapper
+        else:
+            return sync_wrapper
+
+    return decorator
+
+
 def test_bg_task():
     async def _test_bg_task():
         async def coro():