| Server IP : 35.80.110.71 / Your IP : 216.73.216.170 Web Server : Apache/2.4.58 (Ubuntu) System : Linux ip-172-31-21-44 6.17.0-1019-aws #19~24.04.1-Ubuntu SMP Tue Jun 23 18:53:06 UTC 2026 x86_64 User : ubuntu ( 1000) PHP Version : 8.3.31 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /lib/python3/dist-packages/IPython/core/__pycache__/ |
Upload File : |
�
}�e�p � �� � d Z ddlZddlZddlZddlmZmZ ddlmZ ddlm Z ddl
m Z ddl m
Z
mZ d d
lmZ d d lmZ d d lmZ dd
lmZmZmZmZ ddlm
Z
ei i �� Z dZ dZ ee
e�� Z G d� d� Z d� Z!d� Z"d� Z#d� Z$d� Z%d� Z&dZ'd� Z(d� Z)d Z*d Z+d � Z,d � Z- e(d � Z. e(d!� Z/ e(d"� Z0 e)d � Z1 e)d!� Z2 e)d"� Z3 G d#� d$e� Z4 G d%� d&e� Z5 G d'� d(e6� Z7y))z&Magic functions for InteractiveShell.
� N)�getopt� GetoptError)� Configurable� )�oinspect)�
UsageError)� ESC_MAGIC�
ESC_MAGIC2� )�Struct)� arg_split)�dedent)�Bool�Dict�Instance�observe)�error��line�cell)r r � line_cellc � � e Zd Zy)�BunchN)�__name__�
__module__� __qualname__� � �4/usr/lib/python3/dist-packages/IPython/core/magic.pyr r 1 s � r r c � � ddg| S )zAReturn an ON/OFF string for a 1/0 input. Simple utility function.�OFF�ONr )�tags r �on_offr$ 4 s � � �$�<�� � r c � � | dd | dd }}g }t � }|D ]) }||v r�|j |� |j |� �+ ||z S )z�Compress a directory history into a new one with at most 20 entries.
Return a new list made from the first and last 10 elements of dhist after
removal of duplicates.
Ni����)�set�append�add)�dh�head�tail�newhead�done�hs r �compress_dhistr/ 9 sa � � �D�S��2�c�d�8�$�D��G� �5�D�
� �� ��9� ����q�� ���� � � �T�>�r c � � d| _ | S )zCDecorator to mark magic functions which need to local scope to run.T)�needs_local_scope)�funcs r r1 r1 L s � � !�D�� �Kr c �x � d| _ t t d t d �� | _ i t d< i t d< | S )a� Class decorator for all subclasses of the main Magics class.
Any class that subclasses Magics *must* also apply this decorator, to
ensure that all the methods that have been decorated as line/cell magics
get correctly registered in the class instance. This is necessary because
when method decorators run, the class does not exist yet, so they
temporarily store their information into a module global. Application of
this class decorator copies that global data to the class instance and
clears the global.
Obviously, this mechanism is not thread-safe, which means that the
*creation* of subclasses of Magic should only be done in a single-thread
context. Instantiation of the classes has no restrictions. Given that
these classes are typically created at IPython startup time and before user
application code becomes active, in practice this should not pose any
problems.
Tr r r )�
registered�dict�magics)�clss r � magics_classr8 U s; � �$ �C�N��V�F�^� #�F�^�-�C�J��F�6�N��F�6�N� �Jr c �@ � |dk( r|x| d |< | d |< y|| | |< y)aS Utility function to store a function as a magic of a specific kind.
Parameters
----------
dct : dict
A dictionary with 'line' and 'cell' subdicts.
magic_kind : str
Kind of magic to be stored.
magic_name : str
Key to store the magic as.
func : function
Callable object to store.
r r r Nr )�dct�
magic_kind�
magic_namer2 s r � record_magicr= o s6 � � �[� �<@�@��F� �J� �#�f�+�j�"9�&*��J��
�#r c �: � | t vrt dt z | � �y)z�Ensure that the given magic_kind is valid.
Check that the given magic_kind is one of the accepted spec types (stored
in the global `magic_spec`), raise ValueError otherwise.
�&magic_kind must be one of %s, %s givenN)�
magic_spec�
ValueError� magic_kinds)r; s r �
validate_typerC � s, � � ��#��A�$�%�&0�2� 2� $r a� Decorate the given {0} as {1} magic.
The decorator can be used with or without arguments, as follows.
i) without arguments: it will create a {1} magic named as the {0} being
decorated::
@deco
def foo(...)
will create a {1} magic named `foo`.
ii) with one string argument: which will be used as the actual name of the
resulting magic::
@deco('bar')
def foo(...)
will create a {1} magic named `bar`.
To register a class magic use ``Interactiveshell.register_magic(class or instance)``.
c �^ � � t � � � fd�}t j d� � |_ |S )z8Decorator factory for methods in Magics subclasses.
c � ��� t | � r$| }|j �| }t t ���� |S t | t
� r | ���fd�}|}|S t
d� �)Nc �@ �� t t ��| j � | S �N)r= r6 r )r2 �a�kwr; �names ��r �markz6_method_magic_marker.<locals>.magic_deco.<locals>.mark� s �� � �V�Z��t�}�}�E�� r �4Decorator can only be called with string or function)�callabler r= r6 �
isinstance�str� TypeError)�argr2 �retvalrK rJ r; s @�r �
magic_decoz(_method_magic_marker.<locals>.magic_deco� sj �� � �C�=��D��=�=�D��F� ���T�4� 8� �
� ��S�
!��D�
� �F� �
� � 1� 2�
2r �method)rC �_docstring_template�format�__doc__)r; rS s ` r �_method_magic_markerrX � s/ �� � �*� ��( -�3�3�H�j�I�J�� �r c �~ � � t � � � fd�}t j d� � }|t d� z
}||_ |S )z0Decorator factory for standalone functions.
c �R ���� t j d� }dD ]! }t ||� j d� }|��! n t d� � |� �t | � r%| }|j ��j |� �� | }|S t | t � r
| ��� �fd�}|}|S t d� �)Nr )�f_locals� f_globals�
f_builtins� get_ipythonz<Decorator can only run in context where `get_ipython` existsc �. �� �j | ��� | S rG )�register_magic_function)r2 rH rI �ipr; rJ s ���r rK z8_function_magic_marker.<locals>.magic_deco.<locals>.mark� s �� ��*�*�4��T�B�� r rL ) �sys� _getframe�getattr�get� NameErrorrM r r` rN rO rP )
rQ �caller�nsr^ r2 rR rK ra rJ r; s
@@�r rS z*_function_magic_marker.<locals>.magic_deco� s� �� �� � �q�!��9� 4�B�!�&�"�-�1�1�-�@�K��&�� 4�
� 3� 4�
4� �]�� �C�=��D��=�=�D� � &� &�t�Z�� >��F� �
� ��S�
!��D�
� �F� �
� � 2� 3�
3r �functiona�
Note: this decorator can only be used in a context where IPython is already
active, so that the `get_ipython()` call succeeds. You can therefore use
it in your startup files loaded after IPython initializes, but *not* in the
IPython configuration file itself, which is executed before IPython is
fully up and running. Any file located in the `startup` subdirectory of
your configuration profile will be OK in this sense.
)rC rU rV r rW )r; rS �dss ` r �_function_magic_markerrk � sM �� � �*� � �@
� #� #�J�
� ;�B��&� � � �B� �J�� �r � _ipython_magic_no_var_expand�%_ipython_magic_output_can_be_silencedc �( � t | t d� | S )a� Mark a magic function as not needing variable expansion
By default, IPython interprets `{a}` or `$a` in the line passed to magics
as variables that should be interpolated from the interactive namespace
before passing the line to the magic function.
This is not always desirable, e.g. when the magic executes Python code
(%timeit, %time, etc.).
Decorate magics with `@no_var_expand` to opt-out of variable expansion.
.. versionadded:: 7.3
T)�setattr�MAGIC_NO_VAR_EXPAND_ATTR��
magic_funcs r �
no_var_expandrs s � � �J�0�$�7� �r c �( � t | t d� | S )z�Mark a magic function so its output may be silenced.
The output is silenced if the Python code used as a parameter of
the magic ends in a semicolon, not counting a Python comment that can
follow it.
T)ro � MAGIC_OUTPUT_CAN_BE_SILENCEDrq s r �output_can_be_silencedrv s � � �J�4�d�;� �r r r r c �, � � e Zd ZdZ e� Z ed�� j
d�� Z e� Z e dd�� Z
e dd�� j
d�� Z e
d � d
� � Zd d gZ e d
d�� Zd� fd� Zd� Zd� Zdd�Zdedefd�Zd� Zdd�Zdd�Z� xZS )�
MagicsManagerzEObject that handles all magic-related functionality for IPython.
aM
Mapping from magic names to modules to load.
This can be used in IPython/IPykernel configuration to declare lazy magics
that will only be imported/registered on first use.
For example::
c.MagicsManager.lazy_magics = {
"my_magic": "slow.to.import",
"my_other_magic": "also.slow",
}
On first invocation of `%my_magic`, `%%my_magic`, `%%my_other_magic` or
`%%my_other_magic`, the corresponding module will be loaded as an ipython
extensions as if you had previously done `%load_ext ipython`.
Magics names should be without percent(s) as magics can be both cell
and line magics.
Lazy loading happen relatively late in execution process, and
complex extensions that manipulate Python/IPython internal state or global state
might not support lazy loading.
)�helpT)�configz1IPython.core.interactiveshell.InteractiveShellABC)�
allow_nonezBAutomatically call line magics without requiring explicit % prefix�
auto_magicc �, � |d | j _ y )N�new)�shell� automagic)�self�changes r �_auto_magic_changedz!MagicsManager._auto_magic_changeda s � � %�e�}��
�
� r z5Automagic is OFF, % prefix IS needed for line magics.z8Automagic is ON, % prefix IS NOT needed for line magics.z IPython.core.magics.UserMagicsc � �� t t | �
d|||d�|�� t i i �� | _ || j
|j j < y )N)r rz � user_magicsr r )�superrx �__init__r5 r6 �registry� __class__r )r� r rz r� �traitsr� s �r r� zMagicsManager.__init__k sT �� �
�m�T�+� N�%��7B� N�FL� N����,�� � 9D��
�
�k�+�+�4�4�5r c �4 � | j | j S )z0Return descriptive string with automagic status.)� _auto_statusr| �r� s r � auto_statuszMagicsManager.auto_statust s � �� � �� � �1�1r c � � | j S )z�Return a dict of currently available magic functions.
The return dict has the keys 'line' and 'cell', corresponding to the
two types of magics we support. Each value is a list of names.
)r6 r� s r �lsmagiczMagicsManager.lsmagicx s � � �{�{�r c �, � i }| j D ]� }i }| j | j � D ]Y \ }}|j rC|r#|j j dd� d ||< �7|j j � ||< �U|||< �[ |||< �� |S )a� Return dict of documentation of magic functions.
The return dict has the keys 'line' and 'cell', corresponding to the
two types of magics we support. Each value is a dict keyed by magic
name whose value is the function docstring. If a docstring is
unavailable, the value of `missing` is used instead.
If brief is True, only the first line of each docstring will be returned.
�
r r )r6 �itemsrW �split�rstrip)r� �brief�missing�docs�m_type�m_docs�m_name�m_funcs r � lsmagic_docszMagicsManager.lsmagic_docs� s� � � ���k�k�
"�F��F�"&�+�+�f�"5�";�";�"=�
-�����>�>� �)/� � �)=�)=�d�A�)F�q�)I��v��)/� � �)>�)>�)@��v��%,�F�6�N�
-� "�D��L�
"� � r rJ �fully_qualified_namec �" � || j |< y)a�
Lazily register a magic via an extension.
Parameters
----------
name : str
Name of the magic you wish to register.
fully_qualified_name :
Fully qualified name of the module/submodule that should be loaded
as an extensions when the magic is first called.
It is assumed that loading this extensions will register the given
magic.
N)� lazy_magics)r� rJ r� s r �
register_lazyzMagicsManager.register_lazy� s � � "6����� r c �8 � |D ]� }|j s t d� �t |t � r || j �� }|| j
|j j < t D ]- }| j | j |j | � �/ �� y)aJ Register one or more instances of Magics.
Take one or more classes or instances of classes that subclass the main
`core.Magic` class, and register them with IPython to use the magic
functions they provide. The registration process will then ensure that
any methods that have decorated to provide line and/or cell magics will
be recognized with the `%x`/`%%x` syntax as a line/cell magic
respectively.
If classes are given, they will be instantiated with the default
constructor. If your classes need a custom constructor, you should
instanitate them first and pass the instance.
The provided arguments can be an arbitrary mix of classes and instances.
Parameters
----------
*magic_objects : one or more classes or instances
zOClass of magics %r was constructed without the @register_magics class decorator)r N) r4 rA rN �typer r� r� r rB r6 �update)r� �
magic_objects�m�mtypes r �registerzMagicsManager.register� s� � �, � ;�A��<�<� � "H� I� I��!�T�"��D�J�J�'�� 34�D�M�M�!�+�+�.�.� /�$�
;��� � �E�"�)�)�!�(�(�5�/�:�
;� ;r c � � t |� |� |j n|}t | j ||� t | j
|||� y)a� Expose a standalone function as magic function for IPython.
This will create an IPython magic (line, cell or both) from a
standalone function. The functions should have the following
signatures:
* For line magics: `def f(line)`
* For cell magics: `def f(line, cell)`
* For a function that does both: `def f(line, cell=None)`
In the latter case, the function will be called with `cell==None` when
invoked as `%f`, and with cell as a string when invoked as `%%f`.
Parameters
----------
func : callable
Function to be registered as a magic.
magic_kind : str
Kind of magic, one of 'line', 'cell' or 'line_cell'
magic_name : optional str
If given, the name the magic will have in the IPython namespace. By
default, the name of the function itself is used.
N)rC r ro r� r= r6 )r� r2 r; r< s r �register_functionz MagicsManager.register_function� s@ � �6 �j�!�&0�&8�T�]�]�j�
��� � �*�d�3��T�[�[�*�j�$�?r c �� � |t vrt dt z |� �t | j |||� }t | j
||� t
| j |||� y)a3 Register an alias to a magic function.
The alias is an instance of :class:`MagicAlias`, which holds the
name and kind of the magic it should call. Binding is done at
call time, so if the underlying magic function is changed the alias
will call the new function.
Parameters
----------
alias_name : str
The name of the magic to be registered.
magic_name : str
The name of an existing magic.
magic_kind : str
Kind of magic, one of 'line' or 'cell'
r? N)rB rA �
MagicAliasr ro r� r= r6 )r� �
alias_namer< r; � magic_params�aliass r �register_aliasz MagicsManager.register_alias� sa � �( �[� (� � E� (� )�*4�6�
6� �4�:�:�z�:�|�L���� � �*�e�4��T�[�[�*�j�%�@r )NNN)F� )r N)r r r rW r r6 r# r� r� r r r r| r r� r� r� r� r� r� r� rO r� r� r� r� �
__classcell__�r� s @r rx rx 3 s� �� �� �V�F����2
�c��
� �3 �< �v�H� �H�UY� Z�E��d�L�� �c��c�� �
�\��-� �-� @�B�D�L� �;��M�K�D�2���06�#� 6�S� 6�$";�H @�@Ar rx c �L � � e Zd ZdZdZdZdZdZd � fd� Zd� Z d� Z
d� Z d� Z � xZ
S )
�Magicsa� Base class for implementing magic functions.
Shell functions which can be reached as %function_name. All magic
functions should accept a string, which they can parse for their own
needs. This can make some functions easier to type, eg `%cd ../`
vs. `%cd("../")`
Classes providing magic functions need to subclass this class, and they
MUST:
- Use the method decorators `@line_magic` and `@cell_magic` to decorate
individual methods as magic functions, AND
- Use the class decorator `@magics_class` to ensure that the magic
methods are properly registered at the instance level upon instance
initialization.
See :mod:`magic_functions` for examples of actual implementation classes.
NFc � �� | j j s t d� �|�Et |d� r|j j | � t |d� r|j
d|� || _ i | _ | j }i | _ t D ]U }i x}| j |< || }|j � D ]* \ }}t |t � rt | |� ||< �&|||< �, �W t t | �F di |�� y )NzMMagics subclass without registration - did you forget to apply @magics_class?�
configurablesrz �parentr )r� r4 rA �hasattrr� r' �
setdefaultr �
options_tabler6 rB r� rN rO rd r� r� r� )
r� r �kwargs� class_magicsr� �tab�cls_tabr< � meth_namer� s
�r r� zMagics.__init__* s �� ��~�~�(�(� � F� G�
G� � ��u�o�.��#�#�*�*�4�0��u�h�'��!�!�(�E�2���
� ��� �{�{� ��� � � 0�E�')� )�C�$�+�+�e�$�"�5�)�G�)0� � � �
0�%�
�I� �i��-�&-�d�I�&>�C�
�O� '0�C�
�O�
0� 0� �f�d�$�.�v�.r c �V � t d� t t j |� � y)z2Print docstring if incorrect arguments were passedzError in arguments:N)�printr �getdoc)r� r2 s r �arg_errzMagics.arg_errL s � �
�#�$�
�h�o�o�d�#�$r c � � t j dt j � }t j dt z t j � }t j dt z t j � }t j dt j � }t j d� }|j d|� }|j d|� }|j d|� }|j d |� }|j d
|� }|S ) z$Format a string for latex inclusion.z (%|_|\$|#|&)z ^(%s.*?):z(?P<cmd>%s.+?\b)(?!\}\}:)z\\$z\\nz%\n\\bigskip\n\\texttt{\\textbf{ \1}}:z\\texttt{\g<cmd>}z\\\\z\\\1z\\textbackslash{}n)�re�compile� MULTILINEr �sub)r� �strng� escape_re� cmd_name_re�cmd_re�par_re�
newline_res r � format_latexzMagics.format_latexQ s� � � �J�J��r�|�|�<� ��j�j� � �!9�!#� � �/� � ��� 8�9� D� �L�L�*�� ���F�2�<�<�0�� �Z�Z��'�
� ��� H� %�'���
�
�/��6���
�
�7�5�)���
�
�g�e�,����� 4�U�;��� r c
�4 � t j d� j j }| j j |d� �d|��}|j dd� }|dvrt
d|z � �|j dd � }|j d
t j d
k( � }|j d d � } |j d
d� }
|} i } |j � }
t |
� dk\ r�t ||| � } t |||� \ }}
|D ]a \ }}|dk( r&|
r$| j# |dd� j# |dd� } |j% d� r|dd }n|dd } | | j' |� �c t- | � }|dk( r'|
r| j/ � }
||
fS dj! |
� }
||
fS # t $ r3}t |j �d|�ddj! |� �d�� |�d}~ww xY w# t( $ r
| | |g| |< Y ��t* $ r |r|g| |< n|| |< Y �� w xY w)al Parse options passed to an argument string.
The interface is similar to that of :func:`getopt.getopt`, but it
returns a :class:`~IPython.utils.struct.Struct` with the options as keys
and the stripped argument string still as a string.
arg_str is quoted as a true sys.argv vector by using shlex.split.
This allows us to easily expand variables, glob files, quote
arguments, etc.
Parameters
----------
arg_str : str
The arguments to parse.
opt_str : str
The options specification.
mode : str, default 'string'
If given as 'list', the argument string is returned as a list (split
on whitespace) instead of a string.
list_all : bool, default False
Put all option values in lists. Normally only options
appearing more than once are put in a list.
posix : bool, default True
Whether to split the input line in POSIX mode or not, as per the
conventions outlined in the :mod:`shlex` module from the standard
library.
r r� � �mode�string)r� �listzincorrect mode given: %s�list_allr �posix�strictT�preserve_non_optsFz
( allowed: "z" �)Nz--r )rb rc �f_code�co_namer� re rA �osrJ r� �lenr
r r r �msg�join�replace�
startswithr' �AttributeError�KeyErrorr �lstrip)r� �arg_str�opt_str� long_optsrI rg r� r� r� r� r� �remainder_arg_str�odict�args�argv�opts�e�orH s r �
parse_optionszMagics.parse_optionsl s@ � �< � � �q�!�(�(�0�0�� !� /� /� 3� 3�F�2� >�w�G���v�v�f�X�&�� �(� (� � 7�$� >�?� ?��6�6�*�Q�'�����w����7� 2�3������$�'�� �F�F�#6�� >�� #�� ���}�}��� �t�9��>� �W�e�V�4�D�
� "�4��)� <� ��T�
�
%���1��8�#�(9� ):�(A�(A�!�R��(K�(S�(S��2�q�)�%� �<�<��%��!�"��A��!�"��A�%��!�H�O�O�A�&�
%�. �e�}�� �8� � �(�/�/�1�� �D�y�� �x�x��~���D�y���E �
� �01���w�����@S�T�����
��$ &� ,� %�a���|�E�!�H� � %� �$%�3��a��#$��a��� %�s0 �8F) �G(�) G%�2.G � G%�(H�=H�Hc �b � || j � vrt d|z � || j |< y)z<Make an entry in the options_table for fn, with value optstrz%s is not a magic functionN)r� r r� )r� �fn�optstrs r �default_optionzMagics.default_option� s0 � � �T�\�\�^� #� �.��3� 4�!'����2� r rG )r r r rW r� r6 r4 r r� r� r� r� r� r� r� s @r r� r�
s: �� ��( �M�
�F��J� �E� /�D%�
�6X�t(r r� c � � e Zd ZdZdd�Zd� Zy)r� aZ An alias to another magic function.
An alias is determined by its magic name and magic kind. Lookup
is done at call time, so if the underlying magic changes the alias
will call the new function.
Use the :meth:`MagicsManager.register_alias` method or the
`%alias_magic` magic function to create and register a new alias.
Nc � � || _ || _ || _ || _ t | j �| j ��| _ d| j
z | _ d| _ y )NzAlias for `%s`.F)r r< r� r; �
magic_escapes�
pretty_targetrW �_in_call)r� r r< r; r� s r r� zMagicAlias.__init__� sR � ���
�$��� (���$���'4�T�_�_�'E�t��� W���(�4�+=�+=�=�� � ��
r c �~ � | j j | j | j � }|�t d| j
z � �| j r t d� �d| _ | j r.t |� }| j dz |d z |d< t |� } ||i |��d| _ S # d| _ w xY w)zCall the magic alias.zMagic `%s` not found.zBInfinite recursion detected; magic aliases cannot call themselves.Tr� r F)
r �
find_magicr< r; r r� r� r� r� �tuple)r� r� r� r� � args_lists r �__call__zMagicAlias.__call__� s� � �
�Z�Z�
"�
"�4�?�?�D�O�O�
D��
�:� � 4�t�7I�7I� I�J� J� �=�=� � E� F�
F� ��
� "�� � � ��J� � #� 0� 0�3� 6��a�� @� �!� � �Y�'���t�&�v�&� !�D�M��E�D�M�s
�*AB3 �3 B<rG )r r r rW r� r� r r r r� r� � s � �� �"r r� )8rW r� r� rb r r � traitlets.config.configurabler r� r r r �inputtransformer2r r
�utils.ipstructr �
utils.processr
�
utils.textr � traitletsr r r r �loggingr5 r6 rB r@ r� r r$ r/ r1 r8 r= rC rU rX rk rp ru rs rv �
line_magic�
cell_magic�line_cell_magic�register_line_magic�register_cell_magic�register_line_cell_magicrx r� �objectr� r r r �<module>r
s ���
� �
� &� 6� � � 4� #� %� � 3� 3� �
�2�B� �� � �
*�
��)�*�5�
� � � �
�&��4+�(2� � �: �@3�l :� � F� �
� � "�&�
)�
�
!�&�
)�
�&�{�3�� -�V�4� �,�V�4� �1�+�>� � UA�L� UA�t~(�\� ~(�B'"�� '"r