retrying模块的使用

ゞ浴缸里的玫瑰 2023-08-17 16:35 141阅读 0赞

安装模块：pip3 install retrying

## 使用方式： ##

1.  使用retrying模块提供的retry模块
2.  通过装饰器的方式使用，让装饰器的函数反复的执行
3.  retry可以传入参数stop\_max\_attempt\_number，让函数报错后继续重新执行，达到最大执行次数的上线，如果每次都报错，整个函数就报错，只要中间有一个成功了的话，程序就可以继续往后面执行了

例子：

from retrying import retry
    @retry(stop_max_attempt_number=5,wait_random_min=1000,wait_random_max=5000)
    def run():
      print("开始重试")
      raise NameError
     
    if __name__ == '__main__':
      run()

首先导入了retry模块

然后装饰了一个run函数，函数中很简单，主要就是通过raise跑出了一个异常，执行这个代码 我们可以发现，程序打印了五次开始重试，最后一次抛出异常，NameError，那么到了这里我们就可以感受到，就是这么简单的代码，就完成了五次重试，同时这五次重试的间隔时间也是不同的，要是想尝试重复十次以上的的话，就需要把上面的stop\_max\_attempt\_number改成10就可以了，到这里就可以解释retry装饰器的参数了

retry的使用就是这么简单，关键是装饰器里面的参数的使用，要是不写参数的话就会一直一种重试

### stop\_max\_attempt\_number ###

在停止之前尝试的最大次数，最后一次如果还是有异常就会抛出异常，停止运行，默认是五次（强调总次数）

### stop\_max\_delay ###

最大延迟时间，大概的意思就是：如果调用的函数抛出异常了，那么就会重复调用这个函数，最大调用时间，默认100毫秒

### wait\_random\_min ###

在两次调用方法停留时长，停留最短的时间，默认是0

### wait\_random\_max ###

在两次调用方法停留时长，停留最长时间，默认是1000毫秒

### wait\_incrementing\_increment ###

每调用一次就会增加的时长，默认是100毫秒

### 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\_on\_exception ###

指定一个函数，如果这个函数返回指定异常，就会重试，如果不是指定的异常就会推出

from retrying import retry
    def run2(exception):
      return isinstance(exception, ZeroDivisionError)
    @retry(retry_on_exception=run2)
    def run():
      print("开始重试")
      a = 1 / 0
    if __name__ == '__main__':
      run()

### retry\_on\_result ###

指定一个函数，如果指定的函数返回True，就重试，否则抛出异常退出

rom retrying import retry
    def run2(r):
      return isinstance(r, int)
    @retry(retry_on_result=run2)
    def run():
      print("开始重试")
      a = 1
      return a
    if __name__ == '__main__':
      run()

### wrap\_exception ###

参数设置为True/False，如果指定的异常类型，包裹在retryError中，就会看到RetryError和程序抛出的Exception error

### stop\_func ###

每次抛出异常的时候都会执行的函数，如果stop\_max\_delay、stop\_max\_attmpt\_number配合使用，则后两个就会失效，指定的stop\_func会有两个参数：attempt、delay

### wait\_func ###

和stop\_func的用法差不多，就不过多的描述了

ps：如果没有捕获到异常，就会从该层外层的异常重试触发；尝试两次失败会报错，所以在再次使用处理，跳出报错，直接pass

转载于:https://www.cnblogs.com/tulintao/p/11604808.html