U
e5dg;
@ s d Z ddlmZ ddlmZmZ ddlmZ ddl m
Z
dd Z dd Z d
d Z
d d
ZdWddZdd Zdd Zdd Ze e
fddZdXddZdd 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\dQdRZ1ej/ej.ej2hZ3dSdT Z4d]dUdVZ5dS )^z1Utility functions, node construction macros, etc. )token)LeafNode)python_symbols)patcompc C s t tj| ttjd|gS )N=)r symsZargumentr r EQUAL)keywordvalue r */usr/lib64/python3.8/lib2to3/fixer_util.py
KeywordArg s r c C s t tjdS )N()r r LPARr r r r
LParen s r c C s t tjdS )N))r r RPARr r r r
RParen s r c C sH t | ts| g} t |ts&d|_|g}ttj| ttjdddg | S )z Build an assignment statement r prefix)
isinstancelistr r r atomr r r )targetsourcer r r
Assign s
r Nc C s t tj| |dS )zReturn a NAME leafr )r r NAME)namer r r r
Name$ s r c C s | t tjt |ggS )zA node tuple for obj.attr)r r trailerDot)objattrr r r
Attr( s r% c C s t tjdS )z A comma leaf,)r r COMMAr r r r
Comma, s r( c C s t tjdS )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_childarglist)argsZlparenZrparennoder 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 tjdS )zA newline literal
r r NEWLINEr r r r
NewlineB s r6 c C s t tjdS )z A blank line r4 r r r r
BlankLineF s r8 c C s t tj| |dS )Nr )r r NUMBER)nr r r r
NumberJ s r; c C s" t tjttjd| ttjdgS )z A numeric or string subscript[])r r r! r r LBRACERBRACE)Z
index_noder r r
SubscriptM s
r@ c C s t tj| |dS )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 dgS )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 forinifr< r= )
r r r r appendr r Zcomp_ifZ listmakerZcomp_forr r> r? ) ZxpfpitZtestZfor_leafZin_leafZ
inner_argsZif_leafinnerr r r
ListCompW s(
rK c C sV |D ] }| qttjdttj| ddttjdddttj|g}ttj|}|S )zO Return an import statement in the form:
from package import name_leafsfromr r import)remover r r r r import_as_names import_from)Z package_nameZ
name_leafsZleafchildrenimpr r r
FromImporto s
rS c C s |d }|jtjkr"| }nttj| g}|d }|rNdd |D }ttjtt|d t|d ttj|d ||d gg | }| 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/ resultsnamesr# Z
newarglistrT newr r r
ImportAndCall s*
r\ c C s t | tr | jt t gkr dS t | tot| jdkot | jd tot | jd tot | jd to| 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 | toVt| jdkoVt | jd toVt | jd toV| 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 gS N)r r r r r r` r r r
parenthesize s re sortedr setanyalltuplesumminmax 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&ttattattada tttg}t|t| dD ]*\}}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.
Tparentr/ F)
pats_builtr Zcompile_patternp0p1p2ziprq match)r/ Zpatternspatternrr 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 | krdS dS )zG
Check that something isn't an attribute or function name etc.
NFrW T)
Z prev_siblingrX r r* rr r funcdefclassdef expr_stmtrQ Z
parametersZ
typedargslistr' )r/ prevrr r r r
is_probably_builtin s&
r c C sJ | dk rF| j tjkr>t| jdkr>| 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 tdq | 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|jD ]F\}}||sDq2t|j|d D ]\}}||sV qlqV|| } qzq2|dkrt|jD ]8\}}|jtjkr|jr|jd jtjkr|d } qq| dkrt tj
t tj dt tj |ddg} nt
| t tj |ddg} | 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_posoffsetidxZnode2import_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|jtjtjfkrt| t|j d |}|r|} n|jtj krt| t|j d |}|r|}nTt
|j dd D ]@\}}|jt j kr|j
dkrt| t|j |d |}|r|}qnx|jtkr2|j d j
| kr2|}nTt|| |rF|}n@|jtjkrbt| ||}n$|jtjkrt| |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_symsextendrQ 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 kr|rt
| jd |krdS | jd }|rt d|rdS |j tj
kr0t ||r0| S |j tjkrh|jd }|j tjkr|j|kr| S n6|j tjkr|j|kr| S |r|j tjkr| 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 strstripr rO Zimport_as_nameSTAR)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`
-
*