edging 0.1.0

Rate limiting that approaches but never exceeds a threshold.

edging

Rate limiting that approaches but never exceeds a threshold. Implements a classic token-bucket limiter with an optional hold_at_threshold() mode for steady approach without burst overshoot.

Install

pip install edging

Usage

from edging import TokenBucket, RateLimitExceeded

bucket = TokenBucket(rate=5.0, capacity=5.0).hold_at_threshold(True)
assert bucket.acquire(1.0) is True
assert bucket.tokens() < 5.0

try:
    # exhaust then fail closed without blocking
    for _ in range(10):
        bucket.acquire(1.0, blocking=False)
except RateLimitExceeded as e:
    assert e.retry_after > 0

Roadmap

This is an early 0.1.0 release with active development planned:

• Async acquire APIs
• Shared / distributed backends
• Adaptive threshold policies

Author

Coldbricks — [e-mail]