debian-python-raven/docs/integrations/bottle.rst

47 lines
1.1 KiB
ReStructuredText

Bottle
======
`Bottle <http://bottlepy.org/>`_ is a microframework for Python. Raven
supports this framework through the WSGI integration.
Setup
-----
The first thing you'll need to do is to disable catchall in your Bottle app::
import bottle
app = bottle.app()
app.catchall = False
.. note:: Bottle will not propagate exceptions to the underlying WSGI
middleware by default. Setting catchall to False disables that.
Sentry will then act as Middleware::
from raven import Client
from raven.contrib.bottle import Sentry
client = Client('___DSN___')
app = Sentry(app, client)
Usage
-----
Once you've configured the Sentry application you need only call run with it::
run(app=app)
If you want to send additional events, a couple of shortcuts are provided
on the Bottle request app object.
Capture an arbitrary exception by calling ``captureException``::
try:
1 / 0
except ZeroDivisionError:
request.app.sentry.captureException()
Log a generic message with ``captureMessage``::
request.app.sentry.captureMessage('Hello, world!')