Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Easily eats exceptions using decorators

Project Description

Python library for easily “eating” exceptions in functions. Eating can mean either returning a default value or calling another function.


This library is basically just a function, namely Initially, I wrote it for a document parser in which there was a lot of exception handling logic for stuff I didn’t really care particularly much about.

Example usage

Eat all exceptions and return None if one was raised:
def foo():

Eat ValueError exceptions and return 0 if one was raised:, error_value=0)
def foo():

Eat IndexError and ValueError and fall back to function bar if one of them is raised:, ValueError, error_handler=bar)
def foo():

In the example above, bar will be passed the exception as the first argument, followed by all the other arguments and keyword arguments in the decorated function. This means that bar would have e.g. the following signature:

def bar(ex, *args, **kwargs):


This library will not catch exceptions and continue executing the following code. Whenever it eats an exception, it immediately returns error_value or calls error_handler.


Complete the test suite.

Release History

This version
History Node


History Node


History Node


History Node


Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers