Colubrid Exceptions

Custom error pages

Colubrid includes a module called colubrid.exceptions. It contains a number of Python exceptions that inherit from colubrid.exceptions.HttpException.

When you raise an HttpException, colubrid will call the method process_http_exception with the error instance as argument. You can easily create your own error pages by overwriting that method:

from colubrid import BaseApplication, HttpResponse, execute
from colubrid.exceptions import PageNotFound

class MyApplication(BaseApplication):

    def process_request(self):
        raise PageNotFound

    def process_http_exception(self, e):
        if e.code == 404:
            return HttpResponse('''
            <h1>Page not Found</h1>
            <p>the requested page does not exist.</p>
            ''', status=404)
        return super(MyApplication, self).process_http_exception(e)

app = MyApplication

if __name__ == '__main__':
    execute(app)

This example would overwrite only the 404 error page, all other exceptions will still be passed to the original error page defined in BaseApplication.

Colubrid Errors

The following predefined errors are located in colubrid.exceptions and can be thrown using raise:

raise HttpRedirect('http://www.example.com/')