ó æNXc@s:dZddlmZddlZddlZddlZddlmZddlm Z m Z ddl m Z ddl mZmZmZmZddlmZmZmZdd lmZdd lmZdd lmZdd lmZdd lmZm Z de!fd„ƒYZ"edefd„ƒYƒZ#dS(s(Implementation of basic magic functions.iÿÿÿÿ(tprint_functionN(tpformat(tmagic_argumentstpage(t UsageError(tMagicst magics_classt line_magict magic_escapes(t format_screentdedenttindent(t skip_doctest(tStruct(tunquote_filename(t unicode_type(twarnterrort MagicsDisplaycBs>eZd„Zd„Zd„Zd„Zd„Zd„ZRS(cCs ||_dS(N(tmagics_manager(tselfR((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyt__init__sc Cstd}td}|j}|jƒ}d|d|jt|dƒƒdd|d|jt|dƒƒd|jƒg}dj|ƒS(s'The main implementation of the %lsmagictlinetcellsAvailable line magics:s tsAvailable cell magics:s (RRtlsmagictjointsortedt auto_status(Rtmesctcesctmmantmagicstout((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyt_lsmagics    cCs|j|jƒƒdS(N(ttextR"(Rtptcycle((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyt _repr_pretty_(scCs |jƒS(N(R"(R((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyt__str__+sc Cs i}|j}|jƒ}x~|jƒD]p\}}i}|||Ms<-      cCst|jjƒS(s)List currently available magic functions.(RR?R(Rt parameter_s((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyR¢sc CsÓ|jj}|j|ddƒ}|r0d}nd}djgt|djƒƒD]/\}}|td|tt|ƒƒf^qSgt|djƒƒD]/\}}|td|tt|ƒƒf^qœƒS(s'Return docstrings from magic functions.tmissingsNo documentations**%s%s**:: %s s %s%s: %s RRR( R?Rt lsmagic_docsRRR)RR R (RtbrieftrestRtdocst format_stringtfnametfndoc((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyt _magic_docs§s  FcCsàd}y-|jƒdd}|dkr2g}nWntk rFnX|dk}|dk}|j||ƒ}|dkr”t|j|ƒƒdSt|ƒ}d|d td t|jƒƒg}t j d j |ƒƒdS( smPrint information about the magic function system. Supported formats: -latex, -brief, -rest RiiRORNtlatexNsÜ IPython's 'magic' functions =========================== The magic function system provides a series of functions which allow you to control the behavior of IPython itself, plus a lot of system-type features. There are two kinds of magics, line-oriented and cell-oriented. Line magics are prefixed with the % character and work much like OS command-line calls: they get as an argument the rest of the line, where arguments are passed without parentheses or quotes. For example, this will time the given statement:: %timeit range(1000) Cell magics are prefixed with a double %%, and they are functions that get as an argument not only the rest of the line, but also the lines below it in a separate argument. These magics are called with two arguments: the rest of the call line and the body of the cell, consisting of the lines below the first. For example:: %%timeit x = numpy.random.randn((100, 100)) numpy.linalg.svd(x) will time the execution of the numpy svd routine, running the assignment of x as part of the setup phase, which is not timed. In a line-oriented client (the terminal or Qt console IPython), starting a new input with %% will automatically enter cell mode, and IPython will continue reading input until a blank line is given. In the notebook, simply type the whole cell as one entity, but keep in mind that the %% escape can only be at the very start of the cell. NOTE: If you have 'automagic' enabled (via the command line option or with the %automagic function), you don't need to type in the % explicitly for line magics; cell magics always require an explicit '%%' escape. By default, IPython ships with automagic on, so you should only rarely need the % escape. Example: typing '%cd mydir' (without the quotes) changes you working directory to 'mydir', if it exists. For a list of the available magic functions, use %lsmagic. For a description of any of them, type %magic_name?, e.g. '%cd?'. Currently the magic system has the following functions:s,Summary of magic functions (from %slsmagic):Rs ( tsplitt IndexErrorRTRFt format_latexR RtstrRRR(RRKtmodet rest_docsRNROt magic_docsR!((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pytmagic»s&       . cCs|j|dƒ\}}d|k}|r0|p3d}|jj|ƒ}|dr~|r^tpat|dƒ}tj|ƒntd|ƒdS(sÖPretty 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.trt_tfoundR3sObject `%s` not foundN(t parse_optionsR?t_ofindRYRRRF(RRKtoptsRGtrawtonametinfottxt((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyRs  cCsJtdƒddlm}|jƒr<t|jƒjƒn tdƒdS(s×Print your currently active IPython profile. See Also -------- prun : run code using the Python profiler (:meth:`~IPython.core.magics.execution.ExecutionMagics.prun`) sE%profile is now deprecated. Please use get_ipython().profile instead.iÿÿÿÿ(tBaseIPythonApplications[profile is an application-level value, but you don't appear to be in an IPython applicationN(RtIPython.core.applicationRht initializedRFtinstancetprofileR(RRKRh((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyRl"s  cCsG|jjjd}td|jƒ|_tdddg|jƒdS(sToggle pretty printing on/off.s text/plainisPretty printing has been turnedtOFFtONN(R?tdisplay_formattert formattersRDtpprintRF(RRKt ptformatter((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyRq2scCsid„}|jƒ}|s*tdƒ‚n|j}ddljj}|j r|j rtj dkswtj dkrd}d}t |ƒn|j r­|j r­d}ny||j _ Wn|d ƒnX|j jj|_y*|jjd |ƒ|jjd |ƒWn|d ƒnX|jrUy|jj|ƒWqe|d ƒqeXn|jjdƒdS( s2Switch 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 cSs"td|tjƒdfƒdS(Ns#Error changing %s color schemes. %si(Rtsystexc_info(R2((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pytcolor_switch_errHss8%colors: you must specify a color scheme. See '%colors?'iÿÿÿÿNtwin32tclis£Proper color support under MS Windows requires the pyreadline library. You can find it at: http://ipython.org/pyreadline.html Defaulting color scheme to 'NoColor'tNoColortprompttschemet exceptionsobject inspector(tstripRR?tIPython.utils.rlineimpltutilst rlineimplt colors_forcet have_readlineRstplatformRt has_readlinetprompt_managert color_schemetcolor_scheme_tabletactive_scheme_nametcolorst InteractiveTBt set_colorstSyntaxTBt color_infot inspectortset_active_scheme(RRKRut new_schemeR?treadlinetmsg((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyRˆ:s>         cCsfd„}|j}|jƒjƒ}y*|jjd|ƒtd|jjƒWn|dƒnXdS(s’Switch modes for the exception handlers. Valid modes: Plain, Context and Verbose. If called without arguments, acts as a toggle.cSs"td|tjƒdfƒdS(Ns%Error changing %s exception modes. %si(RRsRt(R2((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pytxmode_switch_err†sRZsException reporting mode:tuserN(R?R|t capitalizeR‰tset_modeRFRZ(RRKR’R?tnew_mode((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pytxmode~s  cCs7ddlm}||jdtƒ}tj|ƒdS(s Show a quick reference sheet iÿÿÿÿ(tquick_referenceRNN(tIPython.core.usageR˜RTtTrueR(RtargR˜tqr((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pytquickref’sc Cs|j}|j}|j}|jj}|jd}|jdtƒƒ}|j}|dtƒ} |d|jƒ|d|j j ƒ|d|j ƒ|d|j ƒ|d|j ƒ|d |jƒ|d |jƒ|d |j|j|jfƒ| tkrcd |_d |_d|_d|_d|_ d|_ t|_ t|_dg|_|jdƒnw|j\|_|_|_|j|_|j|_ |j|_ |j|_ |j|_|j|_|jd|jƒtdt| ƒƒ|_ ddg|j } td| ƒdS(s¢Toggle doctest mode on and off. This mode is intended to make IPython behave as much as possible like a plain Python shell, from the perspective of how its prompts, exceptions and output look. This makes it easy to copy and paste parts of a session into doctests. It does so by: - Changing the prompts to the classic ``>>>`` 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. s text/plaint doctest_modeRZt rc_pprintR—trc_separate_outtrc_separate_out2trc_prompts_pad_lefttrc_separate_intrc_active_typestprompt_templatess>>> s... Rs xmode Plainsxmode iRmRnsDoctest mode is:N(R?R„tmetaRoRpt setdefaultR tFalseRqR‰RZt separate_outt separate_out2tjustifyt separate_int active_typest in_templatet in2_templatet out_templateR]R¥R£R R¡R¢RŸR¤R—RDtintRF( RRKR?tpmR¦tdisp_formatterRrtdstoret save_dstoreRZt mode_label((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyRž™sL                      cCsk|j|dƒ\}}|dkr-d}ny|jj|ƒSWn#tk rf}tt|ƒƒnXdS(sšEnable 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 qt4|qt # enable PyQt4 event loop integration %gui qt5 # enable PyQt5 event loop integration %gui gtk # enable PyGTK event loop integration %gui gtk3 # enable Gtk3 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. RN(RaRCR?t enable_guit ExceptionRRY(RRKRcR›te((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pytguiïs cCs#|jjjd}||_|jS(smSet 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 s text/plain(R?RoRptfloat_precisiont float_format(RtsRr((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyt precisions* s-es--exporttdefaults+Export IPython history as a notebook. The filename argument is used to specify the notebook name and format. For example a filename of notebook.ipynb will result in a notebook name of "notebook" and a format of "json". Likewise using a ".py" file extension will write the notebook as a Python scripttfilenamettypesNotebook name or filenamec Cstj|j|ƒ}ddlm}m}t|jƒ|_|jrg}t |j j j ƒƒ}t |ƒdkr…tdƒ‚nx:|d D].\}}} |j|jd|d| ƒƒqW|jd|ƒ} tj|jdd d ƒ} || | d d ƒWd QXnd S(sExport 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 -e foo.ipynb". To export the history to "foo.py" do "%notebook -e foo.py". iÿÿÿÿ(twritetv4isHistory is empty, cannot exporttexecution_counttsourcetcellstwtencodingsutf-8tversioniN(RR=tnotebooktnbformatRÂRÃRRÀtexporttlistR?thistory_managert get_rangetlent ValueErrortappendt new_code_cellt new_notebooktiotopen( RR½RGRÂRÃRÆthisttsessionRÄRÅtnbtf((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyRÊ@s (R,R7t__doc__RtargumentRR>RR¨RTR]RRlRqRˆR—RRžRºR R¾RRÊ(((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyR8Fs^ CLCU",  ($RÛt __future__RRÕtjsonRsRqRt IPython.coreRRtIPython.core.errorRtIPython.core.magicRRRRtIPython.utils.textR R R tIPython.testing.skipdoctestR tIPython.utils.ipstructR tIPython.utils.pathRtIPython.utils.py3compatRtIPython.utils.warnRRtobjectRR8(((sQ/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/IPython/core/magics/basic.pyts"   "1