blob: 817cdfd1dc5a72cc6bf37ba5e08a60e5ca1fc8e2 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
.. 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>
Deprecated for sentry-sdk package
=================================
**Raven is deprecated** in favor of `Sentry-Python <https://github.com/getsentry/sentry-python>`_.
Feature development and most bugfixes happen exclusively there, as Raven is in maintenance mode.
----
Raven - Sentry for Python
=========================
.. image:: https://img.shields.io/pypi/v/raven.svg
:target: https://pypi.python.org/pypi/raven
:alt: PyPi page link -- version
.. image:: https://travis-ci.org/getsentry/raven-python.svg?branch=master
:target: https://travis-ci.org/getsentry/raven-python
.. image:: https://img.shields.io/pypi/l/raven.svg
:target: https://pypi.python.org/pypi/raven
:alt: PyPi page link -- MIT licence
.. image:: https://img.shields.io/pypi/pyversions/raven.svg
:target: https://pypi.python.org/pypi/raven
:alt: PyPi page link -- Python versions
.. 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.
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:
.. 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 `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:
* Join in on discussions on our `Mailing List`_ or in our `IRC Channel`_.
* Report bugs on our `Issue Tracker`_.
* Submit a pull request!
Resources
---------
* `Sentry`_
* `Python Documentation`_
* `Issue Tracker`_
* `Code`_ on Github
* `Mailing List`_
* `IRC Channel`_ (irc.freenode.net, #sentry)
* `Travis CI`_
.. _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`_.
|
