Skip to content
This repository has been archived by the owner on Oct 23, 2023. It is now read-only.
/ raven-python Public archive

Raven is the legacy Python client for Sentry (getsentry.com) — replaced by sentry-python

License

Notifications You must be signed in to change notification settings

getsentry/raven-python


Deprecated for sentry-sdk package

Raven is deprecated in favor of Sentry-Python.

Feature development and most bugfixes happen exclusively there, as Raven is in maintenance mode.


Raven - Sentry for Python

PyPi page link -- version https://travis-ci.org/getsentry/raven-python.svg?branch=master PyPi page link -- MIT licence PyPi page link -- Python versions 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.

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.

Features

  • Automatically report (un)handled exceptions and errors
  • Send customized diagnostic data
  • Process and sanitize data before sending it over the network

Quickstart

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:

from raven import Client

client = Client('___DSN___')

try:
    1 / 0
except ZeroDivisionError:
    client.captureException()

Raven Python is more than that however. Checkout our Python Documentation.

Contributing

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:

Resources

Not using Python? Check out our SDKs for other platforms.