Skip to main content
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()

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)

Source distribution for retry 0.6.0
File Size Uploaded
retry-0.6.0.tar.gz 2.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for retry 0.6.0
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

0.9.2

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.1

2 release files

0.8.0

0.7.0

2 release files

This release

0.6.0 This release

2 release files

0.5.0

2 release files

0.4.2

1 release file

0.4.1

1 release file

0.4.0

1 release file

0.3.0

1 release file

0.2.0

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page