fmdZddlZddlZddlZddlZddlZddlZddlmZddl m Z m Z ddl m Z ddlmZddlmZmZmZddlmZdd lmZmZmZdd lmZmZdd lmZdd lm Z dd l!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*Gdde+Z,ejZdZ.ejZdej^Z0dZ1dZ2dZ3Gdde4Z5eGddeZ6y)z3Implementation of code management magic functions. N)chain)Requesturlopen) urlencode)Path)TryNextStdinNotImplementedError UsageError)Macro)Magics magics_class line_magic) find_filefind_source_lines)version) skip_doctest) preserve_keys)get_py_filename)warn)error) get_text_listc eZdZy) MacroToEditN__name__ __module__ __qualname__S/var/www/cvtools/html/venv/lib/python3.12/site-packages/IPython/core/magics/code.pyrr-rrz!$z3 (?P\d+)? ((?P[\-:]) (?P\d+)?)? $c#K|jD]}tj|}|s|jd}|jd}|jd}|dk(r"|rt |dz nd}|r t |nd}nC|dk(r%|rt |dz nd}|rt |dz nd}nt |}t |dz }||fyw)zTurn a string of range for %%load into 2-tuples of (start, stop) ready to use as a slice of the content split by lines. Examples -------- list(extract_input_ranges("5-10 2")) [(4, 10), (1, 2)] sepstartend-N:)splitrange_rematchgroupint) ranges_str range_strrmatchr#r$r%s r extract_code_rangesr19s %%'  * ll5! W%ll5! #:&+CJNE!#c(tC CZ&+CJNE"%#c(Q,4Ce*CJNEcl#sCCcF|jd}tj|}|jDcgc]}t |dd|j f}}|jd}i}t |}t|D]H\}}||dz js|dz}||dz js|r |dz |f||<|dz }Jg} g} |D]F} | |vr/|| \}}| jdj|||dz6| j| H| | fScc}w)a Return a tuple (blocks, not_found) where ``blocks`` is a list of code fragments for each symbol parsed from code, and ``not_found`` are symbols not found in the code. For example:: In [1]: code = '''a = 10 ...: def b(): return 42 ...: class A: pass''' In [2]: extract_symbols(code, 'A,b,z') Out[2]: (['class A: pass\n', 'def b(): return 42\n'], ['z']) ,nameN r') r)astparsebodygetattrlinenolenreversedstripappendjoin) codesymbolspy_codesmarks symbols_linesr%r4r$blocks not_foundsymbols r extract_symbolsrIVsC mmC GiioG;B<< Haga& 1 HE H ::d DM d)C esQw-%%' 1HCsQw-%%' #(19c"2M$ ai FI% ] "&v.JE3 MM$))DsO4t; <   V $ % 9 ; Is Dc#DKtjd}t|}t|}|j |}|rO|j }|t |d|D])}|j|r|t |d%|nn||D]}|yw)z}For %load, strip indent from lines until finding an unindented line. https://github.com/ipython/ipython/issues/9775 z\s+N)recompileiternextr+r,r; startswith)lines indent_reit first_line indent_matchindentlines r strip_initial_indentrWs  6"I eBbJ??:.L##%V&& Dv&3v;<((    sBB ceZdZdZdZy)InteractivelyDefinedz:Exception for interactively defined variable in magic_editc||_yN)index)selfr\s r __init__zInteractivelyDefined.__init__s  rN)rrr__doc__r^rrr rYrYs DrrYceZdZdZfdZed dZed dZedZedZ e dZ d Z e edddgfd ZxZS) CodeMagicszBMagics related to code management (loading, saving, editing, ...).cJt|_tt||i|yr[)set _knowntempssuperrar^)r]argskwargs __class__s r r^zCodeMagics.__init__s!5 j$($9&9rc|j|dd\}}|s tdd|v}d|v}d|v}|rdnd}|rd nd }|d d j|d d} } | jds| |z } tj j | } tj j| } | r3|s1|s/ |jjd| zd} | s tdy |jj| |} t!j"| |d5}| r|s|j%d|j%| | jds|j%ddddtd| zt| y#t$rtd| d|dYywxYw#ttf$r"}t|jd Yd}~yd}~wwxYw#1swYxxYw)aSave a set of lines or a macro to a given filename. Usage:\ %save [options] filename [history] Options: -r: use 'raw' input. By default, the 'processed' history is used, so that magics are loaded in their transformed version to valid Python. If this option is given, the raw input as typed as the command line is used instead. -f: force overwrite. If file exists, %save will prompt for overwrite unless -f is given. -a: append to the file instead of overwriting it. The history argument uses the same syntax as %history for input ranges, then saves the lines to the filename you specify. If no ranges are specified, saves history of the current session up to this point. It adds a '.py' extension to the file if you don't do so yourself, and it asks for confirmation before overwriting existing files. If `-r` option is used, the default extension is `.ipy`. fralist)modezMissing filename.rfaw.ipy.pyr r'N)rsrrz%File `%s` exists. Overwrite (y/[N])? ndefaultzFile `z` exists. Use `%save -f z` to force overwriteOperation cancelled.utf-8encodingz# coding: utf-8 r5z1The following commands were written to file `%s`:) parse_optionsr r?endswithospath expanduserisfileshell ask_yes_nor printfind_user_code TypeError ValueErrorrfioopenwrite)r] parameter_soptsrfrawforcer>rmextfnamecodefrom file_exists overwritecmdseros r savezCodeMagics.saves>&&{5f&E T01 1Tkt s#fq'388DH#5x~~n- SLE""5)ggnnU+ uV  JJ112Y\a2akn1o ,- ::,,Xc:DWWUD7 3 qf+, GGDM==&   AEIJ d ', SXZefg :&  !&&)     s71 E? F A G?FF G/G  GGc|j|d\}} |jj|}d} t|jdd}|dks|dkDr t dyt|jd d d ||d jd }tdddjti}t||} | j jdS#ttf$r"}t |j dYd}~yd}~wwxYw#t$r0}t |j djYd}~yd}~wwxYw)a+Upload code to dpaste.com, returning the URL. Usage:\ %pastebin [-d "Custom description"][-e 24] 1-7 The argument can be an input history range, a filename, or the name of a string or macro. If no arguments are given, uploads the history of this session up to this point. Options: -d: Pass a custom description. The default will say "Pasted from IPython". -e: Pass number of days for the link to be expired. The default will be 7 days. zd:e:rNrr'imz*Expiry days should be in range of 1 to 365dzPasted from IPythonpython)titlesyntaxcontent expiry_daysryzhttps://dpaste.com/api/v2/z User-Agentz IPython v{})headersLocation)r|rrrrrrfr-get capitalizerencoderformatrrr) r]rrrfr@rr post_datarequestresponses r pastebinzCodeMagics.pastebinsC('' V< d ::,,T2D   dhhsA./K ?kC/ > ? #'<="*    &/  (!=#7#7#@A 7I.##J//9I&  !&&)     !&&)&&( )  s.CDD-D  D E &EE c&|j|y)zAlias of `%load` `%loadpy` has gained some flexibility and dropped the requirement of a `.py` extension. So it has been renamed simply into %load. You can look at `%load`'s docstring for more info. N)load)r]arg_ss r loadpyzCodeMagics.loadpy1s %rc|j|d\}}d|v}|jj||}d|vrk t||d\}}t |dk(rtd|d zn't |dkDrtd t|d zd j|}d|vrv|djdd}|jd } t|} | D cgc] } | t| }} d jttj |}t |} | dkDr5d|vr1 |jj#d| zd} | dur t'dydj)||z}|jj+|dy#t$rt dYywxYwcc} w#t$$rd} YnwxYw)aLoad code into the current frontend. Usage:\ %load [options] source where source can be a filename, URL, input history range, macro, or element in the user namespace If no arguments are given, loads the history of this session up to this point. Options: -r : Specify lines or ranges of lines to load from the source. Ranges could be specified as x-y (x..y) or in python-style x:y (x..(y-1)). Both limits x and y can be left blank (meaning the beginning and end of the file, respectively). -s : Specify function or classes to load from python source. -y : Don't ask confirmation for loading source above 200 000 characters. -n : Include the user's namespace when searching for source code. This magic command can either take a local filename, a URL, an history range (see %history) or a macro as argument, it will prompt for confirmation before loading source with more than 200 000 characters, unless -y flag is passed or if the frontend does not support raw_input:: %load %load myscript.py %load 7-27 %load myMacro %load http://www.example.com/myscript.py %load -r 5-10 myscript.py %load -r 10-20,30,40: foo.py %load -s MyClass,wonder_function myscript.py %load -n MyClass %load -n my_module.wonder_function zyns:r:ru) search_nsrCz.Unable to parse the input as valid Python codeNr'zThe symbol `%s` was not foundrzThe symbols %s were not found`)wrap_item_withr5rnr3rti@ yzSThe text you're trying to load seems pretty big (%d characters). Continue (y/[N]) ?rvTFrxz # %load {} )replace)r|rrrI SyntaxErrorrr;rrr?rr)r1slicerWr from_iterablerr rrset_next_input)r]rrrfrcontentsrFrGrangesrPslicesslclanss r rzCodeMagics.load;sT&&uX6 T4K ::,,TY,G $; $3Hd3i$H! 9~"4y|CDY!#4}YTW8YYyy(H $;#Y&&sC0FNN4(E(0F6<=seSk*=H=yy!5e6I6I(6S!TUH M v:#T/ jj++.79:.;EH,K e|,-!((/(: !!(D!9O FG $>,  s)FF15 F6F.-F.6 GGcd}d|v}d|v}Gddt}|jdd}|rd|d z}||jvr|d }d } d } ||} | rd } n@|r>|j||} | s* t ||j} t | t s| | r|j9| } t;d|  |j<j>|d <|s||d <| || fS#ttf$r||} | td|zYyd } Yr|$rp} t | tr t| | t| } | rd| jvr~tj| rit!| D cgc]} t#| | ncc} w}} |D]<}tj$|st|} | s'd| jvs:|} nt&j)t*j,j/| }|r&t1t3|j5d | d }| ||} d }| td|d| dr,| t7| }|||} | td| zYd} ~ yd } Yd} ~ d} ~ wwxYw#YxYw)z7Utility method used by magic_edit to find what to edit.cn t|}|S#t$r|jdr|}Y|Sd}Y|SwxYw)z#Make a filename from the given argsrsN)rIOErrorr})argfilenames r make_filenamez3CodeMagics._find_edit_target..make_filenamesO $*3/O $<<&"HO $HO $s 444prnc eZdZy)2CodeMagics._find_edit_target..DataIsObjectNrrrr DataIsObjectrr!rrruNz_%srr'TriFzBArgument given (%s) can't be found as a variable or as a filename.)NNN fakemodulezCould not find file where `z$` is defined. Opening a file named `rz8The file where `%s` was defined cannot be read or found.z)IPython will make a temporary file named:) Exceptionruser_nsextract_input_lineseval isinstancestr NameErrorrrr rrlowerinspectisclassdirr9ismethodipython_input_patr+r~rbasenamerYr-groupsr mktempfiler displayhook prompt_count)rrfr last_callr opts_prevopts_rawrr:use_tempdatarranameattrsattrmdatafiles r _find_edit_targetzCodeMagics._find_edit_targets 4K $; ,9+#d# 9Q<'D5==( |!& H ,,T8>+;;#OOD1HK4y$QeWT5%9$Q$QE$Q(- *'.'7'7'=$,+4T?#+".hnn6F"F,0D$) *.33BGG4D4DX4NO"6s188:a=7I"JPQQ#$'#0#6#$#/ <@("LM !>%6t%'4T':H'/ $&@BF&G!H'9$Ha0%x  sP2(C ; J 'J J JAI=/F0I=3I=B*I=5I==JJ c|jj|j}|jjj |t |j d}t||jj|<y)z,open an editor with the macro data in a fileryrzN) rrvaluehookseditorr read_textr r)r]mnamemacrormvalues r _edit_macrozCodeMagics._edit_macrosc::((5 )h))7);$)&M 5!rcP|j|d\}} |j|j|||\}}}|y|r|jj|n||jvrd}tddtjjt|} t| j!x} }d| vrd | z} |jj"j%| ||j+d k(r)| j-d |jj.d <d|vr tntdt1|jj.d5|s||jj.d<d|vr0| j-d } |jj3| dnE|jj5||jj.|jj.ddd|r | j-d Sy#t$r)}|j ||j dYd}~yd}~wt $rZ}td|jzt|j}|j|j|||\}}}Yd}~id}~wwxYw#t&$rt)d YywxYw#1swYxYw#t6$rL} t| j8| k(rt)dYd} ~ y|jj;Yd} ~ yd} ~ wwxYw)aBring up an editor and execute the resulting code. Usage: %edit [options] [args] %edit runs IPython's editor hook. The default version of this hook is set to call the editor specified by your $EDITOR environment variable. If this isn't found, it will default to vi under Linux/Unix and to notepad under Windows. See the end of this docstring for how to change the editor hook. You can also set the value of this editor via the ``TerminalInteractiveShell.editor`` option in your configuration file. This is useful if you wish to use a different editor from your typical default with IPython (and for Windows users who typically don't set environment variables). This command allows you to conveniently edit multi-line code right in your IPython session. If called without arguments, %edit opens up an empty editor with a temporary file and will execute the contents of this file when you close it (don't forget to save it!). Options: -n : open the editor at a specified line number. By default, the IPython editor hook uses the unix syntax 'editor +N filename', but you can configure this by providing your own modified hook if your favorite editor supports line-number specifications with a different syntax. -p: this will call the editor with the same data as the previous time it was used, regardless of how long ago (in your current session) it was. -r: use 'raw' input. This option only applies to input taken from the user's history. By default, the 'processed' history is used, so that magics are loaded in their transformed version to valid Python. If this option is given, the raw input as typed as the command line is used instead. When you exit the editor, it will be executed by IPython's own processor. -x: do not execute the edited code immediately upon exit. This is mainly useful if you are editing programs which need to be called with command line arguments, which you can then do using %run. Arguments: If arguments are given, the following possibilities exist: - If the argument is a filename, IPython will load that into the editor. It will execute its contents with execfile() when you exit, loading any code in the file into your interactive namespace. - The arguments are ranges of input history, e.g. "7 ~1/4-6". The syntax is the same as in the %history magic. - If the argument is a string variable, its contents are loaded into the editor. You can thus edit any string which contains python code (including the result of previous edits). - If the argument is the name of an object (other than a string), IPython will try to locate the file where it was defined and open the editor at the point where it is defined. You can use `%edit function` to load an editor exactly at the point where 'function' is defined, edit it and have the file be executed automatically. - If the object is a macro (see %macro for details), this opens up your specified editor with a temporary file containing the macro's data. Upon exit, the macro is reloaded with the contents of the file. Note: opening at an exact line is only supported under Unix, and some editors (like kedit and gedit up to Gnome 2.8) do not understand the '+NUMBER' parameter necessary for this feature. Good editors like (X)Emacs, vi, jed, pico and joe all do. After executing your code, %edit will return as output the code you typed in the editor (except when it was an existing file). This way you can reload the code in further invocations of %edit as a variable, via _ or Out[], where is the prompt number of the output. Note that %edit is also available through the alias %ed. This is an example of creating a simple function inside the editor and then modifying it. First, start up the editor:: In [1]: edit Editing... done. Executing edited code... Out[1]: 'def foo():\n print "foo() was defined in an editing session"\n' We can then call the function foo():: In [2]: foo() foo() was defined in an editing session Now we edit foo. IPython automatically loads the editor with the (temporary) file where foo() was previously defined:: In [3]: edit foo Editing... done. Executing edited code... And if we call foo() again we get the modified version:: In [4]: foo() foo() has now been changed! Here is an example of how to edit a code snippet successive times. First we call the editor:: In [5]: edit Editing... done. Executing edited code... hello Out[5]: "print 'hello'\n" Now we call it again with the previous output (stored in _):: In [6]: edit _ Editing... done. Executing edited code... hello world Out[6]: "print 'hello world'\n" Now we call it with the output #8 (stored in _8, also as Out[8]):: In [7]: edit _8 Editing... done. Executing edited code... hello again Out[7]: "print 'hello again'\n" Changing the default editor hook: If you wish to write your own editor hook, you can put it in a configuration file which you load at startup time. The default hook is defined in the IPython.core.hooks module, and you can use that as a starting example for further modifications. That file also has general instructions on how to set a new hook for use once you've defined it.zprxn:rNzEditing In[%i]Tz Editing...rt)r%z'%s'zCould not open editor pasted_blockryrzxzdone. Executing edited code...__file__rnF) store_historyz'File not found. Did you forget to save?)r|rrrrrfrYrr\rrdaddsysstdoutflushrabsoluterrrrr=rrrrun_cell safe_execfilerr showtraceback) r]rrrrfrr:is_temprfilepathquotedsourcemsgs r editzCodeMagics.edit sb&&{7; T N(,(>(>tzz7;T9)N %Hfg         *$***G l$ > !$H$5$5$7 8 8FXf}& JJ   # #FF 3 ::<> )191C1CW1C1UDJJ  ~ . $; G 2 3tzz11:> A5=DJJ&&z2$;%///AFJJ''e'DJJ,,Xtzz7I7I-1ZZ-?-?A A  /))7);; k    T166!9 - # N "QWW, -qww(>tzz7;T9)N %Hfg N6  ( )   A A / %1BCJJ,,..  /sb"H!A J*!BKK J'I J' AJ""J'*KKK  L%#L L  L%)ri)rrrr_r^rrrrr staticmethodrrrr __classcell__)rhs@r rarasL:AAF3030jW:W:r**B2!RGQ/Q/rra)7r_rrr~rKrr6 itertoolsrurllib.requestrr urllib.parserpathlibrIPython.core.errorrr r IPython.core.macror IPython.core.magicr r rIPython.core.oinspectrrIPython.core.releaserIPython.testing.skipdoctestrIPython.utils.contextsrIPython.utils.pathrwarningsrloggingrIPython.utils.textrrrrLrVERBOSEr*r1rIrWrrYrarrr rs +"ML$??>(40.,$*#BJJCD 2:: jj  :2h>9 C /C /C /r