U
e5dg; �
@ s� d Z ddlmZ ddlmZmZ ddlmZ ddl m
Z
dd� Z dd � Z d
d � Z
d d
� ZdWdd�Zdd� Zdd� Zdd� Ze � e
� fdd�ZdXdd�Zdd � Zd d � ZdYd d �Zd!d"� ZdZd#d$�Zd[d%d&�Zd'd(� Zd)d*� Z d+d,� Z d-d.� Z d/d0� Z d1d2d3d4d5d6d7d8d9d:h
Z d;d<� Z!d=a"d>a#d?a$d@a%dAdB� Z&dCdD� Z'dEdF� Z(dGdH� Z)dIdJ� Z*dKdL� Z+dMdN� Z,dOdP� Z-ej.ej/hZ0d\dQdR�Z1ej/ej.ej2hZ3dSdT� Z4d]dUdV�Z5dS )^z1Utility functions, node construction macros, etc.� )�token)�Leaf�Node)�python_symbols)�patcompc C s t tj| ttjd�|g�S )N�=)r �symsZargumentr r �EQUAL)�keyword�value� r �*/usr/lib64/python3.8/lib2to3/fixer_util.py�
KeywordArg s �r c C s t tjd�S )N�()r r �LPARr r r r
�LParen s r c C s t tjd�S )N�))r r �RPARr r r r
�RParen s r c C sH t | t�s| g} t |t�s&d|_|g}ttj| ttjddd�g | �S )z Build an assignment statement� r ��prefix) �
isinstance�listr r r �atomr r r )�target�sourcer r r
�Assign s
�r Nc C s t tj| |d�S )zReturn a NAME leafr )r r �NAME)�namer r r r
�Name$ s r c C s | t tjt� |g�gS )zA node tuple for obj.attr)r r �trailer�Dot)�obj�attrr r r
�Attr( s r% c C s t tjd�S )z A comma leaf�,)r r �COMMAr r r r
�Comma, s r( c C s t tjd�S )zA period (.) leaf�.)r r �DOTr r r r
r" 0 s r" c C s4 t tj|�� |�� g�}| r0|�dt tj| �� |S )z-A parenthesised argument list, used by Call()r )r r r! �clone� insert_child�arglist)�argsZlparenZrparen�noder r r
�ArgList4 s r0 c C s& t tj| t|�g�}|dk r"||_|S )zA function callN)r r �powerr0 r )Z func_namer. r r/ r r r
�Call; s r2 c C s t tjd�S )zA newline literal�
�r r �NEWLINEr r r r
�NewlineB s r6 c C s t tjd�S )z A blank line� r4 r r r r
� BlankLineF s r8 c C s t tj| |d�S )Nr )r r �NUMBER)�nr r r r
�NumberJ s r; c C s" t tjttjd�| ttjd�g�S )z A numeric or string subscript�[�])r r r! r r �LBRACE�RBRACE)Z
index_noder r r
� SubscriptM s
�r@ c C s t tj| |d�S )z
A string leafr )r r �STRING)�stringr r r r
�StringS s rC c C s� d| _ d|_ d|_ ttjd�}d|_ ttjd�}d|_ ||||g}|rtd|_ ttjd�}d|_ |�ttj||g�� ttj| ttj |�g�}ttj
ttj d�|ttj d�g�S )zuA list comprehension of the form [xp for fp in it if test].
If test is None, the "if test" part is omitted.
r7 r �for�in�ifr< r= )
r r r r �appendr r Zcomp_ifZ listmakerZcomp_forr r> r? ) Zxp�fp�itZtestZfor_leafZin_leafZ
inner_argsZif_leaf�innerr r r
�ListCompW s(
��rK c C sV |D ] }|� � qttjd�ttj| dd�ttjddd�ttj|�g}ttj|�}|S )zO Return an import statement in the form:
from package import name_leafs�fromr r �import)�remover r r r r �import_as_names� import_from)Z package_nameZ
name_leafsZleaf�children�impr r r
�
FromImporto s
� rS c C s� |d � � }|jtjkr"|� � }nttj|� � g�}|d }|rNdd� |D �}ttjtt|d �t|d ��ttj|d � � ||d � � g�g | �}| j |_ |S ) zfReturns an import statement and calls a method
of the module:
import module
module.name()r# �afterc S s g | ] }|� � �qS r )r+ )�.0r: r r r
�
� s z!ImportAndCall..� r ZlparZrpar)
r+ �typer r- r r1 r% r r! r )r/ �results�namesr# Z
newarglistrT �newr r r
�
ImportAndCall� s*
�����r\ c C s� t | t�r | jt� t� gkr dS t | t�o�t| j�dko�t | jd t�o�t | jd t�o�t | jd t�o�| jd jdko�| jd jdkS )z(Does the node represent a tuple literal?T� rW r � r r )r r rQ r r �lenr r �r/ r r r
�is_tuple� s
������ra c C sX t | t�oVt| j�dkoVt | jd t�oVt | jd t�oV| jd jdkoV| jd jdkS )z'Does the node represent a list literal?r rW �����r< r= )r r r_ rQ r r r` r r r
�is_list� s
�����rc c C s t tjt� | t� g�S �N)r r r r r r` r r r
� parenthesize� s re �sortedr �set�any�all�tuple�sum�min�max� enumeratec c s$ t | |�}|r |V t ||�}q
dS )al Follow an attribute chain.
If you have a chain of objects where a.foo -> b, b.foo-> c, etc,
use this to iterate over all objects in the chain. Iteration is
terminated by getattr(x, attr) is None.
Args:
obj: the starting object
attr: the name of the chaining attribute
Yields:
Each successive object in the chain.
N)�getattr)r# r$ �nextr r r
�
attr_chain� s
rq zefor_stmt< 'for' any 'in' node=any ':' any* >
| comp_for< 'for' any 'in' node=any any* >
z�
power<
( 'iter' | 'list' | 'tuple' | 'sorted' | 'set' | 'sum' |
'any' | 'all' | 'enumerate' | (any* trailer< '.' 'join' >) )
trailer< '(' node=any ')' >
any*
>
z`
power<
( 'sorted' | 'enumerate' )
trailer< '(' arglist ')' >
any*
>
Fc C sp t s&t�t�at�t�at�t�ada tttg}t|t| d��D ]*\}}i }|�||�r@|d | kr@ dS q@dS )a Returns true if node is in an environment where all that is required
of it is being iterable (ie, it doesn't matter if it returns a list
or an iterator).
See test_map_nochange in test_fixers.py for some examples and tests.
T�parentr/ F) �
pats_builtr Zcompile_pattern�p0�p1�p2�ziprq �match)r/ Zpatterns�patternrr rY r r r
�in_special_context� s
rz c C s� | j }|dk r |jtjkr dS | j}|jtjtjfkr:dS |jtjkrX|j d | krXdS |jtj
ks�|jtj kr�|dk r�|jtj ks�|j d | kr�dS dS )zG
Check that something isn't an attribute or function name etc.
NFrW T)
Z prev_siblingrX r r* rr r �funcdef�classdef� expr_stmtrQ Z
parametersZ
typedargslistr' )r/ �prevrr r r r
�is_probably_builtin� s&
��
� �r c C sJ | dk rF| j tjkr>t| j�dkr>| jd }|j tjkr>|jS | j} q dS )z Find the indentation of *node*.Nr^ r r7 ) rX r �suiter_ rQ r �INDENTr rr )r/ �indentr r r
�find_indentation s
r� c C s> | j tjkr| S | �� } | jd }| _ttj| g�}||_|S rd )rX r r� r+ rr r )r/ rr r� r r r
�
make_suite s r� c C s$ | j tjkr | j} | s td��q | S )z Find the top level namespace.z,root found before file_input node was found.)rX r Z
file_inputrr �
ValueErrorr` r r r
� find_root& s
r� c C s t |t|�| �}t|�S )z� Returns true if name is imported from package at the
top level of the tree which node belongs to.
To cover the case of an import like 'import foo', use
None for the package and 'foo' for the name. )� find_bindingr� �bool)�packager r/ Zbindingr r r
�does_tree_import/ s r� c C s | j tjtjfkS )z0Returns true if the node is an import statement.)rX r � import_namerP r` r r r
� is_import7 s r� c C s. dd� }t |�}t| ||�r dS d }}t|j�D ]F\}}||�sDq2t|j|d� �D ]\}}||�sV qlqV|| } qzq2|dkr�t|j�D ]8\}}|jtjkr�|jr�|jd jtjkr�|d } q�q�| dkr�t tj
t tj d�t tj |dd�g�} nt
| t tj |dd�g�} | t� g}
|�|t tj|
�� dS ) z\ Works like `does_tree_import` but adds an import statement
if it was not imported. c S s | j tjko | jo t| jd �S )NrW )rX r � simple_stmtrQ r� r` r r r
�is_import_stmt> s �z$touch_import..is_import_stmtNrW r rM r r )r� r� rn rQ rX r r� r rA r r� r r rS r6 r, ) r� r r/ r� �rootZ
insert_pos�offset�idxZnode2�import_rQ r r r
� touch_import; s8 �
�
r� c C s� |j D �]�}d}|jtjkrVt| |j d �r4| S t| t|j d �|�}|rR|}�n0|jtjtjfkr�t| t|j d �|�}|r�|}� n�|jtj k�rt| t|j d �|�}|r�|}nTt
|j dd� �D ]@\}}|jt j kr�|j
dkr�t| t|j |d �|�}|r�|}q�nx|jtk�r2|j d j
| k�r2|}nTt|| |��rF|}n@|jtjk�rbt| ||�}n$|jtjk�r�t| |j d ��r�|}|r|�s�| S t|�r| S qdS ) z� Returns the node which binds variable name, otherwise None.
If optional argument package is supplied, only imports will
be returned.
See test cases for examples.Nr rb r^ r] �:� rW )rQ rX r Zfor_stmt�_findr� r� Zif_stmtZ
while_stmtZtry_stmtrn r �COLONr � _def_syms�_is_import_bindingr� r} r� )r r/ r� �childZretr: �iZkidr r r
r� i sH
r� c C sT |g}|rP|� � }|jdkr4|jtkr4|�|j� q|jtjkr|j| kr|S qd S )N� )�poprX � _block_syms�extendrQ r r r )r r/ Znodesr r r
r� � s r� c C s� | j tjkr�|s�| jd }|j tjkrx|jD ]H}|j tjkrV|jd j|krt| S q,|j tjkr,|j|kr,| S q,nL|j tjkr�|jd }|j tjkr�|j|kr�| S n|j tjkr�|j|kr�| S n�| j tj k�r�|r�t
| jd �� � |kr�dS | jd }|�rt d|��rdS |j tj
k�r0t ||��r0| S |j tjk�rh|jd }|j tjk�r�|j|k�r�| S n6|j tjk�r�|j|k�r�| S |�r�|j tjk�r�| S dS )z� Will reuturn node if node will import name, or node
will import * from package. None is returned otherwise.
See test cases for examples. r r^ rb Nr] �as)rX r r� rQ Zdotted_as_namesZdotted_as_namer r r rP �str�stripr� rO Zimport_as_name�STAR)r/ r r� rR r� Zlastr: r r r
r� � s@
r� )N)NN)N)N)N)N)N)6�__doc__Zpgen2r Zpytreer r Zpygramr r r7 r r r r r r r% r( r" r0 r2 r6 r8 r; r@ rC rK rS r\ ra rc re Zconsuming_callsrq rt ru rv rs rz r r� r� r� r� r� r� r| r{ r� r� r! r� r� r� r r r r
� s`
� -
*