iiapis

English | 中文

可检视、可测试的指数退避延迟序列。

安装

pip install iiapis

用法

from iiapis import delay_for, delays

delays(5)                      # [0.5, 1.0, 2.0, 4.0, 8.0]
delays(6, n_base=1, n_max=5)   # [1, 2, 4, 5, 5, 5]
delay_for(3)                   # 2.0
delays(3, n_jitter=0.2)        # 每个值最多比原始延迟低 20%

说明

把退避算成数据而不是藏在 sleep() 里，方便打印、断言、交给调度器。n_jitter 是延迟的比例，按随机量在区间尾部扣减——没有它，同一刻失败的客户端会在同一刻一起重试。需要确定性输出时传 0。

许可证

MIT

English

Exponential backoff delay sequences you can inspect and test.

Install

pip install iiapis

Usage

from iiapis import delay_for, delays

delays(5)                      # [0.5, 1.0, 2.0, 4.0, 8.0]
delays(6, n_base=1, n_max=5)   # [1, 2, 4, 5, 5, 5]
delay_for(3)                   # 2.0
delays(3, n_jitter=0.2)        # 每个值最多比原始延迟低 20%

Notes

Backoff as data instead of a sleep() buried in a loop. n_jitter is a fraction of each delay, subtracted at random; without it every client that failed together retries together. Pass 0 for deterministic output.

License

MIT