
    Uvh              
          d dl mZ d dlZd dlZd dlmZmZmZ d dlmZ d dl	Z	d dl
mZmZmZ d dlmZ d dlmZmZmZmZmZ d dlmZ erd d	lmZmZmZ d d
lmZ d dlmZ d dlmZ d dlmZ d dlm Z  d dlm!Z! d dlm"Z" d dlm#Z# d dlm$Z$ d dlm%Z% d dl&m'Z'm(Z(  e"d      Z) e%d      Z*d dlm+Z+ d dl,m-Z- d dl.m/Z/m0Z0m1Z1m2Z2  G d de'd      Z3 G d de3d      Z4 e'd d!e5i      Z6d"Z7d#Z8 G d$ d%e5e      Z9e9jt                  gZ;e9jx                  e9jx                  e9jx                  e9jz                  e9jt                  e9jx                  e9jz                  e9jz                  e9jz                  d&	Z>d' Z? G d( d)      Z@ G d* d+      ZA G d, d-eA      ZB G d. d/eA      ZCere!d6d0       ZDe!d1        ZDd6d2ZDd d3lEmFZFmGZGmHZHmIZImJZJmKZK  ej                         5   ej                  d4eN       d d5lOmPZP ddd       y# 1 sw Y   yxY w)7    )DecimalN)datetime	timedeltatimezone)Enum)INSTRUMENTER
SPANSTATUSSPANDATA)get_profiler_id)get_current_thread_metais_valid_sample_rateloggernanosecond_timeshould_be_treated_as_error)TYPE_CHECKING)CallableMappingMutableMapping)Any)Dict)Iterator)List)Optional)overload)	ParamSpec)Tuple)Union)TypeVar)	TypedDictUnpackPR)ContinuousProfile)Profile)EventMeasurementUnitSamplingContextMeasurementValuec                       e Zd ZU eed<   	 eed<   	 eed<   	 eed<   	 eed<   	 eed<   	 eed<   	 ed   ed	<   	 eed
<   	 ed   ed<   	 eeee	f      ed<   	 ded<   	 eed<   	 eed<   y)
SpanKwargstrace_idspan_idparent_span_idsame_process_as_parentsampledopdescriptionzsentry_sdk.HubhubstatusTransactioncontaining_transactionstart_timestampzsentry_sdk.ScopescopeoriginnameN)
__name__
__module____qualname__str__annotations__boolr   r   r   float     M/opt/face_recognition/venv/lib/python3.12/site-packages/sentry_sdk/tracing.pyr*   r*   0   s    	
 T< $$J	
 	
  	Y&''sr ( 778!%%"899	
 "!X	 	`rB   r*   F)totalc                   0    e Zd ZU eed<   	 eed<   	 ded<   y)TransactionKwargssourceparent_sampledBaggagebaggageN)r:   r;   r<   r=   r>   r?   rA   rB   rC   rF   rF   k   s     	 PrB   rF   ProfileContextprofiler_idrJ   zsentry-tracec                   *    e Zd ZdZdZdZdZdZdZd Z	y)	TransactionSource	componentcustomroutetaskurlviewc                     | j                   S N)valueselfs    rC   __str__zTransactionSource.__str__   s    zzrB   N)
r:   r;   r<   	COMPONENTCUSTOMROUTETASKURLVIEWrZ   rA   rB   rC   rN   rN      s%    IFED
CDrB   rN   )	endpointfunction_namehandler_namemethod_and_path_patternpath
route_nameroute_patternuri_templaterS   c                 \   | dk  rt         j                  S d| cxk  rdk  rn n| dk(  rt         j                  S | dk(  rt         j                  S | dk(  rt         j                  S | dk(  rt         j
                  S | dk(  rt         j                  S | dk(  rt         j                  S t         j                  S d| cxk  rd	k  ran t         j                  S | d
k(  rt         j                  S | dk(  rt         j                  S | dk(  rt         j                  S t         j                  S t         j                  S )z
    Returns the Sentry status corresponding to the given HTTP status code.

    See: https://develop.sentry.dev/sdk/event-payloads/contexts/#trace-context
    i  i  i  i  i  i  i  i  iX  i  i  i  )r	   OKPERMISSION_DENIED	NOT_FOUNDRESOURCE_EXHAUSTEDFAILED_PRECONDITIONUNAUTHENTICATEDALREADY_EXISTSINVALID_ARGUMENTDEADLINE_EXCEEDEDUNIMPLEMENTEDUNAVAILABLEINTERNAL_ERRORUNKNOWN_ERROR)http_status_codes    rC   get_span_status_from_http_coderx      s    #}}	 	&3	&s"///$'''$000$111$---$,,,...	 	&3	& ### s"///$+++$))),,,###rB   c                        e Zd ZdZdZd Zd Zy)_SpanRecorderz5Limits the number of spans recorded in a transaction.maxlenspansdropped_spansc                 4    |dz
  | _         g | _        d| _        y )N   r   r{   rY   r|   s     rC   __init__z_SpanRecorder.__init__   s     qj
rB   c                     t        | j                        | j                  kD  rd |_        | xj                  dz  c_        y | j                  j                  |       y )Nr   )lenr}   r|   _span_recorderr~   append)rY   spans     rC   addz_SpanRecorder.add   sA    tzz?T[[("&D!#JJd#rB   N)r:   r;   r<   __doc__	__slots__r   r   rA   rB   rC   rz   rz      s    ?4I	$rB   rz   c                   $   e Zd ZdZdZ	 	 	 	 	 	 	 	 	 	 	 	 	 	 d!dZd Zd Zd Zd Z	d	 Z
ed
        Zej                  fdZed        Zeddd       Zd Zed        Zd Zd Zd Zd Zd Zd Zd"dZd Zd Zd Zd Zd#dZ d Z!d Z"d Z#d  Z$y)$Spanak  A span holds timing information of a block of code.
    Spans can have multiple child spans thus forming a span tree.

    :param trace_id: The trace ID of the root span. If this new span is to be the root span,
        omit this parameter, and a new trace ID will be generated.
    :param span_id: The span ID of this span. If omitted, a new span ID will be generated.
    :param parent_span_id: The span ID of the parent span, if applicable.
    :param same_process_as_parent: Whether this span is in the same process as the parent span.
    :param sampled: Whether the span should be sampled. Overrides the default sampling decision
        for this span when provided.
    :param op: The span's operation. A list of recommended values is available here:
        https://develop.sentry.dev/sdk/performance/span-operations/
    :param description: A description of what operation is being performed within the span.

        .. deprecated:: 2.15.0
            Please use the `name` parameter, instead.
    :param name: A string describing what operation is being performed within the span.
    :param hub: The hub to use for this span.

        .. deprecated:: 2.0.0
            Please use the `scope` parameter, instead.
    :param status: The span's status. Possible values are listed at
        https://develop.sentry.dev/sdk/event-payloads/span/
    :param containing_transaction: The transaction that this span belongs to.
    :param start_timestamp: The timestamp when the span started. If omitted, the current time
        will be used.
    :param scope: The scope to use for this span. If not provided, we use the current scope.
    )r+   r,   r-   r.   r/   r0   r1   _measurementsr6   _start_timestamp_monotonic_nsr3   	timestamp_tags_datar   r2   _context_manager_state_containing_transaction_local_aggregatorr7   r8   r9   _flags_flags_capacityNc                 v   |xs t        j                         j                  | _        |xs! t        j                         j                  dd  | _        || _        || _        || _        || _        |xs || _	        |	| _
        || _        || _        || _        i | _        i | _        i | _        |
| _        i | _        d| _        |;t)        j*                  dt,        d       | j                  xs |j                  | _        |$t/        j0                  t2        j4                        }n4t7        |t8              r$t/        j:                  |t2        j4                        }|| _        	 t?               | _         d | _"        d | _#        d | _$        | jK                          | jM                  tO                      y # tB        $ r Y Jw xY w)N   
   z>The `hub` parameter is deprecated. Please use `scope` instead.   
stacklevel)(uuiduuid4hexr+   r,   r-   r.   r/   r0   r1   r3   r2   r7   r8   r   r   r   r   r   r   warningswarnDeprecationWarningr   nowr   utc
isinstancer@   fromtimestampr6   r   r   AttributeErrorr   r   r   update_active_threadset_profiler_idr   )rY   r+   r,   r-   r.   r/   r0   r1   r2   r3   r5   r6   r7   r8   r9   s                  rC   r   zSpan.__init__  s|   $ !4DJJL$4$47$**,"2"223"7,&<#.;


'=$!?MMP" 0syyDJ"&ll8<<8O/&44_hllSO.	 2A1BD.
 "!%!!#_./  		s   F, ,	F87F8c                 >    | j                   t        |      | _         y y rV   )r   rz   r   s     rC   init_span_recorderzSpan.init_span_recorderb  s     &"/"7D 'rB   c                 D    | j                   }|t               x}| _         |S rV   )r   LocalAggregator)rY   rvs     rC   _get_local_aggregatorzSpan._get_local_aggregatorg  s'    ##:*9*;;B'	rB   c                     d| j                   j                  d| j                  d| j                  d| j                  d| j
                  d| j                  d| j                  d| j                  d	S )
N<z(op=z, description:, trace_id=
, span_id=, parent_span_id=
, sampled=	, origin=)>)		__class__r:   r0   r1   r+   r,   r-   r/   r8   rX   s    rC   __repr__zSpan.__repr__n  sP    
 ''  ##
	
rB   c                     | j                   xs t        j                         }|j                  }| |_        ||f| _        | S rV   )r7   
sentry_sdkget_current_scoper   r   )rY   r7   old_spans      rC   	__enter__zSpan.__enter__~  s;    

<j::<::
',h&7#rB   c                     |+t        ||      r| j                  t        j                         | j                  \  }}| `| j                  |       ||_        y rV   )r   
set_statusr	   ru   r   finishr   )rY   tyrW   tbr7   r   s         rC   __exit__zSpan.__exit__  sL    !;B!FOOJ55655x'E
rB   c                     | j                   S )zThe ``Transaction`` that this span belongs to.
        The ``Transaction`` is the root of the span tree,
        so one could also think of this ``Transaction`` as the "root span".)r   rX   s    rC   r5   zSpan.containing_transaction  s     +++rB   c                    |j                  d      t        j                  dt        d       t	        j
                         j                  d   }||k7  r
t               S |j                  d| j                         t        d| j                  | j                  | j                  d|}| j                  xr | j                  j                  }|r|j                  |       |S )	a  
        Start a sub-span from the current span or transaction.

        Takes the same arguments as the initializer of :py:class:`Span`. The
        trace id, sampling decision, transaction pointer, and span recorder are
        inherited from the current span/transaction.

        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.
        r1   zEThe `description` parameter is deprecated. Please use `name` instead.r   r   instrumenterr/   )r+   r-   r5   rA   )getr   r   r   r   
get_clientoptionsNoOpSpan
setdefaultr/   r   r+   r,   r5   r   r   )rY   r   kwargsconfiguration_instrumenterchildspan_recorders         rC   start_childzSpan.start_child  s     ::m$0MMW" &0%:%:%<%D%D^%T"55:)T\\2 
]]<<#'#>#>
 	
 ''VD,G,G,V,V 	 e$rB   c                 z    | t         u rt        j                  d       t        j                  t        |      fi |S )a(  
        Create a Transaction with the given params, then add in data pulled from
        the ``sentry-trace`` and ``baggage`` headers from the environ (if any)
        before returning the Transaction.

        This is different from :py:meth:`~sentry_sdk.tracing.Span.continue_from_headers`
        in that it assumes header names in the form ``HTTP_HEADER_NAME`` -
        such as you would get from a WSGI/ASGI environ -
        rather than the form ``header-name``.

        :param environ: The ASGI/WSGI environ to pull information from.
        zXDeprecated: use Transaction.continue_from_environ instead of Span.continue_from_environ.)r   r   warningr4   continue_from_headersEnvironHeaders)clsenvironr   s      rC   continue_from_environzSpan.continue_from_environ  s9    & $;NN9 001HSFSSrB   _sample_randc                h   | t         u rt        j                  d       t        j                  |j                  t              |      }|j                  t        |i       t        |j                  t                    }|!|j                  |       |j                          t        di |}d|_        |S )a  
        Create a transaction with the given params (including any data pulled from
        the ``sentry-trace`` and ``baggage`` headers).

        :param headers: The dictionary with the HTTP headers to pull information from.
        :param _sample_rand: If provided, we override the sample_rand value from the
            incoming headers with this value. (internal use only)
        zXDeprecated: use Transaction.continue_from_headers instead of Span.continue_from_headers.r   FrA   )r   r   r   rI   from_incoming_headerr   BAGGAGE_HEADER_NAMEupdateextract_sentrytrace_dataSENTRY_TRACE_HEADER_NAMEfreezer4   r.   )r   headersr   r   rJ   sentrytrace_kwargstransactions          rC   r   zSpan.continue_from_headers  s    $ $;NN9 ..KK+,<
 	*G455KK01
 )MM,-
 NN!+F+-2*rB   c              #      K   | j                   syt        | j                         f | j                   j                         j	                         }|rt
        |f yyw)z
        Creates a generator which returns the span's ``sentry-trace`` and ``baggage`` headers.
        If the span's containing transaction doesn't yet have a ``baggage`` value,
        this will cause one to be generated and stored.
        N)r5   r   to_traceparentget_baggage	serializer   )rY   rJ   s     rC   iter_headerszSpan.iter_headers  sZ      **
 &(;(;(===--99;EEG%w.. s   AAc                 d    t        j                  d       |sy | j                  t        |ifi |S )a  
        DEPRECATED: Use :py:meth:`sentry_sdk.tracing.Span.continue_from_headers`.

        Create a ``Transaction`` with the given params, then add in data pulled from
        the given ``sentry-trace`` header value before returning the ``Transaction``.
        zwDeprecated: Use Transaction.continue_from_headers(headers, **kwargs) instead of from_traceparent(traceparent, **kwargs)N)r   r   r   r   )r   traceparentr   s      rC   from_traceparentzSpan.from_traceparent$  sC     	A	

 (s((%{3
7=
 	
rB   c                     | j                   du rd}n| j                   du rd}nd }| j                  d| j                  }||d|z  }|S )NT1F0-)r/   r+   r,   )rY   r/   r   s      rC   r   zSpan.to_traceparent=  sT    <<4G\\U"GG!%=G--KrB   c                 P    | j                   r| j                   j                         S y)zReturns the :py:class:`~sentry_sdk.tracing_utils.Baggage`
        associated with this ``Span``, if any. (Taken from the root of the span tree.)
        N)r5   r   rX   s    rC   
to_baggagezSpan.to_baggageL  s%    
 &&..::<<rB   c                 "    || j                   |<   y rV   )r   rY   keyrW   s      rC   set_tagzSpan.set_tagU      

3rB   c                 "    || j                   |<   y rV   )r   r   s      rC   set_datazSpan.set_dataY  r   rB   c                 h    t        | j                        | j                  k  r|| j                  |<   y y rV   )r   r   r   )rY   flagresults      rC   set_flagzSpan.set_flag]  s,    t{{d222 &DKK 3rB   c                     || _         y rV   r3   rY   rW   s     rC   r   zSpan.set_statusb  s	    rB   c                 `    t        j                  dt        d       ||d| j                  |<   yz
        .. deprecated:: 2.28.0
            This function is deprecated and will be removed in the next major release.
        zq`set_measurement()` is deprecated and will be removed in the next major version. Please use `set_data()` instead.r   r   )rW   unitNr   r   r   r   rY   r9   rW   r  s       rC   set_measurementzSpan.set_measurementf  0     		

 .3D#A4 rB   c                     |M| j                  t        j                  t        |             |!| j                  t        j                  |       y y y rV   )r   r
   	THREAD_IDr=   THREAD_NAMErY   	thread_idthread_names      rC   
set_threadzSpan.set_threadt  sF      MM(,,c)n=&h22K@ ' !rB   c                 J    |!| j                  t        j                  |       y y rV   )r   r
   PROFILER_IDrY   rL   s     rC   r   zSpan.set_profiler_id}  s!    "MM(..< #rB   c                     | j                  dt        |             | j                  t        j                  |       | j                  t        |             y )Nzhttp.status_code)r   r=   r   r
   HTTP_STATUS_CODEr   rx   rY   http_statuss     rC   set_http_statuszSpan.set_http_status  s@    K 0	
 	h//=6{CDrB   c                      | j                   dk(  S )Nokr   rX   s    rC   
is_successzSpan.is_success  s    {{d""rB   c                    | j                   y	 |r<t        |t              r$t        j                  |t
        j                        }|| _         n8t               | j                  z
  }| j                  t        |dz        z   | _         |xs t        j                         }t        ||        y# t        $ r+ t        j                  t
        j                        | _         Y Xw xY w)aD  
        Sets the end timestamp of the span.

        Additionally it also creates a breadcrumb from the span,
        if the span represents a database or HTTP request.

        :param scope: The scope to use for this transaction.
            If not provided, the current scope will be used.
        :param end_timestamp: Optional timestamp that should
            be used as timestamp instead of the current time.

        :return: Always ``None``. The type is ``Optional[str]`` to match
            the return value of :py:meth:`sentry_sdk.tracing.Transaction.finish`.
        Ni  )microseconds)r   r   r@   r   r   r   r   r   r   r6   r   r   r   r   r   "maybe_create_breadcrumbs_from_span)rY   r7   end_timestampelapseds       rC   r   zSpan.finish  s      >>%	8mU3$,$:$:=(,,$WM!.)+d.P.PP!%!5!5	!(49 " 7557*5$7  	8%\\(,,7DN	8s   A6B* *1CCc           
      h   | j                   | j                  | j                  | j                  | j                  | j
                  | j                  | j                  | j                  d	}| j                  r| j                  | j                  d<   | j                  !| j                  j                         }|r||d<   t        | j                        dkD  r| j                  |d<   | j                  }|r||d<   i }|j                  | j                          |j                  | j"                         |r||d<   |S )z5Returns a JSON-compatible representation of the span.)	r+   r,   r-   r.   r0   r1   r6   r   r8   r3   _metrics_summaryr   measurementstagsdata)r+   r,   r-   r.   r0   r1   r6   r   r8   r3   r   r   to_jsonr   r   r   r   r   )rY   r   metrics_summaryr"  r#  s        rC   r$  zSpan.to_json  s	   
 ||"11&*&A&A''++#33kk

 ;;#';;DJJx !!-"44<<>O)8%&t!!"Q&!%!3!3B~zzBvJDKK DJJBvJ	rB   c                    | j                   | j                  | j                  | j                  | j                  | j
                  d}| j                  r| j                  |d<   | j                  r+| j                  j                         j                         |d<   i }| j                  j                  t        j                        }|||d<   | j                  j                  t        j                        }|||d<   |r||d<   |S )N)r+   r,   r-   r0   r1   r8   r3   dynamic_sampling_contextz	thread.idzthread.namer#  )r+   r,   r-   r0   r1   r8   r3   r5   r   r'  r   r   r
   r	  r
  )rY   r   r#  r  r  s        rC   get_trace_contextzSpan.get_trace_context  s     ||"11''++kk
 ;;;;BxL&&++779RRT )* JJNN8#5#56	  )DjjnnX%9%9:""-DBvJ	rB   c                 b    | j                   j                  t        j                        }|y d|iS )NrL   )r   r   r
   r  r  s     rC   get_profile_contextzSpan.get_profile_context  s4    jjnnX%9%9: ;
 	
rB   c                 B    t               \  }}| j                  ||       y rV   )r   r  r  s      rC   r   zSpan.update_active_thread  s    !8!:	;	;/rB   )NNNTNNNNNNNNmanualN NN)%r:   r;   r<   r   r   r   r   r   r   r   r   propertyr5   r   SENTRYr   classmethodr   r   r   r   r   r   r   r   r   r   r  r  r   r  r  r   r$  r(  r*  r   rA   rB   rC   r   r      s   :I: ##@0H8

  	, 	, (4':': (T T T2 
 	- -^/( 
 
0  '
BA=
E#$L%NB
0rB   r   c                        e Zd ZdZdZdddej                  f fd	Zd Zd Z	 fdZ
 fd	Zed
        Zd Z	 	 ddd fdZddZd Z fdZ fdZ fdZd Zd Z xZS )r4   ai  The Transaction is the root element that holds all the spans
    for Sentry performance instrumentation.

    :param name: Identifier of the transaction.
        Will show up in the Sentry UI.
    :param parent_sampled: Whether the parent transaction was sampled.
        If True this transaction will be kept, if False it will be discarded.
    :param baggage: The W3C baggage header value.
        (see https://www.w3.org/TR/baggage/)
    :param source: A string describing the source of the transaction name.
        This will be used to determine the transaction's type.
        See https://develop.sentry.dev/sdk/event-payloads/transaction/#transaction-annotations
        for more information. Default "custom".
    :param kwargs: Additional arguments to be passed to the Span constructor.
        See :py:class:`sentry_sdk.tracing.Span` for available arguments.
    )
r9   rG   rH   sample_rater   	_contexts_profile_continuous_profile_baggager   r.  Nc                 :   t        |   di | || _        || _        d | _        || _        i | _        i | _        d | _        d | _	        || _
        | j                  d n| j                  j                         }||| _        y t        | j                        | _        y NrA   )superr   r9   rG   r4  rH   r   r5  r6  r7  r8  r   _generate_sample_randr+   )rY   r9   rH   rJ   rG   r   baggage_sample_randr   s          rC   r   zTransaction.__init__,  s     	"6"	,#'  MM)Dt}}/I/I/K 	 * 3D 5dmm DDrB   c                    d| j                   j                  d| j                  d| j                  d| j                  d| j
                  d| j                  d| j                  d| j                  d	| j                  d
S )Nr   z(name=z, op=r   r   r   r   z	, source=r   r   )
r   r:   r9   r0   r+   r,   r-   r/   rG   r8   rX   s    rC   r   zTransaction.__repr__J  sU    
 ''		##	
rB   c                 >    | j                   duxs | j                  du S )zReturns whether the transaction might have been started.

        If this returns False, we know that the transaction was not started
        with sentry_sdk.start_transaction, and therefore the transaction will
        be discarded.
        NF)r   r/   rX   s    rC   _possibly_startedzTransaction._possibly_started[  s#     ""$.G$,,%2GGrB   c                     | j                         st        j                  d       t        |           | j
                  | j
                  j	                          | S )NzTransaction was entered without being started with sentry_sdk.start_transaction.The transaction will not be sent to Sentry. To fix, start the transaction bypassing it to sentry_sdk.start_transaction.)r@  r   debugr;  r   r6  )rY   r   s    rC   r   zTransaction.__enter__g  sL    %%'LL> 	==$MM##%rB   c                     | j                   | j                   j                  |||       | j                  | j                  j                          t        |   |||       y rV   )r6  r   r7  stopr;  )rY   r   rW   r   r   s       rC   r   zTransaction.__exit__w  sR    ==$MM""2ub1##/$$))+UB'rB   c                     | S )znThe root element of the span tree.
        In the case of a transaction it is the transaction itself.
        rA   rX   s    rC   r5   z"Transaction.containing_transaction  s	     rB   c                     |}|t        j                  dt        d       |}t        |t        j
                        r(t        j                  dt        d       |j                  S |S )z
        Logic to get the scope from the arguments passed to finish. This
        function exists for backwards compatibility with the old finish.

        TODO: Remove this function in the next major version.
        zMThe `hub` parameter is deprecated. Please use the `scope` parameter, instead.   r   zDPassing a Hub to finish is deprecated. Please pass a Scope, instead.)r   r   r   r   r   Hubr7   )rY   	scope_arghub_argscope_or_hubs       rC   _get_scope_from_finish_argsz'Transaction._get_scope_from_finish_args  sb     !MM_" #LlJNN3MMV"  %%%rB   r2   c          	         | j                   y| j                  ||      }|xs" | j                  xs t        j                         }t        j
                         }|j                         sy| j                  | j                  du rt        j                  d       nt        j                  d       |j                  ryt        |j                        rd|j                  r|j                  j                  dkD  rd}nd}|j                  j!                  |d	       |j                  j!                  |d
	       y| j"                  st        j$                  d       d| _        t&        | Q  ||       | j                  s"| j                  t        j$                  d       y| j                  j*                  D cg c]  }|j                   |j-                           }}t/        | j                  j*                        t/        |      z
  }|| j                  j0                  z   }	d| _        i }
|
j3                  | j4                         |
j3                  d| j7                         i       | j9                         }||
j3                  d|i       d| j"                  d| j:                  i|
| j<                  | j                   | j>                  |d}|	dkD  r|	|d<   | j@                  0| j@                  jC                         r| j@                  |d<   d| _         | jD                  |d<   | jF                  !| jF                  j-                         }|r||d<   |jI                  |      S c c}w )au  Finishes the transaction and sends it to Sentry.
        All finished spans in the transaction will also be sent to Sentry.

        :param scope: The Scope to use for this transaction.
            If not provided, the current Scope will be used.
        :param end_timestamp: Optional timestamp that should
            be used as timestamp instead of the current time.
        :param hub: The hub to use for this transaction.
            This argument is DEPRECATED. Please use the `scope`
            parameter, instead.

        :return: The event ID if the transaction was sent to Sentry,
            otherwise None.
        NFz.Discarding transaction because sampled = FalsezSDiscarding transaction because it was not started with sentry_sdk.start_transactionr   backpressurer4  r   )data_categoryr   zCTransaction has no name, falling back to `<unlabeled transaction>`.z<unlabeled transaction>z1Discarding transaction without sampling decision.traceprofilerG   )typer   transaction_infocontextsr"  r   r6   r}   _dropped_spansr!  r   )%r   rL  r7   r   r   r   	is_activer   r/   r   rB  	transporthas_tracing_enabledr   monitordownsample_factorrecord_lost_eventr9   r   r;  r   r}   r$  r   r~   r   r5  r(  r*  rG   r   r6   r6  validr   r   capture_event)rY   r7   r  r2   clientreasonr   finished_spanslen_diffr~   rU  profile_contexteventr%  r   s                 rC   r   zTransaction.finish  s   , >>% 003
 EEz'C'C'E&&(!&||u$MNi $7$G>>fnn&F&F&J+F*F  2262W   2262PyyNNU 2DIum,|| ||#RS ++11
~~) LLN
 
 t**001C4GG 4#6#6#D#DD #'$"8"8":;<224&OOY89 "99!)4;; 7 JJ#33#	
 1&3E"#==$)<)<)>#}}E) DM $ 2 2n !!-"44<<>O,;()""5))c
s   5#Mc                 `    t        j                  dt        d       ||d| j                  |<   yr  r  r  s       rC   r  zTransaction.set_measurement0  r  rB   c                 "    || j                   |<   y)a  Sets a context. Transactions can have multiple contexts
        and they should follow the format described in the "Contexts Interface"
        documentation.

        :param key: The name of the context.
        :param value: The information about the context.
        N)r5  r   s      rC   set_contextzTransaction.set_context>  s     $srB   c                 L    t         |   |       | j                  dd|i       y)zySets the status of the Transaction according to the given HTTP status.

        :param http_status: The HTTP status code.responsestatus_codeN)r;  r  rg  )rY   r  r   s     rC   r  zTransaction.set_http_statusI  s'    
 	,m[%ABrB   c                 ~    t         |          }| j                  |d<   | j                  |d<   | j                  |d<   |S )z<Returns a JSON-compatible representation of the transaction.r9   rG   r/   )r;  r$  r9   rG   r/   )rY   r   r   s     rC   r$  zTransaction.to_jsonQ  s=     W_YY6
{{89	rB   c                 Z    t         |          }| j                  r| j                  |d<   |S )Nr#  )r;  r(  r   )rY   trace_contextr   s     rC   r(  zTransaction.get_trace_context\  s+    13::$(JJM&!rB   c                     | j                   r| j                   j                  rt        j                  |       | _         | j                   S )zReturns the :py:class:`~sentry_sdk.tracing_utils.Baggage`
        associated with the Transaction.

        The first time a new baggage with Sentry items is made,
        it will be frozen.)r8  mutablerI   populate_from_transactionrX   s    rC   r   zTransaction.get_baggagee  s3     }} 5 5#==dCDM}}rB   c           
         t        j                         }dj                  | j                  rd| j                  z   dz   nd| j                        }t        |j                        sd| _        y| j                  t        | j                        | _	        yt        |j                  j                  d            r |j                  d   |      n|d	   |d	   n|j                  d
   }t        |d      s-t        j                  dj                  |             d| _        yt        |      | _	        |j                  r,| xj                  d|j                  j                   z  z  c_	        | j                  sTt        j"                  dj                  |t        |j                  j                  d            rdnd             d| _        y| j$                  t'        j(                  | j                        k  | _        | j                  r&t        j"                  dj                  |             yt        j"                  dj                  || j                               y)aO  
        Sets the transaction's sampling decision, according to the following
        precedence rules:

        1. If a sampling decision is passed to `start_transaction`
        (`start_transaction(name: "my transaction", sampled: True)`), that
        decision will be used, regardless of anything else

        2. If `traces_sampler` is defined, its decision will be used. It can
        choose to keep or ignore any parent sampling decision, or use the
        sampling context data to make its own decision or to choose a sample
        rate for the transaction.

        3. If `traces_sampler` is not defined, but there's a parent sampling
        decision, the parent sampling decision will be used.

        4. If `traces_sampler` is not defined and there's no parent sampling
        decision, `traces_sample_rate` will be used.
        z{op}transaction <{name}>r   z> r.  )r0   r9   FNtraces_samplerrH   traces_sample_rateTracing)rG   zN[Tracing] Discarding {transaction_description} because of invalid sample rate.)transaction_descriptionr   z?[Tracing] Discarding {transaction_description} because {reason}z"traces_sampler returned 0 or Falseztraces_sample_rate is set to 0)ru  r`  z,[Tracing] Starting {transaction_description}z}[Tracing] Discarding {transaction_description} because it's not included in the random sample (sampling rate = {sample_rate}))ru  r4  )r   r   formatr0   r9   rY  r   r/   r@   r4  callabler   r   r   r   rZ  r[  rB  r   r   
from_float)rY   sampling_contextr_  ru  r4  s        rC   _set_initial_sampling_decisionz*Transaction._set_initial_sampling_decisionq  s,   * &&("<"C"C(,dgg$Rtyy #D #

 #6>>2 DL <<#$T\\2D **+;<= -FNN+,-=>
 $$45A !!12^^$89 	 $K	BNN`gg,C h 
 !DL ->>6>>#C#C CC LLQXX,C $FNN$6$67G$HI == Y 	 !DL ((7+=+=d>N>N+OO<<LL>EE,C F  LL P  W  W,C $ 0 0 W rB   r/  r-  )r:   r;   r<   r   r   rN   r\   r   r   r@  r   r   r0  r5   rL  r   r  rg  r  r$  r(  r   rz  __classcell__)r   s   @rC   r4   r4     s    "I   ''E<
"
H ( 	 	F @*
 @*DB	$C	
drB   r4   c                       e Zd Zd Zed        Zej                  fdZd Z	d Z
d Zd Zd Zd	 Zd
 Zd Zd Zd Zd Zd Z	 	 ddddZddZd Zd Zd Zy)r   c                 4    d| j                   j                  z  S )Nz<%s>)r   r:   rX   s    rC   r   zNoOpSpan.__repr__  s    ////rB   c                      y rV   rA   rX   s    rC   r5   zNoOpSpan.containing_transaction  s     rB   c                     t               S rV   )r   )rY   r   r   s      rC   r   zNoOpSpan.start_child  s
    zrB   c                      y)Nr.  rA   rX   s    rC   r   zNoOpSpan.to_traceparent  s    rB   c                      y rV   rA   rX   s    rC   r   zNoOpSpan.to_baggage      rB   c                      y rV   rA   rX   s    rC   r   zNoOpSpan.get_baggage  r  rB   c                     t        d      S r:  )iterrX   s    rC   r   zNoOpSpan.iter_headers  s    BxrB   c                      y rV   rA   r   s      rC   r   zNoOpSpan.set_tag      rB   c                      y rV   rA   r   s      rC   r   zNoOpSpan.set_data  r  rB   c                      y rV   rA   r   s     rC   r   zNoOpSpan.set_status  r  rB   c                      y rV   rA   r  s     rC   r  zNoOpSpan.set_http_status  r  rB   c                      y)NTrA   rX   s    rC   r  zNoOpSpan.is_success  r  rB   c                     i S rV   rA   rX   s    rC   r$  zNoOpSpan.to_json
      	rB   c                     i S rV   rA   rX   s    rC   r(  zNoOpSpan.get_trace_context  r  rB   c                     i S rV   rA   rX   s    rC   r*  zNoOpSpan.get_profile_context  r  rB   NrM  c                     y)z_
        The `hub` parameter is deprecated. Please use the `scope` parameter, instead.
        NrA   )rY   r7   r  r2   s       rC   r   zNoOpSpan.finish  s     	rB   c                      y rV   rA   r  s       rC   r  zNoOpSpan.set_measurement#  r  rB   c                      y rV   rA   r   s      rC   rg  zNoOpSpan.set_context'  r  rB   c                      y rV   rA   r   s     rC   r   zNoOpSpan.init_span_recorder+  r  rB   c                      y rV   rA   )rY   ry  s     rC   rz  z'NoOpSpan._set_initial_sampling_decision/  r  rB   r/  r-  )r:   r;   r<   r   r0  r5   r   r1  r   r   r   r   r   r   r   r   r  r  r$  r(  r*  r   r  rg  r   rz  rA   rB   rC   r   r     s    0   (4':':  
 rB   r   c                      y rV   rA   funcs    rC   rQ  rQ  6       	rB   c                      y rV   rA   r  s    rC   rQ  rQ  ;  r  rB   c                 &    ddl m} | r ||       S |S )av  
    Decorator to start a child span under the existing current transaction.
    If there is no current transaction, then nothing will be traced.

    .. code-block::
        :caption: Usage

        import sentry_sdk

        @sentry_sdk.trace
        def my_function():
            ...

        @sentry_sdk.trace
        async def my_async_function():
            ...
    r   )start_child_span_decorator)sentry_sdk.tracing_utilsr  )r  r  s     rC   rQ  rQ  A  s    & D )$//))rB   )rI   r   r   r<  rY  r  ignore)r   rV   )Qdecimalr   r   r   r   r   r   enumr   r   sentry_sdk.constsr   r	   r
   'sentry_sdk.profiler.continuous_profilerr   sentry_sdk.utilsr   r   r   r   r   typingr   collections.abcr   r   r   r   r   r   r   r   r   r   r   r   r   typing_extensionsr   r    r!   r"   r#   (sentry_sdk.profiler.transaction_profilerr$   sentry_sdk._typesr%   r&   r'   r(   r*   rF   r=   rK   r   r   rN   r_   LOW_QUALITY_TRANSACTION_SOURCESr[   r]   SOURCE_FOR_STYLErx   rz   r   r4   r   rQ  r  rI   r   r   r<  rY  r  catch_warningssimplefilterr   sentry_sdk.metricsr   rA   rB   rC   <module>r     s      2 2   @ @ C  ! AA 3#AAI@ 9aYe 9avQJe Q 3	
N   ) 

T 
 # 
 "++&00%//066!!#--&,,%++""
 $$N$ $2d0 d0NI$ IXYt Yx    
*>  X 3H($6723 3 3s   G//G8