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 details)
Built Distribution
retry-0.6.0-py2-none-any.whl
(4.4 kB
view details)
File details
Details for the file retry-0.6.0.tar.gz
.
File metadata
- Download URL: retry-0.6.0.tar.gz
- Upload date:
- Size: 2.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
49de7915e0a7fcecb446f50c2b41664ba1a71551ea196f60739ac4298b0bdf4a
|
|
MD5 |
5505772aa29e2151b021785b92c0f6aa
|
|
BLAKE2b-256 |
a660bb0d08e24717710fcae104062e45e0eb24957d52cad2c9f8717532030b62
|
File details
Details for the file retry-0.6.0-py2-none-any.whl
.
File metadata
- Download URL: retry-0.6.0-py2-none-any.whl
- Upload date:
- Size: 4.4 kB
- Tags: Python 2
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
933874ac7f21193d3fb85c888d424abcc077a3f716ed70ce4d17c23f05b56279
|
|
MD5 |
73c1efc36a797fb7322b5fb64c651a9f
|
|
BLAKE2b-256 |
47607b2fe78c24b86e087c7281702ada7786c063d034389d889a00f7fd1dcbe2
|