ViT)SrSSKrSSKr\ SSKJr SSK J r \ "SS9r /SQrSSjrSS jr\"5rS \lS \l\RrS 0\ 4S jr\SSS4S jr\S:Xa/\"05rS\S'\R4 SSKr\R8"5 gg!\a \\4rSSK Jr Nf=f!\ a \"5r Nf=f)z A small set of utilities useful for debugging misbehaving applications. Currently this focuses on ways to use :mod:`pdb`, the built-in Python debugger. N)Repr) make_sentinel_UNSET)var_name) pdb_on_signalpdb_on_exception wrap_tracec^^^^SSKmSSKmT(d TRmTRT5mUUUU4SjnTRTU5 g)aInstalls a signal handler for *signalnum*, which defaults to ``SIGINT``, or keyboard interrupt/ctrl-c. This signal handler launches a :mod:`pdb` breakpoint. Results vary in concurrent systems, but this technique can be useful for debugging infinite loops, or easily getting into deep call stacks. Args: signalnum (int): The signal number of the signal to handle with pdb. Defaults to :mod:`signal.SIGINT`, see :mod:`signal` for more information. rNcb>TRTT5 TR"5 [T5 gN)signal set_tracer)sigframe old_handlerpdbr signalnums e/home/james-whalen/.local/share/pipx/venvs/semgrep/lib/python3.13/site-packages/boltons/debugutils.pypdb_int_handler&pdb_on_signal..pdb_int_handlerMs" i- i )rr SIGINT getsignal)rrrrr s` @@@rrr:sD MM ""9-K!!  MM)_- rc>^^^SSKmSSKnSSKmUUU4SjnX!lg)aInstalls a handler which, instead of exiting, attaches a post-mortem pdb console whenever an unhandled exception is encountered. Args: limit (int): the max number of stack frames to display when printing the traceback A similar effect can be achieved from the command-line using the following command:: python -m pdb your_code.py But ``pdb_on_exception`` allows you to do this conditionally and within your application. To restore default behavior, just do:: sys.excepthook = sys.__excepthook__ rNcJ>TRUTS9 TR"U5 g)N)limit)print_tb post_mortem)exc_typeexc_valexc_tbrr tracebacks rpdb_excepthook(pdb_on_exception..pdb_excepthookms"6/ r)rsysr" excepthook)rr%r#rr"s` @@rrrVs& $N r2c URS5[R"5URS5URRU4nUS:XaSnU[ U54- nOUS:XaSnU[ US54- nOUS:XaS nOS nUS R UV s/sHn [ U 5PM sn 54- nU(aJS nUS R UR5V V s/sHupU <S [ U 5<3PM sn n 54- nU[LaUS- nU[ U54- n[X-5 gs sn fs sn n f)N getz%s %s - %s - %s.%s -> %ssetz%s %s - %s - %s.%s = %srdelz%s %s - %s - %s.%sz%s %s - %s - %s.%s(%s)z, z%s %s - %s - %s.%s(%s, %s)=z -> %s) ljusttimerjust __class____name__ brief_reprjoinitemsrprint) eventlabelobj attr_nameargskwargsresultfargstmplakvs rtrace_print_hookrE{s: [[^TYY[%++b/ ]] # #Y 0E ~) *V$&& %( *T!W%'' %#' $))D9DqZ]D9:<< /D dii-3\\^!=-;TQ-.z!}!=-;!=>@ @E   H D j(* *E $, :!=s D6 "D; c^^^^^^^^^^[T[5(aU4SjnOF[[TSS55(aU4SjnO$Tb[T5(aTnO[ ST-5eT=(d [ [ T55m[U[5(aU/nU(+=(d SU;mU(+=(d SU;mU(+=(d SU;mU(+=(d S U;mU(+=(d S U;mU(+=(d S U;mTT4UUUUU4S jjnUUUU4S jnUUUU4SjnUUUU4Sjn 0n [T5Hen [TU 5n [U 5(aU S;aM(U(aU"X5(dM>U S:XaUn OU S:XaUn OU S:XaU n OU"X5n XU 'Mg TRRnXR5:XaSU-nOSU-n[TS5(aTR4nOTR[4n[UUU 5nURHnUR!U5s $ [ STR<ST<35e![a GM+f=f![a MUf=f)a8Monitor an object for interactions. Whenever code calls a method, gets an attribute, or sets an attribute, an event is called. By default the trace output is printed, but a custom tracing *hook* can be passed. Args: obj (object): New- or old-style object to be traced. Built-in objects like lists and dicts also supported. hook (callable): A function called once for every event. See below for details. which (str): One or more attribute names to trace, or a function accepting attribute name and value, and returning True/False. events (str): One or more kinds of events to call *hook* on. Expected values are ``['get', 'set', 'del', 'call', 'raise', 'return']``. Defaults to all events. label (str): A name to associate with the traced object Defaults to hexadecimal memory address, similar to repr. The object returned is not the same object as the one passed in. It will not pass identity checks. However, it will pass :func:`isinstance` checks, as it is a new instance of a new subtype of the object passed. c>UT:H$r r(r<attr_valwhichs rwrap_trace.. e1Cr __contains__Nc>UT;$r r(rHs rrKrLrMrz*expected attr name(s) or callable, not: %rr,r-r.callraisereturnc@>^^^UUUUUUUU 4SjnTRUlTRUlTRUlTR(a%URR TR5 U$![a NEf=f![a U$f=f)Nc >USSnT(a T "STT TXS9 T(a T"U0UD6nOT"U0UD6nT(a T "STT TXWS9 W$! T "STT TX[R"5S9(deN<=f)NrP)r9r:r;r<r=r>rQ)r9r:r;r<r=r>r?rR)r%exc_info) rBkwret_labelr<do_calldo_raise do_returnfunchookr;s rwrapped0wrap_trace..wrap_method..wrappeds!"A6S(q=.R.CAnn86s(qCIJgV*3!'*||~77s A&A-)r4__doc__ __module__ Exception__dict__update) r<r]_hookrYr_rZr[r\r^r;s `` ` r wrap_methodwrap_trace..wrap_methods  ( ==,, !%G  }}  '' 6       s#A?6B? B  B  BBc >[T5RTU5n[U5(a[T5RX5nT(a T"STTUS0US9 U$)Nr,r()r?)type__getattribute__callable)selfr<rXdo_getr^r:r;s rrk$wrap_trace..__getattribute__sR3i((i8 C==s),,T=C  sIr2c B rcd>[T5RTX5 T(a T"STTX405 g)Nr-)rj __setattr__)rmr<valuedo_setr^r:r;s rrqwrap_trace..__setattr__s/ S c94  sIx <rcd>[T5RTU5 T(a T"STTUS05 g)Nr.r()rj __delattr__)rmr<do_delr^r:r;s rrvwrap_trace..__delattr__s/ S c9-  sIr2 6r)__new__rkrqrvtraced_Traced__mro__zunable to wrap_trace z instance ) isinstance basestringrlgetattr TypeErrorhexiddirrcr3r4lowerhasattrobjectrjr|ry)r;r^rJeventsr: which_funcrgrkrqrvattrsr<rIwrapped_methodcls_name type_namebases trace_typeclsrZrwrnr[r\rss``` ` @@@@@@rr r sfB%$$C '%6 7 7C (5// DuLMM  !SC\E&*%%Z *5F?FZ *5F?FZ *5F?Fj,Ff,Gz.W.H 0h&0I+/  D  EX  sI.H!!Y,%>   9 ? ?  * *-N - '(N - '(N(=N)i'*}}%%H>>##( x' sI 'i.J!! ;;z* *" }}c+ ,,K   F   s$ I'5I9' I65I69 JJ__main__hellohir )d)rar%r1r~reprr NameErrorstrbytesreprlib typeutilsrr ImportErrorr__all__rr _repr_obj maxstringmaxotherr5rEr r4r;failrrr(rrrsB   ' H -F > 8 < F    ^^ R 4*$dU,p z R.CCIHHs}} AuJ XFs"B B-B*)B*- B=<B=