retry decorator
Project description
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()
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
retry-0.6.0.tar.gz
(2.5 kB
view hashes)
Built Distribution
retry-0.6.0-py2-none-any.whl
(4.4 kB
view hashes)