MhNZdZddlmZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZddlmZddlmZdd lmZdd lmZdd lmZdd lmZerdd lmZdZdZdZ ej!dkZ"ddZ#ej$dZ%dZ&ddZ'GddeZGddeZ(ddZ)dS)a Pdb debugger class. This is an extension to PDB which adds a number of new features. Note that there is also the `IPython.terminal.debugger` class which provides UI improvements. We also strongly recommend to use this via the `ipdb` package, which provides extra configuration options. Among other things, this subclass of PDB: - supports many IPython magics like pdef/psource - hide frames in tracebacks based on `__tracebackhide__` - allows to skip frames based on `__debuggerskip__` Global Configuration -------------------- The IPython debugger will by read the global ``~/.pdbrc`` file. That is to say you can list all commands supported by ipdb in your `~/.pdbrc` configuration file, to globally configure pdb. Example:: # ~/.pdbrc skip_predicates debuggerskip false skip_hidden false context 25 Features -------- The IPython debugger can hide and skip frames when printing or moving through the stack. This can have a performance impact, so can be configures. The skipping and hiding frames are configurable via the `skip_predicates` command. By default, frames from readonly files will be hidden, frames containing ``__tracebackhide__ = True`` will be hidden. Frames containing ``__debuggerskip__`` will be stepped over, frames whose parent frames value of ``__debuggerskip__`` is ``True`` will also be skipped. >>> def helpers_helper(): ... pass ... ... def helper_1(): ... print("don't step in me") ... helpers_helpers() # will be stepped over unless breakpoint set. ... ... ... def helper_2(): ... print("in me neither") ... One can define a decorator that wraps a function between the two helpers: >>> def pdb_skipped_decorator(function): ... ... ... def wrapped_fn(*args, **kwargs): ... __debuggerskip__ = True ... helper_1() ... __debuggerskip__ = False ... result = function(*args, **kwargs) ... __debuggerskip__ = True ... helper_2() ... # setting __debuggerskip__ to False again is not necessary ... return result ... ... return wrapped_fn When decorating a function, ipdb will directly step into ``bar()`` by default: >>> @foo_decorator ... def bar(x, y): ... return x * y You can toggle the behavior with ipdb> skip_predicates debuggerskip false or configure it in your ``.pdbrc`` License ------- Modified from the standard pdb.Pdb class to avoid including readline, so that the command line completion of other programs which include this isn't damaged. In the future, this class will be expanded with improvements over the standard pdb. The original code in this file is mainly lifted out of cmd.py in Python 2.2, with minor changes. Licensing should therefore be under the standard Python terms. For details on the PSF (Python Software Foundation) standard license, see: https://docs.python.org/2/license.html All the changes since then are under the same license as IPython. ) annotationsN)contextmanager) lru_cache) get_ipython) PyColorize) TokenStream) TYPE_CHECKING) FrameType)Pdb)Token)InteractiveShellTzipdb> __debuggerskip__) c td)zException hook which handles `BdbQuit` exceptions. All other exceptions are processed using the `excepthook` parameter. zs`BdbQuit_excepthook` is deprecated since version 5.1. It is still around only because it is still imported by ipdb.) ValueError)etevtb excepthooks U/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/IPython/core/debugger.pyBdbQuit_excepthookrs }  z (?<=\n)\s+c8td|S)N)RGX_EXTRA_INDENTsub)multiline_strings rstrip_indentationrs   $4 5 55rrcXfd}|jrt|j|z|_|S)zMake new_fn have old_fn's doc string. This is particularly useful for the ``do_...`` commands that hook into the help system. Adapted from from a comp.lang.python posting by Duncan Booth.c|i|SN)argskwnew_fns rwrapperz%decorate_fn_with_doc..wrappersvt"r"""r)__doc__r)r&old_fnadditional_textr's` rdecorate_fn_with_docr+sD #####~N+FN;;oM NrcheZdZUdZded<ded<ded<ded <ded <erd Zd d d d dZ dQdRdZe dSdZ e j dTdZ dZ e dZ dZdUfd ZdZdZerd Zed!Zd"Zd#Zfd$Zd%ZeeejxZZdUdVd'Z dWdXd,Zd-Z dYdZd0Z d[d\d6Z!d]d9Z"d:Z#d;Z$d<Z%e%Z&d=Z'd>Z(e(Z)d?Z*d@Z+dAZ,dBZ-dCZ.dDZ/dEZ0d^dGZ1e1Z2fdHZ3dIZ4e5dJdKZ6e5dJdLZ7fdMZ8dNZ9dOZ:e:Z;e9ZS)`r aLModified Pdb class, does not load readline. for a standalone version that uses prompt_toolkit, see `IPython.terminal.debugger.TerminalPdb` and `IPython.terminal.debugger.set_trace()` This debugger can hide and skip frames that are tagged according to some predicates. See the `skip_predicates` commands. r shellstr _theme_nameint_contextztuple[Exception, ...]_chained_exceptions_chained_exception_indexiTF)tbhidereadonlyipython_internal debuggerskipNcontextint | None | strc |d}t|trt|}||_t j||||fi|t |_|j@tj d}ddl m }| |_|tj d<i|_ |jj}t|tsJ||ksJt!j||_||t(|_d|_d|_|j|_t2rt5|_d|_dSdS)a>Create a new IPython debugger. Parameters ---------- completekey : default None Passed to pdb.Pdb. stdin : default None Passed to pdb.Pdb. stdout : default None Passed to pdb.Pdb. context : int Number of lines of source code context to show when displaying stacktrace information. **kwargs Passed to pdb.Pdb. Notes ----- The possibilities are python version dependent, see the python docs for more info. Nr8__main__r)TerminalInteractiveShell) theme_nameT) isinstancer.r0r9OldPdb__init__rr-sysmodules!IPython.terminal.interactiveshellr=instancealiasescolorslowerrParserparserset_theme_nameprompt skip_hiddenreport_skippeddefault_predicates _predicatesCHAIN_EXCEPTIONStupler2r3) self completekeystdinstdoutr9kwargs save_mainr=r>s rrAz Pdb.__init__sg< ?G gs # # #'llG  k5&CCFCCC!]] :  J/I R R R R R R1::<>>  J''' " 2  .',wwD $,-D ) ) ) . .rreturnc|jSr")r1rSs rr9z Pdb.context1s }rvalue int | strNonect|tst|}t|tsJ|dksJ||_dS)Nr)r?r0r1)rSr\s rr9z Pdb.context5sO%%% JJE%%%%%%zzzz rc||ksJt|tsJ||_||j_dSr")rHr?r.r/rJr>)rSnames rrKzPdb.set_theme_name>sIzz||t####$$$$$$!% rc0tj|jSr")r theme_tabler/r[s rthemez Pdb.themeDs%d&677rctjdtd||ksJ||_||j_dS)z;Shorthand access to the color table scheme selector method.zFset_colors is deprecated since IPython 9.0, use set_theme_name instead) stacklevelN)warningswarnDeprecationWarningrHr/rJr>)rSschemes r set_colorszPdb.set_colorsIsg T     ''''!<<>>!' rc|tjj}||_t |Sr")rB _getframef_back initial_framesuper set_trace)rSframe __class__s rrrz Pdb.set_traceTs6 =MOO*E"ww  '''rcP|jdrL|jj}tj|r!tj|tjsdS|jdr?||jt|ddfvrdS| |}d|vrdS|dSdS)zX Given a frame return whether it it should be hidden or not by IPython. r5Tr4rpNF__tracebackhide__) rPf_code co_filenameospathisfileaccessW_OKcurframegetattr_get_frame_locals)rSrsfname frame_localss r_hidden_predicatezPdb._hidden_predicateZs  J ' L,Ew~~e$$ RYubg-F-F t  H % 5ot(L(LMMMu11%88L",66u 34 4urcfd|D}dt|Dr(jdrfdt|D}|S)z Given an index in the stack return whether it should be skipped. This is used in up/down and where to skip frames. cFg|]}|dS)r)r).0srSs r z%Pdb.hidden_frames..ys+???A4))!A$//???rc$g|] \}}|dk |S)__ipython_bottom__r#)rirs rrz%Pdb.hidden_frames..zs'RRR$!Q=Q8Q8QA8Q8Q8Qrr6c6g|]\}}|dkr|ndS)rTr#)rrhip_starts rrz%Pdb.hidden_frames..|s-WWW&1aA OOqqWWWr) enumeraterP)rSstackip_hiders` @r hidden_frameszPdb.hidden_framesos{@??????RR)G"4"4RRR  X();< XWWWWIgDVDVWWWGrcvg}t|tr|j|}}|w||vrnr|||j|j}n|j|js|j}t||jkr| d|jdn|wn|}tt||fS)ae Given a tracecack or an exception, return a tuple of chained exceptions and current traceback to inspect. This will deal with selecting the right ``__cause__`` or ``__context__`` as well as handling cycles, and return a flattened list of exceptions we can jump to with do_exceptions. Nz More than zQ chained exceptions found, not all exceptionswill be browsable with `exceptions`.) r? BaseException __traceback__append __cause__ __context____suppress_context__lenMAX_CHAINED_EXCEPTION_DEPTHmessagerRreversed)rS tb_or_exc _exceptions tracebackcurrents r_get_tb_and_exceptionszPdb._get_tb_and_exceptionssK)]33 &%.% Context manager to ensure proper cleaning of exceptions references When given a chained exception instead of a traceback, pdb may hold references to many objects which may leak memory. We use this context manager to make sure everything is properly cleaned Nr)r2rr3rR)rS exceptionss r_hold_exceptionszPdb._hold_exceptionssn 2+5(03J!0C-,177(01---,177(01-1111s "AAc:|js|ddS|st|jD]x\}}||jkrdnd}t |}t |dkr |dddz}|j|jdn|d }||d|d|ydS t|}n&#t$r| d YdSwxYwd |cxkrt |jkrnn}|j|j| d dS||_| d|j|j| |j |j dS| d dS)awexceptions [number] List or change current exception in an exception chain. Without arguments, list all the current exception in the exception chain. Exceptions will be numbered, with the current exception indicated with an arrow. If given an integer as argument, switch to the exception at that index. zDid not find chained exceptions. To move between exceptions, pdb/post_mortem must be given an exception object rather than a traceback.N> PMz...z -z>3zArgument must be an integerrz;This exception does not have a traceback, cannot jump to itzNo exception with that number)r2rrr3reprrrr0rerrorsetupprint_stack_entryrcurindex)rSargixexcrLrep indicatornumbers r do_exceptionszPdb.do_exceptionss+  7  @()ABB @ @GB$&$*G$G$GSSSFs))C3xx"}}!#2#h. 3B7EM "ZZ LLF!>!>Y!>!>!>!>???? @ @ XXFF!JJ<===FF>>>>T%=!>!>>>>>>/7EM Y4:D1JJtT%=f%E%STTT**4:dm+DEEEEEJJ>?????s1CC$#C$c tr||\}}t|tr | Jd||5t j|||ddddS#1swxYwYdSt j|||dS#t$r8|j d|j zYdSwxYw)Nz$main exception must have a traceback ) rQrr?rrr@ interactionKeyboardInterruptrVwriter-get_exception_only)rSrsrr2rs rrzPdb.interactionsH F ;*.*E*Ei*P*P'#Ri77R>>+Q>>>**+>??88&tUB777888888888888888888"4 :::::  F F F K  dTZ%B%B%D%DD E E E E E E Fs<AB A;. B ;A??B A?B B >C"!C"c|drd|ddz}n"|dr d|ddz}t|}|S)z