.. raw:: html
<p align="center"> <a href="https://sentry.io" target="_blank" align="center"> <img src="https://sentry-brand.storage.googleapis.com/sentry-logo-black.png" width="280"> </a> <br> </p>
.. image:: https://codeclimate.com/github/getsentry/raven-python/badges/gpa.svg :target: https://codeclimate.com/github/getsentry/raven-python :alt: Code Climate
Raven is the official legacy Python client for
Sentry_, officially supports
Python 2.6–2.7 & 3.3–3.7, and runs on PyPy and Google App Engine.
This SDK is being phased out for
It tracks errors and exceptions that happen during the execution of your application and provides instant notification with detailed information needed to prioritize, identify, reproduce and fix each issue.
It provides full out-of-the-box support for many of the popular python frameworks, including Django, and Flask. Raven also includes drop-in support for any WSGI-compatible web application.
Your application doesn't live on the web? No problem! Raven is easy to use in any Python application.
For more information, see our
Python Documentation_ for framework integrations and other goodies.
It's really easy to get started with Raven. After you complete setting up a project in Sentry, you’ll be given a value which we call a DSN, or Data Source Name. You will need it to configure the client.
Install the latest package with pip and configure the client::
pip install raven --upgrade
Create a client and capture an example exception:
.. sourcecode:: python
from raven import Client client = Client('___DSN___') try: 1 / 0 except ZeroDivisionError: client.captureException()
Raven Python is more than that however. Checkout our
Raven will continue to be maintained for bugfixes and contributions are more than welcome! New features should only go into the new sentry-python SDK.
There are many ways to contribute:
Join in on discussions on our
Mailing List_ or in our
Report bugs on our
Submit a pull request!
Code_ on Github
IRC Channel_ (irc.freenode.net, #sentry)
.. _Sentry: https://getsentry.com/ .. _Python Documentation: https://docs.getsentry.com/hosted/clients/python/ .. _SDKs for other platforms: https://docs.sentry.io/#platforms .. _Issue Tracker: https://github.com/getsentry/raven-python/issues .. _Code: https://github.com/getsentry/raven-python .. _Mailing List: https://groups.google.com/group/getsentry .. _IRC Channel: irc://irc.freenode.net/sentry .. _Travis CI: http://travis-ci.org/getsentry/raven-python
Not using Python? Check out our
SDKs for other platforms_.