o
0if; @ s d Z ddlmZ ddlmZmZ ddlmZ ddl m
Z
dd Z dd Z d
d Z
d d
ZdNddZdd Zdd Zdd Ze e
fddZdOddZdd Zd d ZdNd d Zd!d" ZdNd#d$ZdNd%d&Zd'd( Zd)d* Z d+d, Z d-d. Z d/d0 Z h d1Z d2d3 Z!d4a"d5a#d6a$d7a%d8d9 Z&d:d; Z'dd? Z)d@dA Z*dBdC Z+dDdE Z,dFdG Z-ej.ej/hZ0dNdHdIZ1ej/ej.ej2hZ3dJdK Z4dNdLdMZ5dS )Pz1Utility functions, node construction macros, etc. )token)LeafNode)python_symbols)patcompc C s t tj| ttjd|gS )N=)r symsZargumentr r EQUAL)keywordvalue r 9/opt/alt/python310/lib64/python3.10/lib2to3/fixer_util.py
KeywordArg s r c C t tjdS )N()r r LPARr r r r
LParen r c C r )N))r r RPARr r r r
RParen r r c C sH t | ts| g} t |tsd|_|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 t tj| |dS )zReturn a NAME leafr )r r NAME)namer r r r
Name$ r# c C s | t tjt |ggS )zA node tuple for obj.attr)r r trailerDot)objattrr r r
Attr( s r) c C r )z A comma leaf,)r r COMMAr r r r
Comma, r, c C r )zA period (.) leaf.)r r DOTr r r r
r& 0 r- r& c C s4 t tj| | g}| r|dt tj| |S )z-A parenthesised argument list, used by Call()r )r r r% clone insert_childarglist)argsZlparenZrparennoder r r
ArgList4 s r5 c C s& t tj| t|g}|dur||_|S )zA function callN)r r powerr5 r )Z func_namer3 r r4 r r r
Call; s r7 c C r )zA newline literal
r r NEWLINEr r r r
NewlineB r- r; c C r )z A blank line r9 r r r r
BlankLineF r- r= c C r )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
rE c C r )z
A string leafr )r r STRING)stringr r r r
StringS r$ rH c C s d| _ d|_ d|_ ttjd}d|_ ttjd}d|_ ||||g}|r:d|_ 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.
r< r forinifrA rB )
r r r r! appendr r Zcomp_ifZ listmakerZcomp_forr rC rD ) ZxpfpittestZfor_leafZin_leafZ
inner_argsZif_leafinnerr r r
ListCompW s(
rQ 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
rY c C s |d }|jtjkr| }n ttj| g}|d }|r'dd |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 )r0 ).0r? r r r
s z!ImportAndCall.. r ZlparZrpar)
r0 typer r2 r r6 r) r# r% r )r4 resultsnamesr' Z
newarglistrZ newr r r
ImportAndCall s*
rb c C s t | tr| jt t gkrdS t | toCt| jdkoCt | jd toCt | jd toCt | jd toC| jd jdkoC| jd jdkS )z(Does the node represent a tuple literal?T r] r r r )r r rW r r lenr r r4 r r r
is_tuple s
rg c C sX t | to+t| jdko+t | jd to+t | jd to+| jd jdko+| jd jdkS )z'Does the node represent a list literal?r r] rA rB )r r re rW r r rf r r r
is_list s
ri c C s t tjt | t gS N)r r r r r rf r r r
parenthesize s rk >
maxsetminsortedsumalltupler enumerateanyc c s, t | |}|r|V t ||}|sdS 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
rw 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 sttattattada tttg}t|t| dD ]\}}i }|||r5|d | u r5 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.
Tparentr4 F)
pats_builtr Zcompile_patternp0p1p2ziprw match)r4 patternspatternrx r_ r r r
in_special_context s
r c C s | j }|dur|jtjkrdS | j}|jtjtjfv r dS |jtjkr,|j d | u r,dS |jtj
ksI|jtj krK|durB|jtj ksI|j d | u rKdS dS )zG
Check that something isn't an attribute or function name etc.
NFr] T)
Z prev_siblingr^ r r/ rx r funcdefclassdef expr_stmtrW Z
parametersZ
typedargslistr+ )r4 prevrx r r r
is_probably_builtin s r c C sP | dur&| j tjkr t| jdkr | jd }|j tjkr |jS | j} | dusdS )z Find the indentation of *node*.Nrd r r< ) r^ r suitere rW r INDENTr rx )r4 indentr r r
find_indentation s
r c C s> | j tjkr| S | } | jd }| _ttj| g}||_|S rj )r^ r r r0 rx r )r4 rx r r r r
make_suite s r c C s. | j tjkr| j} | std| j tjks| S )z Find the top level namespace.z,root found before file_input node was found.)r^ r Z
file_inputrx
ValueErrorrf 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" r4 Zbindingr r r
does_tree_import/ s r c C s | j tjtjfv S )z0Returns true if the node is an import statement.)r^ r import_namerV rf r r r
is_import7 s r c C s* dd }t |}t| ||rdS d }}t|jD ]!\}}||s"qt|j|d D ]
\}}||s5 nq+|| } |dkrat|jD ] \}}|jtjkr`|jr`|jd jtjkr`|d } nqD| du rxt tj
t tj dt tj |ddg} n t
| 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| jot| jd S )Nr] )r^ r simple_stmtrW r rf r r r
is_import_stmt> s z$touch_import..is_import_stmtNr] r rS r r )r r rs rW r^ r r r rF r r r r! rY r; r1 ) r r" r4 r rootZ
insert_posoffsetidxZnode2import_rW r r r
touch_import; s:
r c C s |j D ]}d}|jtjkr)t| |j d r| S t| t|j d |}|r(|}n|jtjtjfv rBt| t|j d |}|rA|}nw|jtj krt| t|j d |}|rX|}nat
|j dd D ] \}}|jt j kr|j
dkrt| t|j |d |}|r|}qan6|jtv r|j d j
| kr|}n&t|| |r|}n |jtjkrt| ||}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 rh rd rc : r] )rW r^ r Zfor_stmt_findr r Zif_stmtZ
while_stmtZtry_stmtrs r COLONr _def_syms_is_import_bindingr r r )r" r4 r childZretr? iZkidr r r
r i sL
r c C sV |g}|r)| }|jdkr|jtvr||j n
|jtjkr'|j| kr'|S |sd S )N )popr^ _block_symsextendrW r r! r )r" r4 Znodesr r r
r s r c C s | j tjkrf|sf| jd }|j tjkr=|jD ]$}|j tjkr+|jd j|kr*| S q|j tjkr:|j|kr:| S qdS |j tjkrW|jd }|j tjkrU|j|krU| S dS |j tjkrd|j|krd| S dS | j tj kr|r{t
| jd |kr{dS | jd }|rt d|rdS |j tj
krt ||r| S |j tjkr|jd }|j tjkr|j|kr| S dS |j tjkr|j|kr| S |r|j tjkr| S dS )z Will return node if node will import name, or node
will import * from package. None is returned otherwise.
See test cases for examples. r rd rh Nrc as)r^ r r rW Zdotted_as_namesZdotted_as_namer r r! rV strstripr rU Zimport_as_nameSTAR)r4 r" r rX r Zlastr? r r r
r sL
r rj )NN)6__doc__Zpgen2r Zpytreer r Zpygramr r r< r r r r r r# r) r, r& r5 r7 r; r= r@ rE rH rQ rY rb rg ri rk Zconsuming_callsrw rz r{ r| ry r r r r r r r r r r r r r% r r r r r r r
sZ
-
*