README

httpexceptor |buildstatus|

.. |buildstatus| image:: https://secure.travis-ci.org/tiddlyweb/httpexceptor.png
    :target: http://travis-ci.org/tiddlyweb/httpexceptor
    :alt: build status

WSGI middleware to handle HTTP responses using exceptions

provides a group of exception classes representing non-2xx HTTP statuses, along
with a WSGI middleware to turn the exceptions into proper HTTP headers

originally extracted from `TiddlyWeb <http://tiddlyweb.com>`_

source repository: https://github.com/tiddlyweb/httpexceptor


Usage
-----

::

    from httpexceptor import HTTPExceptor, HTTP404

    # register middleware
    app = HTTPExceptor(app)

    # ...

    if unavailable:
        raise HTTP404('resource unavailable')