retrying 1.3.3

功能

• 通用装饰器API
• 指定停止条件（即按尝试次数限制）
• 指定等待条件（即尝试之间的指数后退睡眠）
• 自定义异常时重试
• 根据预期的返回结果自定义重试

安装

要重新安装，只需：

$ pip install retrying

或者，如果您必须这样做：

$ easy_install retrying

但是，你以后可能会后悔的。

示例

正如您在上面看到的，默认行为是永远重试而不等待。

@retrydefnever_give_up_never_surrender():print"Retry forever ignoring Exceptions, don't wait between retries"

让我们少坚持一点，设定一些界限，比如放弃前的尝试次数。

@retry(stop_max_attempt_number=7)defstop_after_7_attempts():print"Stopping after 7 attempts"

我们没有一整天的时间，所以让我们设定一个界限，我们应该多长时间重试的东西。

@retry(stop_max_delay=10000)defstop_after_10_s():print"Stopping after 10 seconds"

大多数事情都不希望被调查得越快越好，所以让我们在两次重试之间等待2秒。

@retry(wait_fixed=2000)defwait_2_s():print"Wait 2 second between retries"

有些事情表现最好的时候会有点随机性。

@retry(wait_random_min=1000,wait_random_max=2000)defwait_random_1_to_2_s():print"Randomly wait 1 to 2 seconds between retries"

再次重申，在重试分布式服务和其他远程端点时，很难克服指数退避。

@retry(wait_exponential_multiplier=1000,wait_exponential_max=10000)defwait_exponential_1000():print"Wait 2^x * 1000 milliseconds between each retry, up to 10 seconds, then 10 seconds afterwards"

我们有一些处理引发特定或一般异常的重试的选项，如这里的情况。

defretry_if_io_error(exception):"""Return True if we should retry (in this case when it's an IOError), False otherwise"""returnisinstance(exception,IOError)@retry(retry_on_exception=retry_if_io_error)defmight_io_error():print"Retry forever with no wait if an IOError occurs, raise any other errors"@retry(retry_on_exception=retry_if_io_error,wrap_exception=True)defonly_raise_retry_error_when_not_io_error():print"Retry forever with no wait if an IOError occurs, raise any other errors wrapped in RetryError"

我们也可以使用函数的结果来改变重试的行为。

defretry_if_result_none(result):"""Return True if we should retry (in this case when result is None), False otherwise"""returnresultisNone@retry(retry_on_result=retry_if_result_none)defmight_return_none():print"Retry forever ignoring Exceptions with no wait if return value is None"

还支持停止、等待等任何组合，使您可以自由混合和匹配。

贡献

1. 检查打开的问题或打开一个新的问题，开始围绕功能想法或错误的讨论。
2. 在github上分叉the repository，开始对master分支（或其分支）进行更改。
3. 编写一个测试，显示错误已修复或功能按预期工作。
4. 发送一个pull请求并对维护程序进行bug操作，直到它被合并并发布。：）请确保将自己添加到AUTHORS。

历史记录

标签：

• 功能
• if
• def
• random
• error
• result
• retry
• wait
• retrying
• ioerror

欢迎加入QQ群-->： 979659372

推荐PyPI第三方库

• hdfs3

  libhdfs3的python包装器，一个本地hdfs客户机

• chrw

  chr url shortener api的python包装器

• effect

  python的纯效果

• python-nrpc

  nats rpc的python代码生成器和lib

• nip.cli

  nip不是pip

• pyassuan

  在assuan协议中用于通信的python模块和工具。

• syscon-nc

  不带加密的syscon

• collective.mtrsetup

  genericsetup的扩展，添加对mimetypes\u注册表导入/导出的支持

• import-expression

  解析python的超集，允许内联模块导入表达式

• errbot-backend-webapp

  用于errbot的webapp后端插件

• cfutils

  色谱文件用途

• evfuncs

  用于处理由evtaf程序和evsongAnaly图形用户界面创建的文件的函数

• neptune-cli

  海王星客户端图书馆

• thornbed

  不同服务的简单oembed包装

• django-tempocal

  python内置htmlcalendar的django-fied模板版本。