Skip to main content

Throw and catch named exceptions without creating a class first

Project description

CircleCI Coverage Status PyPi


Throw and catch named exceptions without creating a class first. The goal of this project is to make working with named exceptions simpler. It's often a huge overhead of work to create named exceptions in a separate file before being able to throw them to nicely be caught.


pip install easy-exceptions


from easy_exceptions import EasyException
    raise EasyException('NamedException')('TEST MESSAGE')
except EasyException('NamedException') as e:
    print("Caught this specific exception without having to define it!")

EasyExceptions even supports using a custom parent class instead of the base Exception. This is because APIs often use a custom exception class for rendering error messages. All you have to do in this case is pass that parent class to EasyException and instantiate it the way you always would. For example:

from easy_exceptions import EasyException 
from api.exceptions import BaseException # Your custom base exception
    # you can pass whatever special args here that you usually do to BaseException
    raise EasyException('NamedException', parent=BaseException)(...)
except EasyException('NamedException', parent=BaseException):
    print("Caught the specific exception!") 
# This exception can still be caught by referencing the BaseException with regular syntax 
except BaseException:
    print("This would be called if the above exception handler wasn't there")

This can be further simplified by binding the BaseException during application startup using the bind_parent

from easy_exceptions import EasyException, bind_parent 
from api.exceptions import BaseException

    raise EasyException('NamedException') 
except BaseException: #Could alse use EasyException('NamedException') to target the named exception only
    print("Exceptions are always of type BaseException now")

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

easy_exceptions-1.0.2.tar.gz (2.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