Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Simple exceptions and messaging

Project description

EZCeption (and EZMessage)

These classes provide a simplified means to define exception classes and message attributes.

Goals

  • Less boilerplate to define error classes so they'll be used more.
  • Formatting does not happen at raise time so catching errors doesn't incur string computation cost.
  • Exception fields are easier to probe by exception handlers.
  • Class-bases exceptions are a snap to define.
  • Works with regular Python exception classes.
  • Interfaces with the gettext module by default.
  • Allows for associating other i18n messaging in the error classes.

Installation.

pip install ezception

NOTE: ezception is not on pypi yet. Until official releases are available:

pip install https://github.com/hrharkins/ezception/archive/master.zip

Usage

import ezception

class MyWebRequester(object):

    class Error(ezception.EZCeption):
        'A general error has occurred.'

    class OpenError(Error):
        'An error opening {self.url!r} has occurred.'

    class NoURLError(OpenError):
        '''
        No URL was provided.
        ''''

    class NoURLError(OpenError):
        '''
        The scheme {self.scheme!r} is not acceptable.
        '''

    ...

    def open(self, url):
        ... stuff happens.

        ... Oh noes!
        raise self.BadSchemeError(scheme=url.scheme)

So in the example the class defines a simple hierarchy of errors. Progreammers can trivially trap MyWebRequester.Error to catch anything generated by MyWebRequester. Because it's very simple to define those errors, a more robust exception hierarchy is more likely to emerge.

In addition, the message is NOT generated at exception time. Because of this, it is easy to catch and determine better handling code. The default Python exceptions use args, which requires the programmer to have tighter coupling with the error classes to acquire the parameters of the failure (or the error class needs to define more properties).

Only when the exception is printed does stringification occur. In addition, the message to be presented is processed using the gettext module, so adding support for other languages for such messages is possible using regular .po files. All messages are tracked by a global ezception.ALL_MSGS dict so generating base .po files is also simplified.

Project details


Download files

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

Files for ezception, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size ezception-0.0.2-py3-none-any.whl (15.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size ezception-0.0.2.tar.gz (3.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page