免费建网站,2022年最好用的搜索引擎,义乌创源网站建设,温岭网站设计tenacity是一个 Python 库#xff0c;用于简化重试逻辑的实现。它提供了装饰器和工具函数#xff0c;使得在函数执行失败时可以自动重试。以下是对tenacity库的详细介绍#xff1a;
一、安装
可以使用pip安装tenacity#xff1a;
pip install tenacity二、主要概念和功能…tenacity是一个 Python 库用于简化重试逻辑的实现。它提供了装饰器和工具函数使得在函数执行失败时可以自动重试。以下是对tenacity库的详细介绍
一、安装
可以使用pip安装tenacity
pip install tenacity二、主要概念和功能 装饰器 retry这是最常用的装饰器用于在函数执行失败时自动重试。可以通过参数配置重试的条件、次数、延迟等。retry_always无论函数执行结果如何始终重试。retry_if_exception_type根据异常类型决定是否重试。例如可以指定只在特定类型的异常发生时重试。 重试条件 retry(wait...)指定重试之间的等待时间。可以使用内置的等待策略如指数退避wait_exponential、固定等待时间wait_fixed等。retry(stop...)定义重试的停止条件。可以设置最大重试次数stop_max_attempt_number、最大等待时间stop_max_delay等。retry(retry...)自定义重试的条件函数。该函数接收一个参数表示上一次执行的结果如果返回True则重试否则停止。 异常处理 retry_if_exception_type(...)指定在特定类型的异常发生时重试。可以传入一个或多个异常类型。retry_if_not_result(...)根据函数的返回值决定是否重试。例如可以检查返回值是否为None或满足其他条件。 回调函数 retry(after...)在每次重试后执行一个回调函数。可以用于记录日志、发送通知等。retry(before...)在每次重试前执行一个回调函数。可以用于准备资源、设置状态等。
三、使用示例
基本重试
import tenacity
import randomtenacity.retry
def some_function():result random.randint(1, 10)if result 5:raise Exception(Failed.)else:return resulttry:print(some_function())
except Exception as e:print(fFinal failure: {e})在这个例子中some_function会在返回值小于 5 时抛出异常并自动重试直到返回值大于等于 5。
自定义重试条件和等待时间
import tenacity
import timedef is_failure(result):return result is Falsetenacity.retry(waittenacity.wait_fixed(2), retrytenacity.retry_if_result(is_failure))
def another_function():result random.choice([True, False])print(fResult: {result})return resulttry:another_function()
except Exception as e:print(fFinal failure: {e})在这个例子中another_function会在返回值为False时重试每次重试之间等待 2 秒。自定义的重试条件函数is_failure根据返回值决定是否重试。
使用回调函数
import tenacity
import loggingdef log_retry(retry_state):logging.info(fRetrying {retry_state.fn.__name__}, attempt #{retry_state.attempt_number})tenacity.retry(waittenacity.wait_exponential(multiplier1, min2, max10), afterlog_retry)
def yet_another_function():result random.randint(1, 10)if result 5:raise Exception(Failed.)else:return resulttry:yet_another_function()
except Exception as e:print(fFinal failure: {e})在这个例子中yet_another_function在失败时会按照指数退避策略重试每次重试后会调用log_retry回调函数记录重试信息。
