.PhP(dZddlZddlZddlmZ ddlmZedZn#e$r e ZYnwxYwgdZ dd Z dd Z eZ d e _d e _e jZd iefdZedddfdZdS)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_tracecddlddlsjfd}|dS)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. rNcztdSN)signal set_tracer)sigframe old_handlerpdbr signalnums R/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/boltons/debugutils.pypdb_int_handlerz&pdb_on_signal..pdb_int_handlerEs8 i--- i     )rrSIGINT getsignal)rrrrrs` @@@rrr2sJJJMMM "M ""9--K!!!!!!!!  MM)_--- Frdc@ddlddl}ddlfd}||_dS)a4Installs 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__ rNc`||dS)N)limit)print_tb post_mortem)exc_typeexc_valexc_tbrr tracebacks rpdb_excepthookz(pdb_on_exception..pdb_excepthookes46/// r)rsysr# excepthook)rr%r$rr#s` @@rr r NsV&JJJJJJ       $CN Fr2cF|dtj|d|jj|f}|dkrd}|t |fz }n|dkrd}|t |dfz }n|dkrd }nd }|d d |Dfz }|r7d }|d d|Dfz }|tur|dz }|t |fz }t||zdS)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, c,g|]}t|Sr( brief_repr).0as r z$trace_print_hook..s999qZ]]999rz%s %s - %s - %s.%s(%s, %s)c<g|]\}}|dt|S)=r0)r2kvs rr4z$trace_print_hook..s@!=!=!=%)Q%&!7!7 1 !7!7!=!=!=rz -> %s) ljusttimerjust __class____name__r1joinitemsrprint) eventlabelobj attr_nameargskwargsresultfargstmpls rtrace_print_hookrJssS [[^^TY[[%++b// ] #Y 0E ~~) *V$$&& %( *T!W%%'' %#' $))99D999::<<  @/D dii!=!=-3\\^^!=!=!=>>@ @E    H D j((* *E $, FrcVttrfd}nJttddrfd}n&tr}nt dzpt t t|tr|g}| pd|v| pd|v| pd|v| pd |v| pd |v| pd |vffd }fd }fd}fd} i} tD]s} t| } n#t$rY wxYwt| r| dvr8|r || | sG| dkr|} n| dkr|} n| dkr| } n || | } | | | <tj j }|| krd|z}nd|z}tdr j f}nj tf}t||| }|jD])} ||cS#t$rY&wxYwt dj d)aMonitor 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|kSr r(rDattr_valwhichs rzwrap_trace..s e1Cr __contains__Nc |vSr r(rMs rrPzwrap_trace..s e1Crz*expected attr name(s) or callable, not: %rr,r-r.callraisereturnc fd}j|_j|_ j|_n#t$rYnwxYw jr|jjn#t$rYnwxYw|S)Nc |dd}r d ||r> |i|}n<#t$r' d ||tjsYn wxYw|i|}r d ||||S)NrrS)rArBrCrDrErFrT)rArBrCrDrErFrGrU) Exceptionr%exc_info) r3kwret_labelrDdo_calldo_raise do_returnfunchookrCs rwrappedz0wrap_trace..wrap_method..wrappeds!""A =6S(q==== %$.R..CC 4gV*3!B'*|~~777 dAnnn I86s(qCIIIIJs+.AA)r=__doc__ __module__rX__dict__update) rDr`_hookr\rbr]r^r_rarCs `` ` r wrap_methodzwrap_trace..wrap_methods            ( =, !%G      D  } 7 '' 666    D s! 7 AA&A// A<;A<c t|}t|r#t||}rd|di||S)Nr,r()rG)type__getattribute__callable)selfrDr[do_getrarBrCs rrkz$wrap_trace..__getattribute__st3ii((i88 C== >s)),,T9==C  C DsIr2c B B B B rcvt||rd||fidS)Nr-)rj __setattr__)rmrDvaluedo_setrarBrCs rrpzwrap_trace..__setattr__sJ S c9e444  = DsIx < < <rcrt|rd|didS)Nr.r()rj __delattr__)rmrDdo_delrarBrCs rrtzwrap_trace..__delattr__sF S c9---  7 DsIr2 6 6 6r)__new__rkrprttraced_Traced__mro__zunable to wrap_trace z instance ) isinstancestrrlgetattr TypeErrorhexiddirrXr<r=lowerhasattrobjectrjryrv)rCrarOeventsrB which_funcrhrkrprtattrsrDrNwrapped_methodcls_name type_namebases trace_typeclsr]rurnr^r_rrs``` ` @@@@@@rr r sB%NCCCC '%66 7 7NCCCC (5// DuLMMM  !SC\\E&#Z *5F?FZ *5F?FZ *5F?Fj,Ff,Gz.W.H 0h&0I+/          D  EXX**  sI..HH    H !! Y,%>%>    9h ? ?   * * *-NN - ' '(NN - ' '(NN([H==N)i}%H8>>####( x' sI( 'i..J! ;;z** * * *    D  )}}}cc+ , ,,s$D D&%D&*H H Hr )r)rcr%r:reprlibr typeutilsrr ImportErrorr__all__rr _repr_obj maxstringmaxotherreprr1rJr r(rrrs0>  (((((( ]H - - -FF VXXFFF > = =    8    < DFF    ^ R    4*$dU,U,U,U,U,U,s %77