Skip to main content

Well-featured retry decorator

Project description

From the Jargon File:

The -P Convention

Turning a word into a question by appending the syllable ‘P’;
from the LISP convention of appending the letter ‘P’ to denote
a predicate (a boolean-valued function). The question should
expect a yes/no answer, though it needn't. (See T and NIL.)

retryp is yet another retry decorator, with nothing particularly special about it other than it being both well-featured and not rewriting or hiding the calling signature of the wrapped method (allows for accurate code introspection – a Big Deal for me).

Thanks go to Graham Dumpleton and his wrapt package for that latter.



Default: 10

A multiplicative factor applied to the delay, used to provide increasing backoff as subsequent attempts continue to fail.


Default: 10

Number of times to retry the wapped item. If set to “0”, will retry 1073741823 times because a) that’s a lot, b) give up already, and c) nothing lasts forever.


Default: 10 (seconds)

The base delay between retry attempts.


Default: False

By default retryp will raise retryp.FailedTooOften if the wrapped item continues to fail after the requested number of attempts. If expose_last_exc is set, then the exception raised by the wrapped item will be raised if the last attempt results in an exception.


Default 0

Extra random seconds will be added to each retry delay, ranging from 0 to the value of jitter.


Default: False

Log every exception raised by the wrapped item using logtool.log_fault.


Default: logging.DEBUG

Logging level at which exceptions will be logged by logtool.log_fault() when log_faults is set.


Default: None

String to use in log messages to describe what is being retried.


Default: None

If provided, the return of the wrapped item will be passed as the only argument to this function. If refuse_rc_fn (rc) evaluates to True, then no further retries will be made.


Default: None

If provided, any exception raised by the wrapped item will be passed as the only argument to this function. If refuse_exc_fn (e) evaluates to True, then the exception will be raised again and retry attempts will cease.

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

retryp-0.3.post9.tar.gz (23.7 kB view hashes)

Uploaded source

Supported by

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