Skip to main content

Middleware which implements a retryable exceptions

Project description

This package implements a WSGI middleware filter which intercepts “retryable” exceptions and retries the WSGI request a configurable number of times. If the request cannot be satisfied via retries, the exception is reraised.


Install using setuptools, e.g. (within a virtualenv):

$ easy_install repoze.retry

Configuration via Python

Wire up the middleware in your application:

from repoze.retry import Retry
mw = Retry(app, tries=3, retryable=(ValueError, IndexError))

By default, the retryable exception is repoze.retry.ConflictError (or if ZODB is installed, it’s ZODB.POSException.ConflictError); the tries count defaults to 3 times.

Configuration via Paste

If you want to use the default configuration, you can just include the filter in your application’s pipeline. Note that the filter should come before (to the “left”) of the filter, your pipeline includes it, so that retried requests are first aborted and then restarted in a new transaction:

pipeline = egg:Paste#cgitb

If you want to override the defaults, e.g. to change the number of retries, or the exceptions which will be retried, you need to make a separate section for the filter:

use = egg:repoze.retry
tries = 2
retryable = egg:mypackage.exceptions:SomeRetryableException

and then use it in the pipeline:

pipeline = egg:Paste#cgitb

Reporting Bugs / Development Versions

Visit to report bugs. Visit to download development or tagged versions.

0.9.1 (2008-06-18)

Seek wsgi.input back to zero before retrying a request due to a conflict error.

0.9 (2008-06-15)

Fixed concurrency bug whereby a response from one request might be returned as result of a different request.

Initial PyPI release.


Added WSGI conformance testing for the middleware.


Made the retryable exception(s) configurable, removing the hardwired dependency on ZODB3.


Relaxed requirement for ZODB 3.7.2, since we might need to use the package with other verions.


Depend on PyPI release of ZODB 3.7.2. Upgrade to this by doing bin/easy_install -U ‘ZODB3 >= 3.7.2, < 3.8.0a’ if necessary.


Write retry attempts to ‘wsgi.errors’ stream if availabile.

Depend on rerolled ZODB 3.7.1 instead of zopelib.

Add license and copyright, change trove classifiers.


We now buffer the result of a downstream application’s ‘start_response’ call so we can retry requests which have already called start_response without breaking the WSGI spec (the server’s start_response may only be called once unless there is an exception, and then it needs to be called with an exc_info three-tuple, although we’re uninterested in that case here).


The entry point name was wrong (it referred to “tm”). Change it so that egg:repoze.retry#retry should work in paste configs.

Depend on zopelib rather than ZODB 3.8.0b3 distribution, because the ZODB distribution pulls in various packages (zope.interface and ZEO most notably) that are incompatible with stock Zope 2.10.4 apps and older sandboxes. We’ll need to revisit this.


Initial release

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
repoze.retry-0.9.1.tar.gz (6.9 kB) Copy SHA256 hash SHA256 Source None Jun 18, 2008

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 DigiCert DigiCert EV certificate StatusPage StatusPage Status page