一、简介

Pythonretrying是一个Python编程库，它允许您添加重试逻辑到您的代码中。它是由Rory Geoghegan创建的，用来帮助开发人员在应对因网络问题、系统问题或错误手动后退导致的错误时更加容易。 Pythonretrying让您在代码中创建可重复使用的修复逻辑，而无需显式地在您的应用程序中编写重试代码。

二、特点

Pythonretrying的主要特点如下：

自定义条件和终止方法：可以在条件和终止方法上指定自定义函数。
灵活重试次数：您可以指定重试次数，或使用默认值。
指数式重试：可以在重试尝试中以指数形式增加时间间隔。
随机延迟：可设置随机间隔时间。
可定制化覆盖默认值：您可以指定您自己的默认设置，或使用重试逻辑的默认设置来覆盖重试逻辑。

三、用例

以下是一个使用Pythonretrying的Python代码示例，该示例尝试连接到一台远程服务器。

import retrying
@retrying.retry(wait_exponential_multiplier=1000,wait_exponential_max=10000)
def connect():
    #  try to connect to the remote server here
    #  raise exception if the connection fails

在上面的代码中，我们使用了一个名为“connect”的函数，并且应用了@retrying.retry装饰器。我们还向retry函数提供了一些选项，以说明何时以及如何重试我们的连接操作。

四、常见问题

1、如何指定重试条件和终止方式？

Pythonretrying允许您指定条件和终止方法。条件指定了决定是否重试的逻辑，而终止方法指定了什么时候停止重试的逻辑。

import retrying
@retrying.retry(stop_max_attempt_number=3,wait_fixed=1000)
def connect():
    #  try to connect to the remote server here
    #  raise exception if the connection fails

在上面的代码中，我们指定了等待时间固定在1秒钟，并且在尝试的最大次数为3次后结束重试。

2、如何在重试尝试中增加时间间隔？

您可以使用wait_exponential_multiplier和wait_exponential_max选项，将重试时间间隔以指数形式增加。

import retrying
@retrying.retry(wait_exponential_multiplier=1000,wait_exponential_max=10000)
def connect():
    #  try to connect to the remote server here
    #  raise exception if the connection fails

3、如何使用自定义函数？

您可以提供自定义函数，作为条件和终止方法。

import retrying
def should_retry_if_exception(exception):
    if isinstance(exception, MyCustomException):
        return True
    else:
        return False
@retrying.retry(retry_on_exception=should_retry_if_exception,wait_fixed=1000)
def connect():
    #  try to connect to the remote server here
    #  raise exception if the connection fails

在上面的代码中，我们定义了一种自定义函数should_retry_if_exception，并在使用@retrying.retry装饰器时指定这个函数用作retry_on_exception参数。

总结

Pythonretrying为Python开发人员提供了一个简单的方法来添加重试逻辑到他们的代码中。您可以指定条件和终止方法，在重试尝试中增加时间间隔，并使用自定义函数来控制重试逻辑。

Pythonretrying介绍与详解