前言

Retrying是一个Apache 2.0授权的通用重试库，用Python编写，以简化向任何东西添加重试行为的任务。

最简单的用例是每当发生异常时都重新尝试一个flaky函数，直到返回一个值。

import random
from retrying import retry

@retry
def do_something_unreliable():
    if random.randint(0, 10) > 1:
        raise IOError("Broken sauce, everything is hosed!!!111one")
    else:
        return "Awesome sauce!"

print do_something_unreliable()

特性

• 一般装饰API
• 指定停止条件(即尝试次数限制)
• 指定等待条件(即尝试之间的指数回退睡眠)
• 自定义对异常的重试
• 自定义在预期的返回结果上重试

安装

安装非常简单

pip install retrying
# or
pip3 install retrying
# or
easy_install retrying

举例

1、不添加任何参数，默认一直报错就一直重试

@retry
def never_give_up_never_surrender():
    print "永远重试，忽略异常，重试之间没有等待"

2、设置你需要重试的次数

@retry(stop_max_attempt_number=7)
def stop_after_7_attempts():
    print "尝试7次后停止"

3、设置最大延迟时间

如果调用的函数出现异常，那么就会重复调用这个函数，最大调用时间，默认为100毫秒

@retry(stop_max_delay=10000)
def stop_after_10_s():
    print "10秒后停止"

4、设置每次调用间隔等待时间

@retry(wait_fixed=2000)
def wait_2_s():
    print "重试之间等待2秒"

5、设置每次调用间隔等待时间:随机

wait_random_min：最短时间
wait_random_max：最长时间

@retry(wait_random_min=1000, wait_random_max=2000)
def wait_random_1_to_2_s():
    print "在重试之间随机等待1-2秒"

总结

• stop_max_attempt_number：用来设定最大的尝试次数，超过该次数就停止重试
• stop_max_delay：比如设置成10000，那么从被装饰的函数开始执行的时间点开始，到函数成功运行结束或者失败报错中止的时间点，只要这段时间超过10秒，函数就不会再执行了
• wait_fixed：设置在两次retrying之间的停留时间
• wait_random_min和wait_random_max：用随机的方式产生两次retrying之间的停留时间
• wait_exponential_multiplier和wait_exponential_max：以指数的形式产生两次retrying之间的停留时间，产生的值为2^previous_attempt_number * wait_exponential_multiplier，previous_attempt_number是前面已经retry的次数，如果产生的这个值超过了wait_exponential_max的大小，那么之后两个retrying之间的停留值都为wait_exponential_max
• 我们可以指定要在出现哪些异常的时候再去retry，这个要用retry_on_exception传入一个函数对象