관리-도구
편집 파일: scope.cpython-38.pyc
U �Mgr� � @ s� d dl Z d dlZd dlZd dlmZ d dlmZ d dlmZ d dlm Z d dl m Z m Z d dl m Z d dlmZ d d lmZ d d lmZmZmZ d d lmZ d d lmZ d d lmZ d dl m Z m Z m Z m Z d dl!m"Z"m#Z#m$Z$m%Z%m&Z& d dl'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/ d dl0m1Z1 e1�r>d dl2m3Z3m4Z4 d dl0m5Z5 d dl0m6Z6 d dl0m7Z7 d dl0m8Z8 d dl0m9Z9 d dl0m:Z: d dl0m;Z; d dl0m<Z< d dl0m=Z= d d l0m>Z> d d l0m?Z? d d l0m@Z@ d d lAmBZB d d lCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZKmLZLmMZM d d!l!mNZN d dlOZOe=d"�ZPe?d#�ZQe?d$e6d%e5f d&�ZRe?d'�ZSdaTe*d(dd)�ZUe*d*dd)�ZVg ZWG d+d,� d,e �ZXG d-d.� d.�ZYd/d0� ZZd1d2� Z[d3d4� Z\G d5d6� d6�Z]ed7d8� �Z^ed9d:� �Z_ed;d(� �Z`ed<d=� �Zad>d?� Zbd d@lcmdZd e1�r�d dlcZOdS )A� N��copy)�deque)�contextmanager)�Enum)�datetime�timezone��wraps)�chain)� Attachment)�DEFAULT_MAX_BREADCRUMBS� FALSE_VALUES� INSTRUMENTER)�!try_autostart_continuous_profiler)�Profile)�Session)�Baggage�has_tracing_enabled�normalize_incoming_data�PropagationContext)�BAGGAGE_HEADER_NAME�SENTRY_TRACE_HEADER_NAME�NoOpSpan�Span� Transaction)�capture_internal_exception�capture_internal_exceptions� ContextVar�datetime_from_isoformat�disable_capture_event�event_from_exception�exc_info_from_error�logger)� TYPE_CHECKING)�Mapping�MutableMapping)�Any)�Callable)�Deque)�Dict)� Generator)�Iterator)�List)�Optional)� ParamSpec)�Tuple)�TypeVar)�Union)�Unpack) � Breadcrumb�BreadcrumbHint�ErrorProcessor�Event�EventProcessor�ExcInfo�Hint� LogLevelStr�SamplingContext�Type)�TransactionKwargs�P�R�F.)�bound�T�isolation_scope)�default� current_scopec @ s e Zd ZdZdZdZdZdS )� ScopeType�currentZ isolation�globalZmergedN)�__name__� __module__� __qualname__�CURRENT� ISOLATION�GLOBAL�MERGED� rQ rQ �>/opt/hc_python/lib/python3.8/site-packages/sentry_sdk/scope.pyrG h s rG c @ s& e Zd Zddd�Zdd� Zdd� ZdS ) � _ScopeManagerNc C s g | _ d S �N)� _old_scopes)�selfZhubrQ rQ rR �__init__p s z_ScopeManager.__init__c C s* t �� }| j�|� |�� }t�|� |S rT )�Scope�get_isolation_scoperU �append�fork�_isolation_scope�set)rV rD � forked_scoperQ rQ rR � __enter__t s z_ScopeManager.__enter__c C s | j �� }t�|� d S rT )rU �popr\ r] )rV �exc_type� exc_value�tbZ old_scoperQ rQ rR �__exit__ s z_ScopeManager.__exit__)N)rJ rK rL rW r_ rd rQ rQ rQ rR rS o s rS c C s t �| � d S rT )�global_event_processorsrZ )� processorrQ rQ rR �add_global_event_processor� s rg c C s t | | jd�S )N)�fset�doc)�property�__doc__��fnrQ rQ rR � _attr_setter� s rn c s t � �� fdd��}|S )Nc s2 | j s d S zd| _ � | f|�|�W �S d| _ X d S )NTF)�_should_capture�rV �args�kwargsrl rQ rR �wrapper� s z!_disable_capture.<locals>.wrapperr )rm rs rQ rl rR �_disable_capture� s rt c @ s� e Zd ZdZdZd�dd�Zdd� Zedd � �Zed d � �Z ed d � �Z edd� �Z edd� �Z edd� �Z d�dd�Zedd� �Zd�dd�Zdd� Zd d � Zd d � Zd�d d!�Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Z d2d3� Z e d4d5� �Z d6d7� Z e d8d9� �Z!e"d:d;� �Z#e#j$d<d;� �Z#d�d=d>�Z%e d?d@� �Z&dAdB� Z'e"dCdD� �Z(e(j$dEdD� �Z(e"dFdG� �Z)e)j$dHdG� �Z)dIdJ� Z*dKdL� Z+dMdN� Z,dOdP� Z-dQdR� Z.dSdT� Z/dUdV� Z0dWdX� Z1d�dZd[�Z2d�d\d]�Z3de4j5dfd^d_�Z6e4j5fd`da�Z7d�dcdd�Z8d�dedf�Z9d�dgdh�Z:d�didj�Z;dkdl� Z<dmdn� Z=dodp� Z>dqdr� Z?dsdt� Z@d�dudv�ZAdwdx� ZBdydz� ZCd{d|� ZDd}d~� ZEdd�� ZFd�d�� ZGd�d�� ZHd�d�� ZId�d�� ZJd�d�� ZKd�d�� ZLd�d�� ZMeNd�d�d���ZOd�d�� ZPd�d�d��ZQd�d�� ZRdS )�rX zaThe scope holds extra information that should be sent with all events that belong to it. )�_level�_name� _fingerprint� _transaction�_transaction_info�_user�_tags� _contexts�_extras� _breadcrumbs�_event_processors�_error_processorsro �_span�_session� _attachments� _force_auto_session_tracking�_profile�_propagation_context�client�_type�_last_event_idNc C sX || _ g | _g | _d | _d | _t� | _|d k r8| �|� | �� | � � }| j |d� d S )N)� incoming_data) r� r r� rv r� �NonRecordingClientr� � set_client�clear�_load_trace_data_from_env� generate_propagation_context)rV �tyr� �incoming_trace_informationrQ rQ rR rW � s zScope.__init__c C s� t �| j�}| j|_| j|_| j|_| j|_| j|_t| j �|_ | j |_ t| j �|_ t| j �|_ t| j �|_ t| j�|_t| j�|_t| j�|_| j|_| j|_| j|_| j|_| j|_t| j�|_| j|_| j|_|S )zs Returns a copy of this scope. This also creates a copy of all referenced data structures. )�object�__new__� __class__r� ru rv rw rx �dictry rz r{ r| r} r r~ �listr r� r� ro r� r� r� r� r� r� )rV �rvrQ rQ rR �__copy__� s. zScope.__copy__c C s* t �� }|dkr&ttjd�}t �|� |S )zM .. versionadded:: 2.0.0 Returns the current scope. N�r� )�_current_scope�getrX rG rM r] )�clsrF rQ rQ rR �get_current_scope� s zScope.get_current_scopec C s t �|� dS )z� .. versionadded:: 2.0.0 Sets the given scope as the new current scope overwriting the existing current scope. :param new_current_scope: The scope to set as the new current scope. N)r� r] )r� Znew_current_scoperQ rQ rR �set_current_scope s zScope.set_current_scopec C s* t �� }|dkr&ttjd�}t �|� |S )zO .. versionadded:: 2.0.0 Returns the isolation scope. Nr� )r\ r� rX rG rN r] )r� rD rQ rQ rR rY s zScope.get_isolation_scopec C s t �|� dS )z� .. versionadded:: 2.0.0 Sets the given scope as the new isolation scope overwriting the existing isolation scope. :param new_isolation_scope: The scope to set as the new isolation scope. N)r\ r] )r� �new_isolation_scoperQ rQ rR �set_isolation_scope' s zScope.set_isolation_scopec C s t dkrttjd�a t S )zL .. versionadded:: 2.0.0 Returns the global scope. Nr� )� _global_scoperX rG rO �r� rQ rQ rR �get_global_scope2 s zScope.get_global_scopec C s | � � jS )a� .. versionadded:: 2.2.0 Returns event ID of the event most recently captured by the isolation scope, or None if no event has been captured. We do not consider events that are dropped, e.g. by a before_send hook. Transactions also are not considered events in this context. The event corresponding to the returned event ID is NOT guaranteed to actually be sent to Sentry; whether the event is sent depends on the transport. The event could be sent later or not at all. Even a sent event could fail to arrive in Sentry due to network issues, exhausted quotas, or various other reasons. )rY r� r� rQ rQ rR � last_event_id@ s zScope.last_event_idc C s� |r|rt d��tdk r tt�nt� }tj|_t�� }|dk rH|� |� t �� }|dk rb|� |� | |kr|| |kr||� | � |dk r�t |�r�||� q�|� |� n|r�|j f |� |S )z� Merges global, isolation and current scope into a new scope and adds the given additional scope or additional scope kwargs to it. z cannot provide scope and kwargsN) � TypeErrorr� r rX rG rP r� r\ r� �update_from_scoper� �callable�update_from_kwargs)rV Zadditional_scopeZadditional_scope_kwargsZ final_scoperD rF rQ rQ rR � _merge_scopesQ s& zScope._merge_scopesc C s� t �� }z |j}W n tk r* d}Y nX |dk r@|�� r@|S t�� }z |j}W n tk rj d}Y nX |dk r�|�� r�|S z tj}W n tk r� d}Y nX |dk r�|�� r�|S t� S )a, .. versionadded:: 2.0.0 Returns the currently used :py:class:`sentry_sdk.Client`. This checks the current scope, the isolation scope and the global scope for a client. If no client is available a :py:class:`sentry_sdk.client.NonRecordingClient` is returned. N)r� r� r� �AttributeError� is_activer\ r� r� )r� rF r� rD rQ rQ rR � get_clients s* zScope.get_clientc C s |dk r |nt � | _dS )z� .. versionadded:: 2.0.0 Sets the client for this scope. :param client: The client to use in this scope. If `None` the client of the scope will be replaced by a :py:class:`sentry_sdk.NonRecordingClient`. N)r� r� )rV r� rQ rQ rR r� � s zScope.set_clientc C s t | �}|S )zP .. versionadded:: 2.0.0 Returns a fork of this scope. r )rV r^ rQ rQ rR r[ � s z Scope.forkc C sp d}t j�d�pd�� }|tk}|rhi }t j�d�rHt j�d�pBd|t< t j�d�rht j�d�pbd|t< |pndS )z� Load Sentry trace id and baggage from environment variables. Can be disabled by setting SENTRY_USE_ENVIRONMENT to "false". NZSENTRY_USE_ENVIRONMENT� Z SENTRY_TRACEZSENTRY_BAGGAGE)�os�environr� �lowerr r r )rV r� Zsentry_use_environmentZuse_environmentrQ rQ rR r� � s � � �z Scope._load_trace_data_from_envc C s t � | _dS )zt Creates a new propagation context and sets it as `_propagation_context`. Overwriting existing one. N)r r� �rV rQ rQ rR �set_new_propagation_context� s z!Scope.set_new_propagation_contextc C s> |r t �|�}|dk r || _| jtjkr:| jdkr:| �� dS )a Makes sure the propagation context is set on the scope. If there is `incoming_data` overwrite existing propagation context. If there is no `incoming_data` create new propagation context, but do NOT overwrite if already existing. N)r Zfrom_incoming_datar� r� rG rM r� )rV r� �propagation_contextrQ rQ rR r� � s z"Scope.generate_propagation_contextc C s2 | j dkrdS | �� }|dk r*|�� | j _| j jS )z� Returns the Dynamic Sampling Context from the Propagation Context. If not existing, creates a new one. N)r� � get_baggage�dynamic_sampling_context)rV �baggagerQ rQ rR � get_dynamic_sampling_context� s �z"Scope.get_dynamic_sampling_contextc O sT | � � }t|j�r&| jdk r&| j�� S | jdk rHd| jj| jjf }|S | �� � � S )z� Returns the Sentry "sentry-trace" header (aka the traceparent) from the currently active span or the scopes Propagation Context. Nz%s-%s) r� r �options�spanZto_traceparentr� �trace_id�span_idrY �get_traceparent)rV rq rr r� � traceparentrQ rQ rR r� � s �zScope.get_traceparentc O s^ | � � }t|j�r&| jdk r&| j�� S | jdk rR| jj}|dkrJt�| �S t|�S | � � � � S )z� Returns the Sentry "baggage" header containing trace information from the currently active span or the scopes Propagation Context. N) r� r r� r� Z to_baggager� r� r Z from_optionsrY r� )rV rq rr r� r� rQ rQ rR r� s � zScope.get_baggagec C s0 | j dkrdS | j j| j j| j j| �� d�}|S )zR Returns the Sentry "trace" context from the Propagation Context. N)r� r� �parent_span_idr� )r� r� r� r� r� )rV Z trace_contextrQ rQ rR �get_trace_context# s �zScope.get_trace_contextc O sj |� dd�}|dk r t�d� d}| �� }|dk rB|dt|f 7 }| �� }|dk rf|dt|�� f 7 }|S )z� Return meta tags which should be injected into HTML templates to allow propagation of trace information. r� NzaThe parameter `span` in trace_propagation_meta() is deprecated and will be removed in the future.r� z <meta name="%s" content="%s">)r` r# �warningr� r r� r � serialize)rV rq rr r� �metaZ sentry_tracer� rQ rQ rR �trace_propagation_meta4 s& ���z Scope.trace_propagation_metac c sN | j dk rJ| �� }|dk r$t|fV | �� }|dk rJt|��� }t|fV dS )zz Creates a generator which returns the `sentry-trace` and `baggage` headers from the Propagation Context. N)r� r� r r� r r� r )rV r� Zdscr� rQ rQ rR � iter_headersR s zScope.iter_headersc o s� | � � }|j�d�sdS |�dd�}|p,| j}t|j�rV|dk rV|�� D ] }|V qHnn| jdk rv| �� D ] }|V qhnN| �� }|jdk r�|�� D ] }|V q�n&| � � }|jdk r�|�� D ] }|V q�dS )z� Return HTTP headers which allow propagation of trace data. If a span is given, the trace data will taken from the span. If no span is given, the trace data is taken from the scope. Zpropagate_tracesNr� ) r� r� r� r` r� r r� r� r� rY )rV rq rr r� r� �headerrF rD rQ rQ rR � iter_trace_propagation_headersa s& z$Scope.iter_trace_propagation_headersc C sD | j d k r| j S | �� }|j d k r(|j S | �� }|j d k r@|j S d S rT )r� r� rY )rV rF rD rQ rQ rR � get_active_propagation_context� s z$Scope.get_active_propagation_contextc C sl d| _ d| _d| _i | _d| _i | _i | _i | _g | _| � � d| _ d| _ d| _ d| _ d| _d| _d| _dS )zClears the entire scope.NT)ru rw rx ry rz r{ r| r} r� �clear_breadcrumbsro r� r� r� r� r� r� r� rQ rQ rR r� � s" z Scope.clearc C s t �d� || _dS )z� When set this overrides the level. .. deprecated:: 1.0.0 Use :func:`set_level` instead. :param value: The level to set. zIDeprecated: use .set_level() instead. This will be removed in the future.N)r# r� ru �rV �valuerQ rQ rR �level� s �z Scope.levelc C s || _ dS )zX Sets the level for the scope. :param value: The level to set. N�ru r� rQ rQ rR � set_level� s zScope.set_levelc C s || _ dS )z0When set this overrides the default fingerprint.N)rw r� rQ rQ rR � fingerprint� s zScope.fingerprintc C s& | j dkrdS | j jdkr dS | j jS )z8Return the transaction (root span) in the scope, if any.N)r� �containing_transactionr� rQ rQ rR � transaction� s zScope.transactionc C s, t �d� || _| jr(| jjr(|| jj_dS )zrWhen set this forces a specific transaction name to be set. Deprecated: use set_transaction_name instead.z`Assigning to scope.transaction directly is deprecated: use scope.set_transaction_name() instead.N)r# r� rx r� r� �namer� rQ rQ rR r� � s �c C s> || _ | jr,| jjr,|| jj_|r,|| jj_|r:|| jd< dS )z?Set the transaction name and optionally the transaction source.�sourceN)rx r� r� r� r� ry )rV r� r� rQ rQ rR �set_transaction_name� s zScope.set_transaction_namec C s | � |� dS )zPWhen set a specific user is bound to the scope. Deprecated in favor of set_user.N)�set_userr� rQ rQ rR �user s z Scope.userc C s( || _ | �� j}|dk r$|j|d� dS )zSets a user for the scope.N)r� )rz rY r� �update)rV r� �sessionrQ rQ rR r� s zScope.set_userc C s | j S )z,Get/set current tracing span or transaction.)r� r� rQ rQ rR r� s z Scope.spanc C s8 || _ t|t�r4|}|jr4|j| _|jr4|j| jd< d S )Nr� )r� � isinstancer r� rx r� ry )rV r� r� rQ rQ rR r� s c C s | j S rT �r� r� rQ rQ rR �profile* s z Scope.profilec C s || _ d S rT r� )rV r� rQ rQ rR r� / s c C s || j |< dS )z� Sets a tag for a key to a specific value. :param key: Key of the tag to set. :param value: Value of the tag to set. N)r{ �rV �keyr� rQ rQ rR �set_tag5 s z Scope.set_tagc C s | j �|� dS )a� Sets multiple tags at once. This method updates multiple tags at once. The tags are passed as a dictionary or other mapping type. Calling this method is equivalent to calling `set_tag` on each key-value pair in the mapping. If a tag key already exists in the scope, its value will be updated. If the tag key does not exist in the scope, the key-value pair will be added to the scope. This method only modifies tag keys in the `tags` mapping passed to the method. `scope.set_tags({})` is, therefore, a no-op. :param tags: A mapping of tag keys to tag values to set. N)r{ r� )rV �tagsrQ rQ rR �set_tags@ s zScope.set_tagsc C s | j �|d� dS )zX Removes a specific tag. :param key: Key of the tag to remove. N)r{ r` �rV r� rQ rQ rR � remove_tagS s zScope.remove_tagc C s || j |< dS )zG Binds a context at a certain key to a specific value. N)r| r� rQ rQ rR � set_context\ s zScope.set_contextc C s | j �|d� dS )zRemoves a context.N)r| r` r� rQ rQ rR �remove_contextg s zScope.remove_contextc C s || j |< dS )z&Sets an extra key to a specific value.N)r} r� rQ rQ rR � set_extran s zScope.set_extrac C s | j �|d� dS )z Removes a specific extra key.N)r} r` r� rQ rQ rR � remove_extraw s zScope.remove_extrac C s t � | _dS )zClears breadcrumb buffer.N)r r~ r� rQ rQ rR r� ~ s zScope.clear_breadcrumbsFc C s | j �t|||||d�� dS )z�Adds an attachment to future events sent from this scope. The parameters are the same as for the :py:class:`sentry_sdk.attachments.Attachment` constructor. )�bytes�path�filename� content_type�add_to_transactionsN)r� rZ r )rV r� r� r� r� r� rQ rQ rR �add_attachment� s ��zScope.add_attachmentc K s� | � � }|�� s t�d� dS |j�d�}|j�dt�}t|p@d�}|�|� |sVdS t|p^d�}|�d�dkr�t � t j �|d< |�d�dkr�d|d< |dk r�|||�}n|}|dk r�| j �|� n t�d |� t| j �|kr�| j �� q�dS ) a 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. z*Dropped breadcrumb because no client boundN�before_breadcrumb�max_breadcrumbsrQ � timestamp�typerE z)before breadcrumb dropped breadcrumb (%s))r� r� r# �infor� r� r r� r� r �nowr �utcr~ rZ �len�popleft)rV �crumb�hintrr r� r� r� Z new_crumbrQ rQ rR �add_breadcrumb� s. zScope.add_breadcrumbc K s� |� d| � | �� }|jd }||kr,t� S t� |p8i }|}|dkrPtf |�}|�� |jd�}|�|� |j |d� |j r�t |j |j �} | j |d� | |_ |jd �d�p�d} |j| d � |S ) a� 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. :param transaction: The transaction to start. If omitted, we create and start a new transaction. :param instrumenter: This parameter is meant for internal use only. It will be removed in the next major version. :param custom_sampling_context: The transaction's custom sampling context. :param kwargs: Optional keyword arguments to be passed to the Transaction constructor. See :py:class:`sentry_sdk.tracing.Transaction` for available arguments. �scope� instrumenterN)Ztransaction_context�parent_sampled)�sampling_contextZ _experiments� max_spansi� )�maxlen)� setdefaultr� r� r r r �to_jsonr� r� Z _set_initial_sampling_decisionZsampledr Z _start_timestamp_monotonic_nsr� r� Zinit_span_recorder) rV r� r� Zcustom_sampling_contextrr r� �configuration_instrumenterZtransaction_kwargsr� r� r� rQ rQ rR �start_transaction� s2 ' � � zScope.start_transactionc K s� |� d�dk r tjdtdd� t� �� |�d| � | �� }|jd }||kr^t� W 5 Q R � S | j pl| � � j }|dkr�d|kr�| � � }|dk r�|j |d< t f |�}n |jf |�}|W 5 Q R � S Q R X dS ) aO 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`. The instrumenter parameter is deprecated for user code, and it will be removed in the next major version. Going forward, it should only be used by the SDK itself. � descriptionNzEThe `description` parameter is deprecated. Please use `name` instead.� )� stacklevelr� r� r� )r� �warnings�warn�DeprecationWarning� new_scoper� r� r� r r� rY r� r� r Z start_child)rV r� rr r� r r� r� rQ rQ rR � start_span s* � zScope.start_span�manualc C s& | � |� tjt|�||||d�}|S )ze Sets the propagation context from environment or headers and returns a transaction. )�op�originr� r� )r� r Zcontinue_from_headersr )rV Zenviron_or_headersr r� r� r r� rQ rQ rR �continue_traceQ s �zScope.continue_tracec K sR t �d�rdS | �||�}| �� j|||d�}|dk rN|�d�dkrN|| �� _|S )a} Captures an event. Merges given scope data and calls :py:meth:`sentry_sdk.client._Client.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. :returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.client._Client.capture_event`). FN)�eventr� r� r� r� )r r� r� r� � capture_eventrY r� )rV r r� r� � scope_kwargsZevent_idrQ rQ rR r d s zScope.capture_eventc K s: t �d�rdS |dkrd}||d�}| j|fd|i|��S )a� Captures a message. :param message: The string to send as the message. :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`). FNr� )�messager� r� )r r� r )rV r r� r� r r rQ rQ rR �capture_message� s �zScope.capture_messagec K s~ t �d�rdS |dk r t|�}nt�� }t|| �� jd�\}}z| j|f||d�|��W S t k rx t t�� � Y nX dS )a� Captures an 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`). FN)Zclient_options)r� r� ) r r� r" �sys�exc_infor! r� r� r � Exceptionr )rV �errorr� r r r r� rQ rQ rR �capture_exception� s � zScope.capture_exceptionc O sD |� dd�}| �� | �� }t|j�d�|j�d�| j|d�| _dS )zStarts a new session.� session_modeZ application�release� environment)r r r� r N)r` � end_sessionr� r r� r� rz r� )rV rq rr r r� rQ rQ rR � start_session� s �zScope.start_sessionc O s. | j }d| _ |dk r*|�� | �� �|� dS )z)Ends the current session if there is one.N)r� �closer� Zcapture_session)rV rq rr r� rQ rQ rR r � s zScope.end_sessionc O s | � � d| _dS )z�Stops automatic session tracking. This temporarily session tracking for the current scope when called. To resume session tracking call `resume_auto_session_tracking`. FN)r r� rp rQ rQ rR �stop_auto_session_tracking� s z Scope.stop_auto_session_trackingc C s d| _ dS )z�Resumes automatic session tracking for the current scope if disabled earlier. This requires that generally automatic session tracking is enabled. N)r� r� rQ rQ rR � resume_auto_session_tracking� s z"Scope.resume_auto_session_trackingc C s8 t | j�dkr(t�d| j� | jdd�= | j�|� dS )z}Register a scope local event processor on the scope. :param func: This function behaves like `before_send.` � zLToo many event processors on scope! Clearing list to free up some memory: %rN)r� r r# r� rZ )rV �funcrQ rQ rR �add_event_processor� s � zScope.add_event_processorc s. |dk r |� |�� �fdd�}| j �|� dS )a Register a scope local error processor on the scope. :param func: A callback that works similar to an event processor but is invoked with the original exception info triple as second argument. :param cls: Optionally, only process exceptions of this type. Nc s> zt |d � �}W n tk r* d}Y nX |r:�| |�S | S )N� F)r� r )r r Zis_inst�Zcls_Z real_funcrQ rR r! s z'Scope.add_error_processor.<locals>.func)r� rZ )rV r! r� rQ r$ rR �add_error_processor s zScope.add_error_processorc C s | j d k r| j |d< d S )Nr� r� �rV r r� r� rQ rQ rR �_apply_level_to_event s zScope._apply_level_to_eventc C s� |� di �� dg ��| j� zL|d d D ]"}t|d t�r*t|d �|d< q*|d d jdd� d� W n0 tk r� } ztj d|d� W 5 d }~X Y nX d S ) NZ breadcrumbs�valuesr� c S s | d S )Nr� rQ )r� rQ rQ rR �<lambda>. � z3Scope._apply_breadcrumbs_to_event.<locals>.<lambda>)r� z Error when sorting breadcrumbs)r ) r� �extendr~ r� �strr �sortr r# �debug)rV r r� r� r� �errrQ rQ rR �_apply_breadcrumbs_to_event" s � z!Scope._apply_breadcrumbs_to_eventc C s& |� d�d kr"| jd k r"| j|d< d S )Nr� )r� rz r& rQ rQ rR �_apply_user_to_event3 s zScope._apply_user_to_eventc C s& |� d�d kr"| jd k r"| j|d< d S )Nr� )r� rx r& rQ rQ rR � _apply_transaction_name_to_event8 s z&Scope._apply_transaction_name_to_eventc C s& |� d�d kr"| jd k r"| j|d< d S )NZtransaction_info)r� ry r& rQ rQ rR � _apply_transaction_info_to_event= s z&Scope._apply_transaction_info_to_eventc C s& |� d�d kr"| jd k r"| j|d< d S )Nr� )r� rw r& rQ rQ rR �_apply_fingerprint_to_eventB s z!Scope._apply_fingerprint_to_eventc C s | j r|�di ��| j � d S )N�extra)r} r� r� r& rQ rQ rR �_apply_extra_to_eventG s zScope._apply_extra_to_eventc C s | j r|�di ��| j � d S )Nr� )r{ r� r� r& rQ rQ rR �_apply_tags_to_eventL s zScope._apply_tags_to_eventc C sf | j r|�di ��| j � |�di �}|�d�d krbt|�rV| jd k rV| j�� |d< n | �� |d< d S )N�contexts�trace)r| r� r� r� r r� r� )rV r r� r� r8 rQ rQ rR �_apply_contexts_to_eventQ s z Scope._apply_contexts_to_eventc C s t �d||� d S )Nz%s (%s) dropped event)r# r� )rV �causer� rQ rQ rR �_drop_ s z Scope._dropc C sd |� d�}|dk r`t| �� j| �� j| �� j�}|D ]*}|||�}|dkrZ| �|d� S |}q4|S )zX Runs the error processors on the event and returns the modified event. r Nzerror processor)r� r r� r� rY r� r< )rV r r� r Zerror_processorsZerror_processor� new_eventrQ rQ rR �run_error_processorsd s � zScope.run_error_processorsc C s� |� d�}|dk}|s�t� � }t� � }tttr4tjp6g |r@|jpBg |rL|jpNg �}|D ]@}|} t� � |||�} W 5 Q R X | dkr�| �|d� S | }qV|S )zX Runs the event processors on the event and returns the modified event. r� �check_inNzevent processor) r� r\ r� r re r� r r r< ) rV r r� r� � is_check_inrD rF Zevent_processorsZevent_processorr= rQ rQ rR �run_event_processorsz s& �zScope.run_event_processorsc C s2 |� d�}|dk}|dk}|� d�p&g }| jD ]}|r<|jr.|�|� q.||d< | �|||� |r~d|�di �� di �i|d< |s�| �|||� | �|||� | �|||� | � |||� | � |||� | � |||� | � |||� |s�|s�| � |||� | �||�}|dk�rdS | �||�}|dk�r.dS |S )zBApplies the information contained on the scope to the given event.r� r� r? � attachmentsr9 r8 N)r� r� r� rZ r: r� r' r4 r1 r2 r3 r7 r6 r0 r> rA ) rV r r� r� r� Zis_transactionr@ Zattachments_to_send� attachmentrQ rQ rR �apply_to_event� s< � zScope.apply_to_eventc C s |j dk r|j | _ |jdk r$|j| _|jdk r6|j| _|jdk rN| j�|j� |jdk r`|j| _|jrt| j�|j� |jr�| j�|j� |jr�| j�|j� |j r�| j � |j � |j r�|j | _ |j r�| j � |j � |j r�|j | _ |jr�|j| _|jr�|j| _dS )z+Update the scope with another scope's data.N)ru rw rx ry r� rz r{ r| r} r~ r+ r� r� r� r� r� )rV r� rQ rQ rR r� � s8 zScope.update_from_scopec C sj |dk r|| _ |dk r || _|dk r0| j�|� |dk rD| j�|� |dk rX| j�|� |dk rf|| _dS )z Update the scope's attributes.N)ru rz r} r� r| r{ rw )rV r� r� �extrasr8 r� r� rQ rQ rR r� � s zScope.update_from_kwargsc C s d| j jtt| ��| j| jf S )Nz<%s id=%s name=%s type=%s>)r� rJ �hex�idrv r� r� rQ rQ rR �__repr__ s �zScope.__repr__)NN)NN)N)N)N)NNNNF)NN)NNNr )NN)NN)NN)N)N)NNNNNN)SrJ rK rL rk � __slots__rW r� � classmethodr� r� rY r� r� r� r� r� r� r[ r� r� r� r� r� r� r� r� r� r� r� r� rn r� r� r� rj r� �setterr� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r ZSENTRYr r r r r r r r r r r" r% r' r0 r1 r2 r3 r4 r6 r7 r: r< r> rA rt rD r� r� rH rQ rQ rQ rR rX � s� % " % % � .� T8 � " � � 3" � rX c c s6 t �� } | �� }t�|�}z |V W 5 t�|� X dS )a .. versionadded:: 2.0.0 Context manager that forks the current scope and runs the wrapped code in it. After the wrapped code is executed, the original scope is restored. Example Usage: .. code-block:: python import sentry_sdk with sentry_sdk.new_scope() as scope: scope.set_tag("color", "green") sentry_sdk.capture_message("hello") # will include `color` tag. sentry_sdk.capture_message("hello, again") # will NOT include `color` tag. N)rX r� r[ r� r] �reset)rF r �tokenrQ rQ rR r s r c c s& t �| �}z | V W 5 t �|� X dS )ag .. versionadded:: 2.0.0 Context manager that uses the given `scope` and runs the wrapped code in it. After the wrapped code is executed, the original scope is restored. Example Usage: Suppose the variable `scope` contains a `Scope` object, which is not currently the active scope. .. code-block:: python import sentry_sdk with sentry_sdk.use_scope(scope): scope.set_tag("color", "green") sentry_sdk.capture_message("hello") # will include `color` tag. sentry_sdk.capture_message("hello, again") # will NOT include `color` tag. N)r� r] rL )r� rM rQ rQ rR � use_scope1 s rN c c sZ t �� } | �� }t�|�}t �� }|�� }t�|�}z |V W 5 t�|� t�|� X dS )am .. versionadded:: 2.0.0 Context manager that forks the current isolation scope and runs the wrapped code in it. The current scope is also forked to not bleed data into the existing current scope. After the wrapped code is executed, the original scopes are restored. Example Usage: .. code-block:: python import sentry_sdk with sentry_sdk.isolation_scope() as scope: scope.set_tag("color", "green") sentry_sdk.capture_message("hello") # will include `color` tag. sentry_sdk.capture_message("hello, again") # will NOT include `color` tag. N)rX r� r[ r� r] rY r\ rL )rF �forked_current_scope� current_tokenrD r� �isolation_tokenrQ rQ rR rD T s c c sJ t �� }|�� }t�|�}t�| �}z | V W 5 t�|� t�|� X dS )al .. versionadded:: 2.0.0 Context manager that uses the given `isolation_scope` and runs the wrapped code in it. The current scope is also forked to not bleed data into the existing current scope. After the wrapped code is executed, the original scopes are restored. Example Usage: .. code-block:: python import sentry_sdk with sentry_sdk.isolation_scope() as scope: scope.set_tag("color", "green") sentry_sdk.capture_message("hello") # will include `color` tag. sentry_sdk.capture_message("hello, again") # will NOT include `color` tag. N)rX r� r[ r� r] r\ rL )rD rF rO rP rQ rQ rQ rR �use_isolation_scope~ s rR c C s t �� �� S )z<Shortcut for `Scope.get_client().should_send_default_pii()`.)rX r� �should_send_default_piirQ rQ rQ rR rS � s rS )r� )er� r r r � collectionsr � contextlibr �enumr r r � functoolsr � itertoolsr Zsentry_sdk.attachmentsr Zsentry_sdk.constsr r r Z'sentry_sdk.profiler.continuous_profilerr Z(sentry_sdk.profiler.transaction_profilerr Zsentry_sdk.sessionr Zsentry_sdk.tracing_utilsr r r r Zsentry_sdk.tracingr r r r r Zsentry_sdk.utilsr r r r r r! r" r# �typingr$ �collections.abcr% r& r' r( r) r* r+ r, r- r. r/ r0 r1 r2 �typing_extensionsr3 Zsentry_sdk._typesr4 r5 r6 r7 r8 r9 r: r; r< r= r> Z sentry_sdkr? r@ rA rC r� r\ r� re rG rS rg rn rt rX r rN rD rR rS Zsentry_sdk.clientr� rQ rQ rQ rR �<module> s� ( 0 y " " ) '