celery/kombu — pull request #424 by jessedhillon (2014-10-30 20:02:03+00:00)
Title: Fixes incorrect `TokenBucket` comment, adds details

The documentation about `kombu.util.limits.TokenBucket` could be better. It was actually wrong about `TokenBucket.expected_time()` consuming a token: `TokenBucket.can_consume(tokens)` will consume `tokens` tokens if they are available, but `TokenBucket.expected_time()` is idempotent.