fZdZddlmZddlZddlZddlmZddlZddlm Z ddl m Z ddl m Z mZddlmZdd lmZmZmZmZdd lmZmZmZdd lmZdd lmZGd deZeGddeZ eGdde Z!y)z(Implementation of basic magic functions.)errorN)pformat)warn) import_item)magic_argumentspage) UsageError)Magics magics_class line_magic magic_escapes) format_screendedentindent) skip_doctest)Structc2eZdZddZdZdZdZdZdZy) MagicsDisplayNc(|r|ng|_||_yN)ignoremagics_manager)selfrrs T/var/www/cvtools/html/venv/lib/python3.12/site-packages/IPython/core/magics/basic.py__init__zMagicsDisplay.__init__s &fB ,c td}td}|j}|j}d|d|zjt |dj Dcgc]\}}||j vs|c}}zdd|d|zjt |dj Dcgc]\}}||j vs|c}}zd|jg}dj|Scc}}wcc}}w)z'The main implementation of the %lsmagiclinecellzAvailable line magics:z zAvailable cell magics: )r rlsmagicjoinsorteditemsr auto_status)rmesccescmmanmagicsmvouts r_lsmagiczMagicsDisplay._lsmagicsV$V$""'tDy&&vF6N> B  B c"|jSr)rDr5s r _repr_json_zMagicsDisplay._repr_json_Bs~~rr) r; __module__ __qualname__rr.r3r6rDrFrrrrs -  ( rrc reZdZdZeej ej ddddej dddd ej d d ej d d ej dddded$dZed$dZ d%dZ ed$dZ ed$dZ ed$dZ ed$dZed$dZedZed$dZed$dZeed$dZej ej d ed!"ed#Zy)& BasicMagicszMagics that provide central IPython functionality. These are various magics that don't fit into specific categories but that are all part of the base 'IPython experience'.z-lz--line store_truezCreate a line magic alias.)actionhelpz-cz--cellzCreate a cell magic alias.rAz Name of the magic to be created.)rNtargetz(Name of the existing line or cell magic.z-pz--paramsNz(Parameters passed to the magic function.)defaultrNc tj|j|}|j}|jj}dj t j}|jj|}|jj|}|j}|rI|jdr|jds"|jdr|jdr|dd}|j|d} |j|d} |jr| t!d t d|d |j"r| t!d t d|d |js>|j"s2| s| st!d |zt%| |_t%| |_|dnd |z} |jr:|j'||d|t)dt d|dt d|| d|j"r;|j'||d|t)dt d|dt d|| dyy)aHCreate an alias for an existing line or cell magic. Examples -------- :: In [1]: %alias_magic t timeit Created `%t` as an alias for `%timeit`. Created `%%t` as an alias for `%%timeit`. In [2]: %t -n1 pass 1 loops, best of 3: 954 ns per loop In [3]: %%t -n1 ...: pass ...: 1 loops, best of 3: 954 ns per loop In [4]: %alias_magic --cell whereami pwd UsageError: Cell magic function `%%pwd` not found. In [5]: %alias_magic --line whereami pwd Created `%whereami` as an alias for `%pwd`. In [6]: %whereami Out[6]: u'/home/testuser' In [7]: %alias_magic h history "-p -l 30" --line Created `%h` as an alias for `%history -l 30`. r "'rrNzLine magic function `z ` not found.zCell magic function `z+No line or cell magic with name `%s` found. z Created `z` as an alias for `z`.)rparse_argstring alias_magicshellrr#r valuesrOlstriprAparams startswithendswith find_magicrr rboolregister_aliasprint) rrargsrYr)escsrOrAr\m_linem_cell params_strs rrXzBasicMagics.alias_magicMsl..t/?/?F zz((ww}++-.##D)yy% ##C(V__S-A%%c*vs/CAb\F!!&&1!!&&1 99+F3V=> > 99+F3V=> > yy& AFJV DIV DI!>RsV| 99   fff = f%tf%vz; < 99   fff = f%tf%vz; < rcDt|jjgS)z)List currently available magic functions.)r)rrYr)r parameter_ss rr"zBasicMagics.lsmagicsTZZ66rBBrc|jj}|j|d}|rd}nd}djt |dj Dcgc]&\}}|t d|tt|fz(c}}t |dj Dcgc]&\}}|t d|tt|fz(c}}zScc}}wcc}}w)z'Return docstrings from magic functions.zNo documentation)missingz**%s%s**:: %s z %s%s: %s r rr) rYr lsmagic_docsr#r$r%r rr)rbriefrestr)docs format_stringfnamefndocs r _magic_docszBasicMagics._magic_docsszz((  0B C 2M)Mww"(V (:(:(_0 b $))C.!}   sB-- B98B9c:|j|d\}}d|v}|xr|xsd}|jj|}|jrC|rt |j }nt |j }tj|ytd|zy)zPretty print the object and display it through a pager. %page [options] OBJECT If no object is given, use _ (last output). Options: -r: page str(object), don't pretty-print it.r_zObject `%s` not foundN) parse_optionsrY_ofindfoundryrBrrrb)rrioptsrcrawonameinfotxts rrzBasicMagics.pages'' S9 dTk $zz  ' ::$((mdhh' IIcN )E1 2rc|jjjd}td|jz |_t dddg|jy)zToggle pretty printing on/off. text/plainrTzPretty printing has been turnedOFFONN)rYdisplay_formatter formattersr`pprintrb)rri ptformatters rrzBasicMagics.pprint4sSjj22==lK !!k&8&8"89  /Tl;--. 0rcd}|j}|s td|j} ||_|j  |j j ||jj ||jr |jj|y|jjdy#|dYxYw#|dY`xYw#|dYyxYw) a2Switch color scheme for prompts, info system and exception handlers. Currently implemented schemes: NoColor, Linux, LightBG. Color scheme names are not case-sensitive. Examples -------- To get a plain black and white terminal:: %colors nocolor cTtd|dtjddy)NError changing z color schemes. rT) stacklevelrsysexc_inforAs rcolor_switch_errz,BasicMagics.colors..color_switch_errJs"  q)+78 :rz8%colors: you must specify a color scheme. See '%colors?'rY)scheme exceptionzobject inspectorNoColorN) stripr rYcolors refresh_style InteractiveTB set_colorsSyntaxTB color_info inspectorset_active_scheme)rrir new_schemerYs rrzBasicMagics.colors<s : !&&( JL L  &%EL    !  *    * *J * ? NN % %z % :    511*= OO - -i 8# & W %  * [ )  5 !34s#C8C C! C C! C-cd}|j}|jdk(rd|j_y|jdk(rd|j_y|jj } |jj |t d|jjy#|d YyxYw) aJSwitch modes for the exception handlers. Valid modes: Plain, Context, Verbose, and Minimal. If called without arguments, acts as a toggle. When in verbose mode the value `--show` (and `--hide`) will respectively show (or hide) frames with ``__tracebackhide__ = True`` value set. cPtd|dtjdy)Nrz exception modes. rTrrs rxmode_switch_errz+BasicMagics.xmode..xmode_switch_errzs s||~a(* +rz--showFNz--hideT)rzzException reporting mode:user)rYrr skip_hidden capitalizeset_moderbrz)rrirrYnew_modes rxmodezBasicMagics.xmodems +     ( *.3E   +     ( *.2E   + $$&113 %    ( (h ( 7 -e.A.A.F.F G % V $s 9>>`` ones. - Changing the exception reporting mode to 'Plain'. - Disabling pretty-printing of output. Note that IPython also supports the pasting of code snippets that have leading '>>>' and '...' prompts in them. This means that you can paste doctests from files or docstrings (even if they have leading whitespace), and the code will execute correctly. You can then use '%history -t' to see the translated history; this will give you the input after removal of all the leading prompts and whitespace, which can be pasted back into an editor. With these features, you can switch into this mode easily whenever you need to do testing and changes to doctests, without having to leave your existing IPython session. r doctest_moderzF rc_pprintrrc_separate_outrc_separate_out2rc_separate_inrc_active_typesr z xmode Plainzxmode rrzDoctest mode is:N)rYmetarr setdefaultrrrrz separate_out separate_out2 separate_in active_typesr|rrrrrrswitch_doctest_moder`rb) rrirYrdisp_formatterrdstore save_dstorerz mode_labels rrzBasicMagics.doctest_modes6 zz55$// = 9'' 6%(K 2 23GE//445%e&8&89&u':':;$U%6%67%n&A&AB!#E !#E "$E "'K +7.N ' KK &!' 5 5E !'!7!7E "("9"9E !'!1!1K *0*@*@N ' KK6<</ 0 !!d(+t8n D\&++.   *-rc|j|d\}}|dk(rd} |jj|S#t$r}t t |Yd}~yd}~wwxYw)akEnable or disable IPython GUI event loop integration. %gui [GUINAME] This magic replaces IPython's threaded shells that were activated using the (pylab/wthread/etc.) command line flags. GUI toolkits can now be enabled at runtime and keyboard interrupts should work without any problems. The following toolkits are supported: wxPython, PyQt4, PyGTK, Tk and Cocoa (OSX):: %gui wx # enable wxPython event loop integration %gui qt # enable PyQt/PySide event loop integration # with the latest version available. %gui qt6 # enable PyQt6/PySide6 event loop integration %gui qt5 # enable PyQt5/PySide2 event loop integration %gui gtk # enable PyGTK event loop integration %gui gtk3 # enable Gtk3 event loop integration %gui gtk4 # enable Gtk4 event loop integration %gui tk # enable Tk event loop integration %gui osx # enable Cocoa event loop integration # (requires %matplotlib 1.1) %gui # disable all event loop integration WARNING: after any of these has been called you can simply create an application object, but DO NOT start the event loop yourself, as we have already handled that. r N)rrY enable_gui Exceptionrry)rrirres rguizBasicMagics.guis^:&&{B7 c 7$C ::((- -  #a&MM s9 A AA cn|jjjd}||_|jS)amSet floating point precision for pretty printing. Can set either integer precision or a format string. If numpy has been imported and precision is an int, numpy display precision will also be set, via ``numpy.set_printoptions``. If no argument is given, defaults will be restored. Examples -------- :: In [1]: from math import pi In [2]: %precision 3 Out[2]: u'%.3f' In [3]: pi Out[3]: 3.142 In [4]: %precision %i Out[4]: u'%i' In [5]: pi Out[5]: 3 In [6]: %precision %e Out[6]: u'%e' In [7]: pi**10 Out[7]: 9.364805e+04 In [8]: %precision Out[8]: u'%r' In [9]: pi**10 Out[9]: 93648.047476082982 r)rYrrfloat_precision float_format)rsrs r precisionzBasicMagics.precision s3Tjj22==lK &' #'''rfilenamezNotebook name or filename)typerNc*tj|j|}tjj |j }ddlm}m }g}t|jjj}t|dkr td|ddD](\}} } |j!|j#| | *|j%|} t'j(|d d 5} || | d dddy#1swYyxYw)zExport and convert IPython notebooks. This function can export the current IPython history to a notebook file. For example, to export the history to "foo.ipynb" do "%notebook foo.ipynb". r)writev4rTzHistory is empty, cannot exportNrU)execution_countsource)cellswzutf-8)encoding)version)rrWnotebookospath expanduserrnbformatrrlistrYhistory_manager get_rangelen ValueErrorappend new_code_cell new_notebookioopen) rrrcoutfnamerrrhistsessionrrnbfs rrzBasicMagics.notebook7s..t}}a@77%%dmm4&DJJ..88:; t9a<>? ?04Sb   ,G_f LL)) /*   __5_ ) WWXsW 5 $ "a # $ $ $s 4 D  D)r )FF)r;rGrH__doc__rrargumentr rXr"rsr|rrrrrrrrryrrIrrrKrKFs6 $_$$&_ h| -_ h| -_ 3_ ;_ j$ ;M<     '.M<^CC (G"G"T33800.9.9`%%> L.L.\##J*(*(X%_$$&_ ($ ' $rrKceZdZedZy) AsyncMagicsc|j}ddd}|sGtdj||jj|jj y|j dvrd|j_y|j dvrd |j_y||jjvr;|jj|\|j_|j_y||jjvr:|jj||j_d |j_yt|}||j_d |j_y) aV Allow to change the status of the autoawait option. This allow you to set a specific asynchronous code runner. If no value is passed, print the currently used asynchronous integration and whether it is activated. It can take a number of value evaluated in the following order: - False/false/off deactivate autoawait integration - True/true/on activate autoawait integration using configured default loop - asyncio/curio/trio activate autoawait integration and use integration with said library. - `sync` turn on the pseudo-sync integration (mostly used for `IPython.embed()` which does not run IPython with a real eventloop and deactivate running asynchronous code. Turning on Asynchronous code with the pseudo sync loop is undefined behavior and may lead IPython to crash. If the passed parameter does not match any of the above and is a python identifier, get said object from user namespace and set it as the runner, and activate autoawait. If the object is a fully qualified object name, attempt to import it and set it as the runner, and activate autoawait. The exact behavior of autoawait is experimental and subject to change across version of IPython and Python. onoff)TFz.IPython autoawait is `{}`, and set to use `{}`N)falserF)truerT) rrbformatrY autoawait loop_runnerlowerloop_runner_mapuser_nsr)rriparamr@runners rrzAsyncMagics.autoawaitXs0D!!# & BII$**&&' &&  ;;=, ,#(DJJ  ;;=N *#'DJJ  DJJ.. .;?::;U;UV[;\ 8DJJ "DJJ$8 DJJ&& &%)ZZ%7%7%>DJJ "#'DJJ U#!' # rN)r;rGrHr rrIrrrrUs>$>$rr)"rloggingrrrrrrwarningsrtraitlets.utils.importstringr IPython.corerrIPython.core.errorr IPython.core.magicr r r r IPython.utils.textrrrIPython.testing.skipdoctestrIPython.utils.ipstructrobjectrrKrrIrrr s.  4.)NN<<4)/ F/ dL$&L$L$\A$+A$A$r