philiprehberger-debounce 0.1.0

Debounce and throttle decorators for Python functions.

philiprehberger-debounce

Debounce and throttle decorators for Python functions.

Install

pip install philiprehberger-debounce

Usage

from philiprehberger_debounce import debounce, throttle

Debounce

Delay execution until a quiet period has passed. Each new call resets the timer.

@debounce(0.5)
def on_resize(width, height):
    print(f"Resized to {width}x{height}")

on_resize(800, 600)
on_resize(1024, 768)  # cancels the previous call
# Only the last call executes after 0.5s

Throttle

Limit a function to a fixed number of calls within a time window. Excess calls are silently dropped.

@throttle(calls=3, per=1.0)
def send_request(data):
    print(f"Sending {data}")

for i in range(10):
    send_request(i)  # only the first 3 calls within 1s execute

API

Decorator	Description
debounce(seconds)	Delays execution until seconds have elapsed since the last call. Cancels any pending invocation on each new call.
throttle(calls, per)	Limits the function to calls invocations per per seconds. Uses a sliding window.

License

MIT