Raven is the legacy Python client for Sentry (getsentry.com) — replaced by sentry-python
Switch branches/tags
Clone or download
Permalink
Failed to load latest commit information.
.github ci: Use probot to release (#1111) Oct 19, 2017
.vscode vscode: basic support Jun 30, 2017
ci ref: Simplify travis setup (#1303) Sep 28, 2018
examples/django_110 [django] fix registration of hooks Feb 21, 2017
hooks remove link to nowhere after ea000f5 Sep 14, 2018
raven Use correct kwarg in handle_exception() for Flask (#1300) Sep 25, 2018
tests Allow dict-style logging in breadcrumbs processing Jul 24, 2018
.bandit.yml Refactor testing using tox environments and update travis to use them Aug 9, 2017
.bumpversion.cfg Release: 6.9.0.dev0 → 6.9.0 May 30, 2018
.gitattributes Improve merging of CHANGES Nov 26, 2016
.gitignore Add xdist coverage, bumb versions and add params to cfg Jan 1, 2018
.gitmodules ref: Kill docs in repo Aug 27, 2018
.python-version-example Refactor testing using tox environments and update travis to use them Aug 9, 2017
.travis.yml ref: Simplify travis setup (#1303) Sep 28, 2018
AUTHORS Move repository to getsentry/raven-python Aug 11, 2012
CHANGELOG.md Use correct kwarg in handle_exception() for Flask (#1300) Sep 25, 2018
LICENSE Update copyright Jun 28, 2015
MANIFEST.in include raven/contrib/zconfig/component.xml in manifest Nov 13, 2017
Makefile fix(breadcrumbs): Ensure maximum lengths on several attributes Feb 3, 2018
README.rst Fix link to sentry-python in README (#1304) Oct 1, 2018
codecov.yml ref: Kill docs in repo Aug 27, 2018
conftest.py feat: Add a client for Sanic Mar 29, 2018
setup.cfg ref: Kill docs in repo Aug 27, 2018
setup.py Remove whitespace. May 6, 2018
tox.ini ref: Simplify travis setup (#1303) Sep 28, 2018

README.rst

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.

This SDK is being phased out for Sentry-Python.

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.