Skip to main content

retry decorator

Project description

https://pypip.in/d/retry/badge.png https://pypip.in/v/retry/badge.png https://pypip.in/license/retry/badge.png

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


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)

Uploaded Source

Built Distribution

retry-0.6.0-py2-none-any.whl (4.4 kB view details)

Uploaded Python 2

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

Hashes for retry-0.6.0.tar.gz
Algorithm Hash digest
SHA256 49de7915e0a7fcecb446f50c2b41664ba1a71551ea196f60739ac4298b0bdf4a
MD5 5505772aa29e2151b021785b92c0f6aa
BLAKE2b-256 a660bb0d08e24717710fcae104062e45e0eb24957d52cad2c9f8717532030b62

See more details on using hashes here.

File details

Details for the file retry-0.6.0-py2-none-any.whl.

File metadata

File hashes

Hashes for retry-0.6.0-py2-none-any.whl
Algorithm Hash digest
SHA256 933874ac7f21193d3fb85c888d424abcc077a3f716ed70ce4d17c23f05b56279
MD5 73c1efc36a797fb7322b5fb64c651a9f
BLAKE2b-256 47607b2fe78c24b86e087c7281702ada7786c063d034389d889a00f7fd1dcbe2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page