YfidddlmZddlmZddlmZddlmZmZddl m Z ddl m Z m Z mZddlmZmZddlmZerdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlmZddlmZddlmZddlmZddlm Z ddl!m"Z"ddl m#Z#ddl$m%Z%ddlm&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,ddlm-Z-ddl m.Z.edZ/ndZedZ0dZ1Gdd Z2d!Z3d"Z4ddlmZer Gd#d$e-e2Z5nd%Z5Gd&d'e6Z7Gd(d)ee7Z8e8Z9e0jue9dd*l;ms([[  F   ) ) ++r-ceZdZdZdZdZy) _InitGuardc||_yr))_clientselfr2s r,__init__z_InitGuard.__init__Is  r-c|Sr)r*r:s r, __enter__z_InitGuard.__enter__Ms r-cB|j}||jyyr))r8close)r:exc_type exc_valuetbcs r,__exit__z_InitGuard.__exit__Qs LL = GGI r-N)__name__ __module__ __qualname__r;r>rEr*r-r,r6r6Hsr-r6cyr)r*r*r-r,_check_python_deprecationsrJXs  r-ct|i|}tjj|t t |}|S)zsInitializes the SDK and optionally integrations. This takes the same arguments as the client constructor. )rr0r1 bind_clientrJr6)argskwargsr2rvs r,_initrP`s: T $V $FKKF# F B Ir-c eZdZy)initN)rFrGrHr*r-r,rRrRvs r-rRctSr))rPr*r-r,rT~sEr-c,eZdZedZedZy)HubMetac|tjd}|$tt}tj ||S)z(Returns the current instance of the hub.N)_localgetr0 GLOBAL_HUBset)clsrOs r,r1zHubMeta.currents0ZZ  :ZB JJrN r-ctS)z%Returns the main instance of the hub.)rZ)r\s r,mainz HubMeta.mains r-N)rFrGrHpropertyr1r^r*r-r,rVrVs( r-rVceZdZdZdZdZerdZdZ d$dZ dZ dZ dZ dZ edZed Zd Zd Zd$d Zd$d Zd$dZdZd$dZej2fdZdej2dfdZd%dZe d&dZedZ d'dZdZe d&dZ edZ d'dZ d(dZ!dZ"dZ#dZ$ d$dZ%d Z&d!Z'd&d"Z(d&d#Z)y))r0a .. deprecated:: 2.0.0 The Hub is deprecated. Its functionality will be merged into :py:class:`sentry_sdk.scope.Scope`. The hub wraps the concurrency management of the SDK. Each thread has its own hub but the hub might transfer with the flow of execution if context vars are available. If the hub is used with a with statement it's temporarily activated. Ncd}t|tr[tj}|jtjj }tj j }n%|}tjj||(tj}tj }|tj }||fg|_ d|_ g|_ g|_ g|_ ||_||_yr)) isinstancer0r get_clientget_isolation_scopeforkget_current_scopeget_global_scope set_client_stack_last_event_id _old_hubs_old_current_scopes_old_isolation_scopes_current_scope_scope)r: client_or_hubscope current_scoper2s r,r;z Hub.__init__s mS )%%'F}11388: % 7 7 9 > > @ "F  " " $ / / 7 =--/E!335M  !335M' "#% %'"+ r-c|jjtjtj |t j}|jj|tjj |jt j}|jj|tjj |j|Sr))rkappendr0r1rXr[rrfrlrqrnrdrm_isolation_scopero)r:rrisolation_scopes r,r>z Hub.__enter__s ckk* 4//1    '' 6   !4!45335 ""))/: ""4;;/ r-cF|jj}tj||jj}t j j||jj}t jj|yr)) rkpoprXr[rlrqrnrmru)r:rArBrColdold_current_scopeold_isolation_scopes r,rEz Hub.__exit__sunn  " 3 4488:   !23"88<<> ""#67r-c@|5|cdddS#1swYyxYw)z .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Runs a callback in the context of the hub. Alternatively the with statement can be used on the hub directly. Nr*r:callbacks r,runzHub.runs! :   scHtjj|S)a .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.client._Client.get_integration` instead. Returns the integration for this hub by name or class. If there is no client bound or the client does not have that integration then `None` is returned. If the return value is not `None` the hub is guaranteed to have a client attached. )rrcget_integration)r: name_or_classs r,rzHub.get_integrations !11-@@r-cPtj}|jsy|S)z .. deprecated:: 2.0.0 This property is deprecated and will be removed in a future release. Please use :py:func:`sentry_sdk.api.get_client` instead. Returns the current client on the hub. N)rrc is_activer9s r,r2z Hub.client s&!!#! r-c*tjS)z .. deprecated:: 2.0.0 This property is deprecated and will be removed in a future release. Returns the current scope on the hub. )rrdr=s r,rqz Hub.scopes((**r-cDtjd|jS)a Returns the last event ID. .. deprecated:: 1.40.5 This function is deprecated and will be removed in a future release. The functions `capture_event`, `capture_message`, and `capture_exception` return the event ID directly. zDeprecated: last_event_id is deprecated. This will be removed in the future. The functions `capture_event`, `capture_message`, and `capture_exception` return the event ID directly.)r warningrjr=s r, last_event_idzHub.last_event_id's$  C """r-cJtjj|y)z .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.set_client` instead. Binds a new client to the hub. N)rrgrh)r:news r,rLzHub.bind_client4s  ++C0r-c tjj||fd|i|}|jddk(}| |s||_|S)a .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.capture_event` instead. Captures an event. Alias of :py:meth:`sentry_sdk.Scope.capture_event`. :param event: A ready-made event that can be directly sent to Sentry. :param hint: Contains metadata about the event that can be read from `before_send`, such as the original exception object or a HTTP request object. :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events. The `scope` and `scope_kwargs` parameters are mutually exclusive. :param scope_kwargs: Optional data to apply to event. For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`. The `scope` and `scope_kwargs` parameters are mutually exclusive. rqtype transaction)rrf capture_eventrYrj)r:eventhintrq scope_kwargsris_transactions r,rzHub.capture_eventAs`,@//1?? 4 $ (4 6*m;  $^"/D r-c htjj|f||d|}|||_|S)a .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.capture_message` instead. Captures a message. Alias of :py:meth:`sentry_sdk.Scope.capture_message`. :param message: The string to send as the message to Sentry. :param level: If no level is provided, the default level is `info`. :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events. The `scope` and `scope_kwargs` parameters are mutually exclusive. :param scope_kwargs: Optional data to apply to event. For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`. The `scope` and `scope_kwargs` parameters are mutually exclusive. :returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.client._Client.capture_event`). )levelrq)rrfcapture_messagerj)r:messagerrqrrs r,rzHub.capture_messageasK0B//1AA    1=   $"/D r-c ftjj|fd|i|}|||_|S)a .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.capture_exception` instead. Captures an exception. Alias of :py:meth:`sentry_sdk.Scope.capture_exception`. :param error: An exception to capture. If `None`, `sys.exc_info()` will be used. :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events. The `scope` and `scope_kwargs` parameters are mutually exclusive. :param scope_kwargs: Optional data to apply to event. For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`. The `scope` and `scope_kwargs` parameters are mutually exclusive. :returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.client._Client.capture_event`). rq)rrfcapture_exceptionrj)r:errorrqrrs r,rzHub.capture_exceptionsI,D//1CC   ".   $"/D r-c2tjd|y)a .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.client._Client._capture_internal_exception` instead. Capture an exception that is likely caused by a bug in the SDK itself. Duplicated in :py:meth:`sentry_sdk.client._Client._capture_internal_exception`. These exceptions do not end up in Sentry and are just logged instead. zInternal error in sentry_sdk)exc_infoN)r r)r:rs r,_capture_internal_exceptionzHub._capture_internal_exceptions  3hGr-c Ptjj||fi|y)a .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.add_breadcrumb` instead. Adds a breadcrumb. :param crumb: Dictionary with the data as the sentry v7/v8 protocol expects. :param hint: An optional value that can be used by `before_breadcrumb` to customize the breadcrumbs that are emitted. N)rrdadd_breadcrumb)r:crumbrrNs r,rzHub.add_breadcrumbs$ 3!!#225$I&Ir-c Rtj}|jdd|i|S)aJ .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.start_span` instead. Start a span whose parent is the currently active span or transaction, if any. The return value is a :py:class:`sentry_sdk.tracing.Span` instance, typically used as a context manager to start and stop timing in a `with` block. Only spans contained in a transaction are sent to Sentry. Most integrations start a transaction at the appropriate time, for example for every incoming HTTP request. Use :py:meth:`sentry_sdk.start_transaction` to start a new transaction when one is not already in progress. For supported `**kwargs` see :py:class:`sentry_sdk.tracing.Span`. instrumenterr*)rrf start_span)r:rrNrqs r,rzHub.start_spans-*'')uD\DVDDr-c ^tj}||d<|j|||fi|S)a .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.start_transaction` instead. Start and return a transaction. Start an existing transaction if given, otherwise create and start a new transaction with kwargs. This is the entry point to manual tracing instrumentation. A tree structure can be built by adding child spans to the transaction, and child spans to other spans. To start a new child span within the transaction or any span, call the respective `.start_child()` method. Every child span must be finished before the transaction is finished, otherwise the unfinished spans are discarded. When used as context managers, spans and transactions are automatically finished at the end of the `with` block. If not using context managers, call the `.finish()` method. When the transaction is finished, it will be sent to Sentry with all its finished child spans. For supported `**kwargs` see :py:class:`sentry_sdk.tracing.Transaction`. hub)rrfstart_transaction)r:rrcustom_sampling_contextrNrqs r,rzHub.start_transactionsCH'') u &u&& '> BH  r-cPtjj||||S)a  .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.continue_trace` instead. Sets the propagation context from environment or headers and returns a transaction. )environ_or_headersopnamesource)rrdcontinue_trace)r:rrrrs r,rzHub.continue_trace s.((*991btF:  r-cyr)r*r}s r, push_scopezHub.push_scope r-cyr)r*r}s r,rzHub.push_scoperr-cx|"|j5}||dddyt|S#1swYyxYw)a .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Pushes a new layer on the scope stack. :param callback: If provided, this method pushes a scope, calls `callback`, and pops the scope again. :returns: If no `callback` is provided, a context manager that should be used to pop the scope again. N)rr)r:r~rrqs r,rzHub.push_scope%s>$  " e T""  s 09c`|jj}|jsJd|S)z .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Pops a scope layer from the stack. Try to use the context manager :py:meth:`push_scope` instead. z"stack must have at least one layer)rirx)r:rOs r,pop_scope_unsafezHub.pop_scope_unsafe>s+[[__ {{@@@{ r-cyr)r*r}s r,configure_scopezHub.configure_scopeLrr-cyr)r*r}s r,rzHub.configure_scopeSrr-ctj|rj| |ytfd}|S)aK .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Reconfigures the scope. :param callback: If provided, call the callback with the current scope. :returns: If no callback is provided, returns a context manager that returns the scope. Nc3Kywr)r*rqsr,innerz"Hub.configure_scope..innerusKs )rrdgenerate_propagation_contextr)r:r~rrrqs @r,rzHub.configure_scopeZsO ))+  .E . . 0   UO    wr-cLtjj|y)z .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.start_session` instead. Starts a new session. ) session_modeN)rrd start_session)r:rs r,rzHub.start_session|s# !!#11% 2 r-cHtjjy)z .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.end_session` instead. Ends the current session if there is one. N)rrd end_sessionr=s r,rzHub.end_sessions !!#//1r-cHtjjy)a .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.stop_auto_session_tracking` instead. Stops automatic session tracking. This temporarily session tracking for the current scope when called. To resume session tracking call `resume_auto_session_tracking`. N)rrdstop_auto_session_trackingr=s r,rzHub.stop_auto_session_trackings !!#>>@r-cHtjjy)a} .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.resume_auto_session_tracking` instead. Resumes automatic session tracking for the current scope if disabled earlier. This requires that generally automatic session tracking is enabled. N)rrdresume_auto_session_trackingr=s r,rz Hub.resume_auto_session_trackings !!#@@Br-cLtjj||S)a .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.client._Client.flush` instead. Alias for :py:meth:`sentry_sdk.client._Client.flush` )timeoutr~)rrcflush)r:rr~s r,rz Hub.flushs#!''('KKr-ctj}|j}|$tj}|j}|S)a .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.get_traceparent` instead. Returns the traceparent either from the active span or from the scope. )rrfget_traceparentrd)r:rr traceparentrvs r,rzHub.get_traceparentsH//1 #335  #779O)99;Kr-ctj}|j}|$tj}|j}||j Sy)a .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.get_baggage` instead. Returns Baggage either from the active span or from the scope. N)rrf get_baggagerd serialize)r:rrbaggagervs r,rzHub.get_baggagesY//1 ++- ?#779O%113G  $$& &r-cJtjj|S)a .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.iter_trace_propagation_headers` instead. Return HTTP headers which allow propagation of trace data. Data taken from the span representing the request, if available, or the current span on the scope if not. span)rrfiter_trace_propagation_headersr:rs r,rz"Hub.iter_trace_propagation_headerss)&&(GGH  r-cx|tjdtjj |S)aE .. deprecated:: 2.0.0 This function is deprecated and will be removed in a future release. Please use :py:meth:`sentry_sdk.Scope.trace_propagation_meta` instead. Return meta tags which should be injected into HTML templates to allow propagation of trace information. zaThe parameter `span` in trace_propagation_meta() is deprecated and will be removed in the future.r)r rrrftrace_propagation_metars r,rzHub.trace_propagation_metas@   NNs &&(??@  r-)NN)NNNr))NT) application)*rFrGrH__doc__rirorr1r^r;r>rErrr_r2rqrrLrrrrrrSENTRYrrrrrrrrrrrrrrrrr*r-r,r0r0st F F#J 8 A$ ++ # 1@B>H$J '3&9&9E4!(( $ - ^      #2      F)   2 A C L$*   r-r0rN)= contextlibrsentry_sdk._compatrsentry_sdk.constsrsentry_sdk.scoperrsentry_sdk.clientrsentry_sdk.tracingr r r sentry_sdk.utilsr r sentry_sdk._typesrtypingrrrrrrrrrrrrtyping_extensionsrrsentry_sdk.integrationsrrrr r!r"r#r$r%r&r'rXr4r6rJrPrRrrVr0rZr[ sentry_sdkrqr*r-r,rs%-*1$  ,% (,344 A ( ),     ,  *   Dd$t  . !t  nU  :r-