Skip to main content

Decorators for functions that you wish to retry

Project description

# trythatagain

[![Build Status](https://travis-ci.org/angstwad/trythatagain.svg?branch=master)](https://travis-ci.org/angstwad/trythatagain)

This provides decorators for super simple function/method call retries when an exception is raised.

## Installation

```bash
pip install trythatagain
```

## Examples

Here's a simple use case: querying the AWS API, knowing you might hit API limits.

```python
from trythatagain import retry

@retry
def find_ebs_volumes(unattached=True, no_snapshots=True):
...

try:
find_ebs_volumes()
except CaughtException as e:
print('Failed to list EBS volumes')
print(e.__cause__)
```

This will retry calling `func` three times. If was not successful in calling the function without an exception, it will re-raise the exception as `CaughtException`, with the original exception available at the attribute `__cause__`.

Retry as many times as times as necessary:

```python
from trythatagain import retry

@retry(retries=5)
def try_five_times():
raise Exception('This always fails')

@retry(retries=0)
def retry_forever():
raise Exception('Terrible waste of CPU cycles')
```

Raise immediately on specific exceptions:

```python
@retry(raise_for=ValueError)
def update_cache():
...
```

Suppress re-raising exceptions:

```python
@retry(reraise=False)
def reload_user_data():
...
```

There's also exponential and linear backoff retries things like cooling down after hitting API limits. In fact, AWS recommends exponential backoff to deal with API limits.

```python
# waits 1 second, then 4, then 9, etc.
@retry_exp_backoff(unit=MILLISECONDS)
def update_instance_tags():
...

@retry_linear_backoff(unit=SECONDS)
def scrape_url():
...
```

Custom wait functions are also possible:

```python
def fixed(i, unit):
time.sleep(5 * unit)

@retry(wait_func=fixed, unit=MILLISECONDS)
def func():
...
```

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
trythatagain-0.1.3-py2-none-any.whl (4.1 kB) Copy SHA256 hash SHA256 Wheel 2.7
trythatagain-0.1.3-py3-none-any.whl (4.1 kB) Copy SHA256 hash SHA256 Wheel 3.6
trythatagain-0.1.3.tar.gz (3.4 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page