44< html >
55 < head >
66 < meta charset ="utf-8 " />
7- < title > sentry_sdk.transport — sentry-python 0.17.6 documentation</ title >
7+ < title > sentry_sdk.transport — sentry-python 0.17.7 documentation</ title >
88 < link rel ="stylesheet " href ="../../_static/alabaster.css " type ="text/css " />
99 < link rel ="stylesheet " href ="../../_static/pygments.css " type ="text/css " />
1010 < script id ="documentation_options " data-url_root ="../../ " src ="../../_static/documentation_options.js "> </ script >
@@ -42,7 +42,7 @@ <h1>Source code for sentry_sdk.transport</h1><div class="highlight"><pre>
4242
4343< span class ="kn "> from</ span > < span class ="nn "> sentry_sdk.utils</ span > < span class ="kn "> import</ span > < span class ="n "> Dsn</ span > < span class ="p "> ,</ span > < span class ="n "> logger</ span > < span class ="p "> ,</ span > < span class ="n "> capture_internal_exceptions</ span > < span class ="p "> ,</ span > < span class ="n "> json_dumps</ span >
4444< span class ="kn "> from</ span > < span class ="nn "> sentry_sdk.worker</ span > < span class ="kn "> import</ span > < span class ="n "> BackgroundWorker</ span >
45- < span class ="kn "> from</ span > < span class ="nn "> sentry_sdk.envelope</ span > < span class ="kn "> import</ span > < span class ="n "> Envelope</ span > < span class =" p " > , </ span > < span class =" n " > get_event_data_category </ span >
45+ < span class ="kn "> from</ span > < span class ="nn "> sentry_sdk.envelope</ span > < span class ="kn "> import</ span > < span class ="n "> Envelope</ span >
4646
4747< span class ="kn "> from</ span > < span class ="nn "> sentry_sdk._types</ span > < span class ="kn "> import</ span > < span class ="n "> MYPY</ span >
4848
@@ -91,7 +91,8 @@ <h1>Source code for sentry_sdk.transport</h1><div class="highlight"><pre>
9191 < span class ="bp "> self</ span > < span class ="p "> ,</ span > < span class ="n "> event</ span > < span class ="c1 "> # type: Event</ span >
9292 < span class ="p "> ):</ span >
9393 < span class ="c1 "> # type: (...) -> None</ span >
94- < span class ="sd "> """This gets invoked with the event dictionary when an event should</ span >
94+ < span class ="sd "> """</ span >
95+ < span class ="sd "> This gets invoked with the event dictionary when an event should</ span >
9596< span class ="sd "> be sent to sentry.</ span >
9697< span class ="sd "> """</ span >
9798 < span class ="k "> raise</ span > < span class ="ne "> NotImplementedError</ span > < span class ="p "> ()</ span > </ div >
@@ -100,14 +101,15 @@ <h1>Source code for sentry_sdk.transport</h1><div class="highlight"><pre>
100101 < span class ="bp "> self</ span > < span class ="p "> ,</ span > < span class ="n "> envelope</ span > < span class ="c1 "> # type: Envelope</ span >
101102 < span class ="p "> ):</ span >
102103 < span class ="c1 "> # type: (...) -> None</ span >
103- < span class ="sd "> """This gets invoked with an envelope when an event should</ span >
104- < span class ="sd "> be sent to sentry. The default implementation invokes `capture_event`</ span >
105- < span class ="sd "> if the envelope contains an event and ignores all other envelopes.</ span >
104+ < span class ="sd "> """</ span >
105+ < span class ="sd "> Send an envelope to Sentry.</ span >
106+
107+ < span class ="sd "> Envelopes are a data container format that can hold any type of data</ span >
108+ < span class ="sd "> submitted to Sentry. We use it for transactions and sessions, but</ span >
109+ < span class ="sd "> regular "error" events should go through `capture_event` for backwards</ span >
110+ < span class ="sd "> compat.</ span >
106111< span class ="sd "> """</ span >
107- < span class ="n "> event</ span > < span class ="o "> =</ span > < span class ="n "> envelope</ span > < span class ="o "> .</ span > < span class ="n "> get_event</ span > < span class ="p "> ()</ span >
108- < span class ="k "> if</ span > < span class ="n "> event</ span > < span class ="ow "> is</ span > < span class ="ow "> not</ span > < span class ="kc "> None</ span > < span class ="p "> :</ span >
109- < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> capture_event</ span > < span class ="p "> (</ span > < span class ="n "> event</ span > < span class ="p "> )</ span >
110- < span class ="k "> return</ span > < span class ="kc "> None</ span > </ div >
112+ < span class ="k "> raise</ span > < span class ="ne "> NotImplementedError</ span > < span class ="p "> ()</ span > </ div >
111113
112114< div class ="viewcode-block " id ="Transport.flush "> < a class ="viewcode-back " href ="../../api.html#sentry_sdk.Transport.flush "> [docs]</ a > < span class ="k "> def</ span > < span class ="nf "> flush</ span > < span class ="p "> (</ span >
113115 < span class ="bp "> self</ span > < span class ="p "> ,</ span >
@@ -241,7 +243,8 @@ <h1>Source code for sentry_sdk.transport</h1><div class="highlight"><pre>
241243 < span class ="bp "> self</ span > < span class ="p "> ,</ span > < span class ="n "> event</ span > < span class ="c1 "> # type: Event</ span >
242244 < span class ="p "> ):</ span >
243245 < span class ="c1 "> # type: (...) -> None</ span >
244- < span class ="k "> if</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _check_disabled</ span > < span class ="p "> (</ span > < span class ="n "> get_event_data_category</ span > < span class ="p "> (</ span > < span class ="n "> event</ span > < span class ="p "> )):</ span >
246+
247+ < span class ="k "> if</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _check_disabled</ span > < span class ="p "> (</ span > < span class ="s2 "> "error"</ span > < span class ="p "> ):</ span >
245248 < span class ="k "> return</ span > < span class ="kc "> None</ span >
246249
247250 < span class ="n "> body</ span > < span class ="o "> =</ span > < span class ="n "> io</ span > < span class ="o "> .</ span > < span class ="n "> BytesIO</ span > < span class ="p "> ()</ span >
0 commit comments