retry is a decorator for isolating retrying logic, with logging intergraton.
Installation
$ pip install retry
API
def retry(exceptions=Exception, tries=float('inf'), delay=0, backoff=1, logger=logging.getLogger(__name__)):
"""Return a decorator for retrying.
:param exceptions: an exception or a tuple of exceptions to catch
:param tries: the maximum number of attempts
:param delay: how many seconds to wait between attmpts
:param backoff: delay growth factor
:param logger: logger.warning(fmt, error, delay) will be called on failed attempts
"""
various retrying logic can be achieved by combination of arguments.
Examples
from retry import retry
# Retry until succeed
@retry()
def make_trouble():
...
# Retry on ZeroDivisionError, fail after 3 attmpts, sleep 2 seconds per
# attmpt
@retry(ZeroDivisionError, tries=3, delay=2)
def make_trouble():
...
# Retry on ValueError and TypeError, sleep 1, 2, 4, 8, etc.. seconds
@retry((ValueError, TypeError), delay=1, backoff=2)
def make_trouble():
...
# If you enable logging, you can get warnings like 'ValueError, retrying in
# 1 seconds'
if __name__ == '__main__':
import logging
logging.basicConfig()
make_trouble()
Metadata
Release files for retry 0.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| retry-0.6.0.tar.gz | 2.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| retry-0.6.0-py2-none-any.whl | Python 2 | none | any | Details |
Total release size: 6.9 kB
Release files / retry-0.6.0.tar.gz
| Download URL | retry-0.6.0.tar.gz |
|---|---|
| Size | 2.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
49de7915e0a7fcecb446f50c2b41664ba1a71551ea196f60739ac4298b0bdf4a
|
|
BLAKE2b-256 checksum How to use checksums |
a660bb0d08e24717710fcae104062e45e0eb24957d52cad2c9f8717532030b62
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / retry-0.6.0-py2-none-any.whl
| Download URL | retry-0.6.0-py2-none-any.whl |
|---|---|
| Size | 4.4 kB |
| Tags | Python 2 |
|
SHA-256 checksum How to use checksums |
933874ac7f21193d3fb85c888d424abcc077a3f716ed70ce4d17c23f05b56279
|
|
BLAKE2b-256 checksum How to use checksums |
47607b2fe78c24b86e087c7281702ada7786c063d034389d889a00f7fd1dcbe2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |