Format: application/x-python-code
1 o
2
3 ��h�Z � @ s� d Z ddlmZ ddlZddlZddlmZ ddlZddlm Z ddl
4 m Z ddl m
5 Z
6 mZ ddlmZ dd lmZmZmZmZ dd
7 lmZmZmZ dd lmZ dd l m Z G d
8 d� de �Z eG dd� de��Z eG dd� de ��Z!dS )z(Implementation of basic magic functions.� )�errorN)�pformat)�warn)� import_item)�magic_arguments�page)�
9 UsageError)�Magics� magics_class�
10 line_magic�
11 magic_escapes)�
12 format_screen�dedent�indent)� skip_doctest)�Structc @ sF e Zd Zddd�Zdd� Zdd� Zdd � Zd
13 d � Zd d
14 � Zdd� Z dS )�
15 MagicsDisplayNc C s |r|ng | _ || _d S �N)�ignore�magics_manager)�selfr r � r �Oc:\Users\shubh\Videos\agent\nova\Lib\site-packages\IPython/core/magics/basic.py�__init__ s
16 zMagicsDisplay.__init__c s� t d }t d }� j}|�� }d|d| �t� fdd�|d �� D ��� dd|d| �t� fd d�|d �� D ��� d|�� g}d
17 �|�S ) z'The main implementation of the %lsmagic�line�cellzAvailable line magics:z c � g | ] \}}|� j vr|�qS r �r ��.0�m�v�r r r �
18 <listcomp> � z*MagicsDisplay._lsmagic.<locals>.<listcomp>� zAvailable cell magics:c r r r r r" r r r# # r$ �
19 )r r �lsmagic�join�sorted�itemsZ auto_status)r ZmescZcesc�mman�magics�outr r" r �_lsmagic s **�
20 zMagicsDisplay._lsmagicc C s |� | �� � d S r )�textr. )r �p�cycler r r �
21 _repr_pretty_( s zMagicsDisplay._repr_pretty_c C � | � � S r )�__str__r" r r r �__repr__+ � zMagicsDisplay.__repr__c C r3 r )r. r" r r r r4 . r6 zMagicsDisplay.__str__c
22
23 C st i }| j }|�� }|�� D ]*\}}i }|||< |�� D ]\}}z|jjj} W n ty1 d} Y nw | ||< qq
24 |S )z�turn magics dict into jsonable dict of the same structure
25
26 replaces object instances with their class names as strings
27 �Other)r r' r* �__self__� __class__�__name__�AttributeError)
28 r Z
29 magic_dictr+ r, �keyZsubdict�d�name�obj� classnamer r r � _jsonable1 s �
30 �zMagicsDisplay._jsonablec C r3 r )rA r" r r r � _repr_json_E r6 zMagicsDisplay._repr_json_r )
31 r: �
32 __module__� __qualname__r r. r2 r5 r4 rA rB r r r r r s
33 r c @ s8 e Zd ZdZee�� ejddddd�ejdddd d�ejd
34 d d �ejd
35 dd �ejddddd�ed3dd���������Zed3dd��Z d4dd�Z
36 ed3d d ��Z ed3d d ��Z ed3d d!��Z
37 ed3d"d#��Zed3d$d%��Zed&d'� �Zed3d(d)��Zed3d*d+��Zeed3d,d-���Ze�� ejd.ed/d0�ed1d2� ���ZdS )5� BasicMagicsz�Magics that provide central IPython functionality.
38
39 These are various magics that don't fit into specific categories but that
40 are all part of the base 'IPython experience'.z-lz--line�
41 store_truezCreate a line magic alias.)�action�helpz-cz--cellzCreate a cell magic alias.r> z Name of the magic to be created.)rH �targetz(Name of the existing line or cell magic.z-pz--paramsNz(Parameters passed to the magic function.)�defaultrH r% c C s� t �| j|�}| j}| jj}d�t�� �}|j� |�}|j
42 � |�}|j }|r@|� d�r0|�
43 d�s:|� d�r@|�
44 d�r@|dd� }|�|d�} |�|d�}
45 |jr]| du r]td td |f ��|jrn|
46 du rntd
47 td |f ��|js�|js�| s~|
48 s~td | ��t| �|_t|
49 �|_|du r�dnd | } |jr�|�||d|� td
50 td |td || f � |jr�|�||d|� td
51 td |td || f � dS dS )u� Create an alias for an existing line or cell magic.
52
53 Examples
54 --------
55 ::
56
57 In [1]: %alias_magic t timeit
58 Created `%t` as an alias for `%timeit`.
59 Created `%%t` as an alias for `%%timeit`.
60
61 In [2]: %t -n1 pass
62 107 ns ± 43.6 ns per loop (mean ± std. dev. of 7 runs, 1 loop each)
63
64 In [3]: %%t -n1
65 ...: pass
66 ...:
67 107 ns ± 58.3 ns per loop (mean ± std. dev. of 7 runs, 1 loop each)
68
69 In [4]: %alias_magic --cell whereami pwd
70 UsageError: Cell magic function `%%pwd` not found.
71 In [5]: %alias_magic --line whereami pwd
72 Created `%whereami` as an alias for `%pwd`.
73
74 In [6]: %whereami
75 Out[6]: '/home/testuser'
76
77 In [7]: %alias_magic h history -p "-l 30" --line
78 Created `%h` as an alias for `%history -l 30`.
79 r% �"�'� �����r r Nz%Line magic function `%s%s` not found.z%Cell magic function `%s%s` not found.z+No line or cell magic with name `%s` found.� z(Created `%s%s` as an alias for `%s%s%s`.)r �parse_argstring� alias_magic�shellr r( r �valuesrI �lstripr> �params�
80 startswith�endswithZ
81 find_magicr r r �boolZregister_alias�print) r r �argsrR r+ ZescsrI r> rU Zm_lineZm_cell�
82 params_strr r r rQ P s` 6 ����
83 �
84 � �
85
86
87 �
88 ��zBasicMagics.alias_magicc C s t | jjg d�S )z)List currently available magic functions.r )r rR r )r � parameter_sr r r r' � s zBasicMagics.lsmagicFc sf | j j}|j|dd�}|rd� nd� d�� fdd�t|d �� �D �� fd d�t|d
89 �� �D � �S ) z'Return docstrings from magic functions.zNo documentation)�missingz**%s%s**::
90
91 %s
92
93 z %s%s:
94 %s
95 r% c �* g | ]\}}� t d |tt|��f �qS )r �r r r �r �fnameZfndoc��
96 format_stringr r r# � �
97
98 �
99
100 �z+BasicMagics._magic_docs.<locals>.<listcomp>r c r^ )r r_ r` rb r r r# � rd r )rR r Z lsmagic_docsr( r) r* )r �brief�restr+ �docsr rb r � _magic_docs� s
101 �
102 ���zBasicMagics._magic_docsc C s� d}z |� � d dd� }W n ty Y nw |dk}|dk}| �||�}|dkr3t| �|�� dS t|�}d|d td
103 t| �� �g}t � d �
104 |�� dS ) zmPrint information about the magic function system.
105
106 Supported formats: -latex, -brief, -rest
107 r% r rM Nre rf �latexa�
108 IPython's 'magic' functions
109 ===========================
110
111 The magic function system provides a series of functions which allow you to
112 control the behavior of IPython itself, plus a lot of system-type
113 features. There are two kinds of magics, line-oriented and cell-oriented.
114
115 Line magics are prefixed with the % character and work much like OS
116 command-line calls: they get as an argument the rest of the line, where
117 arguments are passed without parentheses or quotes. For example, this will
118 time the given statement::
119
120 %timeit range(1000)
121
122 Cell magics are prefixed with a double %%, and they are functions that get as
123 an argument not only the rest of the line, but also the lines below it in a
124 separate argument. These magics are called with two arguments: the rest of the
125 call line and the body of the cell, consisting of the lines below the first.
126 For example::
127
128 %%timeit x = numpy.random.randn((100, 100))
129 numpy.linalg.svd(x)
130
131 will time the execution of the numpy svd routine, running the assignment of x
132 as part of the setup phase, which is not timed.
133
134 In a line-oriented client (the terminal or Qt console IPython), starting a new
135 input with %% will automatically enter cell mode, and IPython will continue
136 reading input until a blank line is given. In the notebook, simply type the
137 whole cell as one entity, but keep in mind that the %% escape can only be at
138 the very start of the cell.
139
140 NOTE: If you have 'automagic' enabled (via the command line option or with the
141 %automagic function), you don't need to type in the % explicitly for line
142 magics; cell magics always require an explicit '%%' escape. By default,
143 IPython ships with automagic on, so you should only rarely need the % escape.
144
145 Example: typing '%cd mydir' (without the quotes) changes your working directory
146 to 'mydir', if it exists.
147
148 For a list of the available magic functions, use %lsmagic. For a description
149 of any of them, type %magic_name?, e.g. '%cd?'.
150
151 Currently the magic system has the following functions:z,Summary of magic functions (from %slsmagic):r r& ) �split�
152 IndexErrorrh rY Z format_latexr
153 r �strr' r r( )r r\ �modere rf Z
154 magic_docsr- r r r �magic� s& � -
155
156 �1zBasicMagics.magicc C sn | � |d�\}}d|v }|r|pd}| j�|�}|jr/|r#t|j�}nt|j�}t�|� dS td| � dS )z�Pretty print the object and display it through a pager.
157
158 %page [options] OBJECT
159
160 If no object is given, use _ (last output).
161
162 Options:
163
164 -r: page str(object), don't pretty-print it.�r�_zObject `%s` not foundN) �
165 parse_optionsrR Z_ofind�foundrl r? r r rY )r r\ �optsrZ �rawZoname�info�txtr r r r s
166 zBasicMagics.pagec C s6 | j jjd }td|j �|_tdddg|j � dS )z Toggle pretty printing on/off.�
167 text/plainrM z Pretty printing has been turned�OFF�ONN)rR �display_formatter�
168 formattersrX �pprintrY )r r\ � ptformatterr r r r| 7 s
169 �zBasicMagics.pprintc C s� dd� }|� � }|std��| j}z ||_|�� W n |d� Y z|jj|d� |jj|d� W n |d� Y |jrSz |j �
170 |� W d S |d� Y d S |j �
171 d� d S )
172 a2 Switch color scheme for prompts, info system and exception handlers.
173
174 Currently implemented schemes: NoColor, Linux, LightBG.
175
176 Color scheme names are not case-sensitive.
177
178 Examples
179 --------
180 To get a plain black and white terminal::
181
182 %colors nocolor
183 c S s t d| t�� d f dd� d S )Nz#Error changing %s color schemes.
184 %srM � )�
185 stacklevel�r �sys�exc_info�r> r r r �color_switch_errM s
186 �
187 �z,BasicMagics.colors.<locals>.color_switch_errz8%colors: you must specify a color scheme. See '%colors?'rR )�scheme� exceptionzobject inspectorZNoColorN) �stripr rR �colorsZ
188 refresh_style�
189 InteractiveTBZ
190 set_colorsZSyntaxTBZ
191 color_infoZ inspectorZset_active_scheme)r r\ r� �
192 new_schemerR r r r r� ? s. �
193
194 zBasicMagics.colorsc C s� dd� }| j }|�� dkrd|j_dS |�� dkr d|j_dS |�� �� }z|jj|d� td |jj� W dS |d
195 � Y dS ) aJ Switch modes for the exception handlers.
196
197 Valid modes: Plain, Context, Verbose, and Minimal.
198
199 If called without arguments, acts as a toggle.
200
201 When in verbose mode the value `--show` (and `--hide`)
202 will respectively show (or hide) frames with ``__tracebackhide__ =
203 True`` value set.
204 c S s t d| t�� d f � d S )Nz%Error changing %s exception modes.
205 %srM r� r� r r r �xmode_switch_err} s
206 �z+BasicMagics.xmode.<locals>.xmode_switch_errz--showFNz--hideT)rm zException reporting mode:�user)rR r� r� Z skip_hidden�
207 capitalize�set_moderY rm )r r\ r� rR Znew_moder r r �xmodep s
208 zBasicMagics.xmodec C s* ddl m} || jdd� }t�|� dS )z Show a quick reference sheet r )�quick_referenceT)re N)ZIPython.core.usager� rh r )r �argr� Zqrr r r �quickref� s zBasicMagics.quickrefc
209 C s" | j }|j}| j j}|jd }|�dt� �}|j}|dd�}|d|j� |d|jj� |d|j � |d|j
210 � |d |j � |d
211 |j � |s\d |_ d |_ d |_
212 d|_dg|_ |�
213 dd � n|j|_ |j|_ |j|_
214 |j|_|j|_ |�
215 d|j� |�| � t| �|_d
216 dg|j } td| � dS )a� Toggle doctest mode on and off.
217
218 This mode is intended to make IPython behave as much as possible like a
219 plain Python shell, from the perspective of how its prompts, exceptions
220 and output look. This makes it easy to copy and paste parts of a
221 session into doctests. It does so by:
222
223 - Changing the prompts to the classic ``>>>`` ones.
224 - Changing the exception reporting mode to 'Plain'.
225 - Disabling pretty-printing of output.
226
227 Note that IPython also supports the pasting of code snippets that have
228 leading '>>>' and '...' prompts in them. This means that you can paste
229 doctests from files or docstrings (even if they have leading
230 whitespace), and the code will execute correctly. You can then use
231 '%history -t' to see the translated history; this will give you the
232 input after removal of all the leading prompts and whitespace, which
233 can be pasted back into an editor.
234
235 With these features, you can switch into this mode easily whenever you
236 need to do testing and changes to doctests, without having to leave
237 your existing IPython session.
238 rw � doctest_moderm F� rc_pprintr� �rc_separate_out�rc_separate_out2�rc_separate_in�rc_active_typesr% ZPlainrx ry zDoctest mode is:N)rR �metarz r{ �
239 setdefaultr r| r� rm Z separate_outZ
240 separate_out2Z separate_inZ active_typesZrun_line_magicr� r� r� r� r� r� Zswitch_doctest_moderX rY )
241 r r\ rR r� Zdisp_formatterr} ZdstoreZ save_dstorerm Z
242 mode_labelr r r r� � s<
243
244 zBasicMagics.doctest_modec
245 C s^ | � |d�\}}|dkrd}z| j�|�W S ty. } z
246 tt|�� W Y d}~dS d}~ww )ak Enable or disable IPython GUI event loop integration.
247
248 %gui [GUINAME]
249
250 This magic replaces IPython's threaded shells that were activated
251 using the (pylab/wthread/etc.) command line flags. GUI toolkits
252 can now be enabled at runtime and keyboard
253 interrupts should work without any problems. The following toolkits
254 are supported: wxPython, PyQt4, PyGTK, Tk and Cocoa (OSX)::
255
256 %gui wx # enable wxPython event loop integration
257 %gui qt # enable PyQt/PySide event loop integration
258 # with the latest version available.
259 %gui qt6 # enable PyQt6/PySide6 event loop integration
260 %gui qt5 # enable PyQt5/PySide2 event loop integration
261 %gui gtk # enable PyGTK event loop integration
262 %gui gtk3 # enable Gtk3 event loop integration
263 %gui gtk4 # enable Gtk4 event loop integration
264 %gui tk # enable Tk event loop integration
265 %gui osx # enable Cocoa event loop integration
266 # (requires %matplotlib 1.1)
267 %gui # disable all event loop integration
268
269 WARNING: after any of these has been called you can simply create
270 an application object, but DO NOT start the event loop yourself, as
271 we have already handled that.
272 r% N)rq rR Z
273 enable_gui� Exceptionr rl )r r\ rs r� �er r r �gui� s ��zBasicMagics.guic C s | j jjd }||_|jS )ai Set floating point precision for pretty printing.
274
275 Can set either integer precision or a format string.
276
277 If numpy has been imported and precision is an int,
278 numpy display precision will also be set, via ``numpy.set_printoptions``.
279
280 If no argument is given, defaults will be restored.
281
282 Examples
283 --------
284 ::
285
286 In [1]: from math import pi
287
288 In [2]: %precision 3
289 Out[2]: '%.3f'
290
291 In [3]: pi
292 Out[3]: 3.142
293
294 In [4]: %precision %i
295 Out[4]: '%i'
296
297 In [5]: pi
298 Out[5]: 3
299
300 In [6]: %precision %e
301 Out[6]: '%e'
302
303 In [7]: pi**10
304 Out[7]: 9.364805e+04
305
306 In [8]: %precision
307 Out[8]: '%r'
308
309 In [9]: pi**10
310 Out[9]: 93648.047476082982
311 rw )rR rz r{ Zfloat_precisionZ float_format)r �sr} r r r � precision s *zBasicMagics.precision�filenamezNotebook name or filename)�typerH c
312 C s� t �| j|�}tj�|j�}ddlm}m } g }t
313 | j j �
314 � �}t|�dkr*td��|dd� D ]\}} }
315 |�|j| |
316 d�� q0|j|d�} tj|d d
317 d ��} || | d d
318 � W d � dS 1 saw Y dS )z�Export and convert IPython notebooks.
319
320 This function can export the current IPython history to a notebook file.
321 For example, to export the history to "foo.ipynb" do "%notebook foo.ipynb".
322 r )�write�v4rM z History is empty, cannot exportNrN )�execution_count�source)�cells�wzutf-8)�encoding� )�version)r rP �notebook�os�path�
323 expanduserr� Znbformatr� r� �listrR Zhistory_managerZ get_range�len�
324 ValueError�appendZ
325 new_code_cellZ new_notebook�io�open)
326 r r� rZ Zoutfnamer� r� r� �hist�sessionr� r� �nb�fr r r r� : s
327 � "�zBasicMagics.notebook)r% )FF)r: rC rD �__doc__r r Zargumentr rQ r' rh rn r r| r� r� r� r� r� r� rl r� r r r r rE I sn �����O
328 J 0
329 N %,�rE c @ s e Zd Zedd� �ZdS )� AsyncMagicsc C s� |� � }ddd�}|std�|| jj | jj�� dS |�� dv r'd| j_dS |�� dv r3d | j_dS || jjv rG| jj| \| j_| j_dS || jjv r[| jj| | j_d | j_dS t |�}|| j_d | j_dS )
330 aV
331 Allow to change the status of the autoawait option.
332
333 This allow you to set a specific asynchronous code runner.
334
335 If no value is passed, print the currently used asynchronous integration
336 and whether it is activated.
337
338 It can take a number of value evaluated in the following order:
339
340 - False/false/off deactivate autoawait integration
341 - True/true/on activate autoawait integration using configured default
342 loop
343 - asyncio/curio/trio activate autoawait integration and use integration
344 with said library.
345
346 - `sync` turn on the pseudo-sync integration (mostly used for
347 `IPython.embed()` which does not run IPython with a real eventloop and
348 deactivate running asynchronous code. Turning on Asynchronous code with
349 the pseudo sync loop is undefined behavior and may lead IPython to crash.
350
351 If the passed parameter does not match any of the above and is a python
352 identifier, get said object from user namespace and set it as the
353 runner, and activate autoawait.
354
355 If the object is a fully qualified object name, attempt to import it and
356 set it as the runner, and activate autoawait.
357
358 The exact behavior of autoawait is experimental and subject to change
359 across version of IPython and Python.
360 �on�off)TFz.IPython autoawait is `{}`, and set to use `{}`N)�falser� F)�truer� T)
361 r� rY �formatrR � autoawaitZ loop_runner�lowerZloop_runner_mapZuser_nsr )r r\ �paramr= �runnerr r r r� [ s0 "
362
363 � zAsyncMagics.autoawaitN)r: rC rD r r� r r r r r� X s r� )"r� �loggingr r� r� r| r r� �warningsr Z traitlets.utils.importstringr Z IPython.corer r ZIPython.core.errorr ZIPython.core.magicr r
364 r r ZIPython.utils.textr
365 r r ZIPython.testing.skipdoctestr ZIPython.utils.ipstructr �objectr rE r� r r r r �<module> s. 5