Python利器:retrying失败、异常重试模块库

@高效码农  January 27, 2021

前言

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传入一个函数对象


添加新评论