}eT1dZddlZddlZddlmZddlZddlmZddl m Z m Z m Z ddl mZmZmZddlmZddlmZeZe Gd d e Zy) z6Implementation of magic functions related to History. N)open)StdinNotImplementedError)Magics magics_class line_magic)argumentmagic_argumentsparse_argstring) skip_doctest)iocteZdZeedddddeddddd ed d ddd ed ddddedddedddddeddeded ed!d"dd#$ed%d&eed*d'Z ed(Z ed*d)Z y)+ HistoryMagicsz-n print_nums store_trueFz{ print line numbers for each input. This feature is only available if numbered prompts are in use. )destactiondefaulthelpz-o get_outputz"also print outputs for each input.z-p pypromptsz print classic '>>>' python prompts before each input. This is useful for making documentation, and in conjunction with -o, for producing doctest-ready output. z-traw store_falseTa print the 'translated' history, as IPython understands it. IPython filters your input and converts it all into valid Python source before executing it (things like magics or aliases are turned into function calls, for example). With this option, you'll see the native history instead of the user-entered version: '%%cd /' will be seen as 'get_ipython().run_line_magic("cd", "/")' instead of '%%cd /'. z-ffilenamea FILENAME: instead of printing the output to the screen, redirect it to the given file. The file is always overwritten, though *when it can*, IPython asks for confirmation first. In particular, running the command 'history -f FILENAME' from the IPython Notebook interface will replace FILENAME even if it already exists *without* confirmation. )rrz-gpattern*Nac treat the arg as a glob pattern to search for in (full) history. This includes the saved history (almost all commands ever written). The pattern may contain '?' to match one unknown character and '*' to match any number of unknown characters. Use '%%hist -g' to show full saved history (may be very long). )rnargsrrz-llimit?z get the last n lines from all sessions. Specify n as a single arg, or the default is the last 10 lines. )rtyperrrz-uuniquezN when searching history using `-g`, show only unique history. )rrrrange)rc,t|j|}|jjfd}|j}|st j }d}ntjj|}tjj|r2 tjd|z}|s tdytdt|dd }d}|j }|j"} |j$} |j&} d} |j(t*urdn |j(} d}|j,_|j.sS|j,r"d d j1|j,zd z} nd } j3| | | | |j4 }d}n|j(t*ur| dn| }j7|| | }n[|j,r#d d j1|j,zd z}d}j9d j1|j.| | }d}|D]\}}}| r|\}}|rt;j:||s'|j=dj?}d|v}|rdnd }|r)t|||jA|d||d| r2tdd||r"dj1|jCdz}t||| sst|||r|jEyy#t$rd}YgwxYw)aPrint input history (_i variables), with most recent last. By default, input history is printed without line numbers so it can be directly pasted into an editor. Use -n to show them. By default, all input history from the current session is displayed. Ranges of history can be indicated using the syntax: ``4`` Line 4, current session ``4-6`` Lines 4-6, current session ``243/1-5`` Lines 1-5, session 243 ``~2/7`` Line 7, session 2 before current ``~8/1-~6/5`` From the first line of 8 sessions ago, to the fifth line of 6 sessions ago. Multiple ranges can be entered, separated by spaces The same syntax is used by %macro, %save, %edit, %rerun Examples -------- :: In [6]: %history -n 4-6 4:a = 12 5:print a**2 6:%history -n 4-6 cH|djfvr t|S|d|S)z0Helper function to format line numbers properly.r/)session_numberstr)sessionlinehistory_managers =/usr/lib/python3/dist-packages/IPython/core/magics/history.py_format_linenoz-HistoryMagics.history.._format_linenos+1o<<==4y %t, ,FzFile %r exists. Overwrite?Tz Aborting.NzOverwriting file.wzutf-8)encodingr )routputnr )rr0 :)fileendz>>> )r8r7z ... z ...)r7)#r historyshellr)rsysstdoutospath expanduserexistsr ask_yes_norprintio_openrrrrr _unspecifiedrr!joinsearchr get_tailget_range_by_strfnmatch expandtabsrstriprjust splitlinesclose)self parameter_sargsr+outfnameoutfile close_at_endansrrrrrr range_patternhistr1widthr'linenoinliner0 multilineline_sepr)s @r*r9zHistoryMagics.history(s@t||[9**44 -==jjG Lww))(3Hww~~h'--(Dx(OPC+&)*hg>GL__ __ NN hh l2  << #DJJ|| 66<"))'s:,1$++*GDJ ZZ| +mA"++A3z+JD|| #chht||&< ?'IF &w 'ff7+/ ,2  MMO G0CsL LLc<|s<|jjt|jjdy|jjj |}dj d|D}|r*|jj|jy tt||jj}|jj|jy#t$r|jjjd|zdz}t|Dcgc]}|d ncc}wc}D]6}d|vsd|vr |jj|jYyYnwxYwtd |y) aIRepeat a command, or get command to input line for editing. %recall and %rep are equivalent. - %recall (no arguments): Place a string version of last computation result (stored in the special '_' variable) to the next input prompt. Allows you to create elaborate command lines without using copy-paste:: In[1]: l = ["hei", "vaan"] In[2]: "".join(l) Out[2]: heivaan In[3]: %recall In[4]: heivaan_ <== cursor blinking %recall 45 Place history line 45 on the next input prompt. Use %hist to find out the number. %recall 1-4 Combine the specified lines into one cell, and place it on the next input prompt. See %history for the slice syntax. %recall foo+bar If foo+bar can be evaluated in the user namespace, the result is placed at the next input prompt. Otherwise, the history is searched for lines which contain that substring, and the most recent one is placed at the next input prompt. _Nr4c3&K|] }|d yw)N).0xs r* z'HistoryMagics.recall.. s0!0srr`recallrepz%Couldn't evaluate or find in history:) r:set_next_inputr&user_nsr)rHrErKeval ExceptionrFreversedrB)rOarg histlinescmdrchs r*rezHistoryMagics.recallsKF JJ % %c$***<* : Repeat the last n lines of input, not including the current command. -g foo : Repeat the most recent line which contains foo zl:g:string)modelz"Number of lines must be an integerNrz'Requested 0 last lines - nothing to runz+Number of lines to rerun cannot be negativegrrerunr`z'No lines in history match specificationr4z=== Executing: ===z=== Output: ===F) store_history) parse_optionsint ValueErrorrBr:r)rGlistrFrkrHrErun_cell) rOrPoptsrQr1rWprsrcrms r*ruzHistoryMagics.reruns'' V('K d $; S N Av?@QCD::--66q9D D[DI c!A 2299!<=Dd^ !A$&3D   ::-->>tDD::--66q9D"#!## ; < IIdO  "# i   DIIdO5AC :; 2$sF F5F21F2)r6) __name__ __module__ __qualname__r rryrDr rr9rerurar,r*rr%sI  < e   < e 13 ;|U   5    :    9C   7C   8L  gS!~"         3  x~@8<8rs] 8??;;4x lBFlBlBr,