Rate Limiter Decorator for CLI Tools

import time, functools, threading

def rate_limit(calls: int, period: float = 1.0):
    lock = threading.Lock()
    times: list[float] = []

    def decorator(fn):
        @functools.wraps(fn)
        def wrapper(*args, **kwargs):
            with lock:
                now = time.time()
                times[:] = [t for t in times if now - t < period]
                if len(times) >= calls:
                    time.sleep(period - (now - times[0]))
                times.append(time.time())
            return fn(*args, **kwargs)
        return wrapper
    return decorator

@rate_limit(calls=5, period=1.0)
def call_api(endpoint: str): ...