Your IP : 3.142.174.206
U
e5dk�@sdZdZddlZddlZddlZddlZddlZddlZddlZddl m
Z
ddlmZm
Z
mZddlmZddlmZmZdd lmZd!dd�ZGd
d�de�Zdd�Zdd�Zdd�Zdd�Zdd�ZGdd�de�ZGdd�de�Z Gdd�de�Z!Gdd �d e �Z"dS)"z�Refactoring framework.
Used as a main program, this can refactor any number of files and/or
recursively descend down directories. Imported as a module, this
provides infrastructure to write your own refactoring tool.
z#Guido van Rossum <guido@python.org>�N)�chain�)�driver�tokenize�token)� find_root)�pytree�pygram)�btm_matcherTcCsTt|ggdg�}g}t�|j�D].\}}}|�d�r |rD|dd�}|�|�q |S)zEReturn a sorted list of all available fix names in the given package.�*�fix_�N)�
__import__�pkgutilZiter_modules�__path__�
startswith�append)Z fixer_pkgZ
remove_prefixZpkgZ fix_names�finder�nameZispkg�r�(/usr/lib64/python3.8/lib2to3/refactor.py�get_all_fix_namess
rc@seZdZdS)�
_EveryNodeN��__name__�
__module__�__qualname__rrrrr+srcCs�t|tjtjf�r(|jdkr t�|jhSt|tj�rH|jrDt|j�St�t|tj �r�t
�}|jD]}|D]}|�t|��qhq`|Std|��dS)zf Accepts a pytree Pattern Node and returns a set
of the pattern types which will match first. Nz$Oh no! I don't understand pattern %s)
�
isinstancerZNodePatternZLeafPattern�typerZNegatedPatternZcontent�_get_head_typesZWildcardPattern�set�update� Exception)Zpat�r�p�xrrrr/s
rc Cs�t�t�}g}|D]x}|jrdzt|j�}Wntk
rH|�|�Yq�X|D]}||�|�qNq|jdk r�||j�|�q|�|�qtt j
j��t j
j
�D]}||�|�q�t|�S)z^ Accepts a list of fixers and returns a dictionary
of head node type --> fixer list. N)�collections�defaultdict�list�patternrrrZ_accept_typerr �python_grammarZ
symbol2number�values�tokens�extend�dict)Z
fixer_listZ
head_nodesZevery�fixerZheadsZ node_typerrr�_get_headnode_dictKs$
�r0cs�fdd�t�d�D�S)zN
Return the fully qualified names for fixers in the package pkg_name.
csg|]}�d|�qS��.r)�.0�fix_name�Zpkg_namerr�
<listcomp>hs�z+get_fixers_from_package.<locals>.<listcomp>F)rr5rr5r�get_fixers_from_packageds
�r7cCs|S�Nr)�objrrr� _identityksr:csXd}t�t�|�j���fdd�}ttjtjtj h�}t
�}z�|�\}}||krTq>q>|tjkrl|rf�q6d}q>|tjk�r6|dk�r6|�\}}|tjks�|dkr��q6|�\}}|tjks�|dkrq6|�\}}|tj
kr�|dkr�|�\}}|tjk�r4|�|�|�\}}|tj
k�s.|d k�r"�q4|�\}}q�q>�q6q>Wntk
�rNYnXt|�S)
NFcst��}|d|dfS)Nrr)�next)�tok��genrr�advancersz(_detect_future_features.<locals>.advanceT�fromZ
__future__�import�(�,)r�generate_tokens�io�StringIO�readline� frozensetr�NEWLINE�NL�COMMENTr �STRING�NAME�OP�add�
StopIteration)�sourceZhave_docstringr?�ignore�features�tp�valuerr=r�_detect_future_featuresosB
rVc@seZdZdZdS)�
FixerErrorzA fixer could not be loaded.N)rrr�__doc__rrrrrW�srWc@s�eZdZddd�ZdZdZd4dd�Zdd �Zd
d�Zdd
�Z dd�Z
dd�Zd5dd�Zd6dd�Z
dd�Zd7dd�Zdd�Zd8dd�Zdd�Zd d!�Zd9d"d#�Zd:d$d%�Zd&Zd'Zd(d)�Zd*d+�Zd,d-�Zd.d/�Zd0d1�Zd2d3�ZdS);�RefactoringToolF)�print_function�write_unchanged_filesZFixrNcCs.||_|pg|_|j��|_|dk r0|j�|�|jdrDtj|_ntj |_|j�
d�|_g|_t
�d�|_g|_d|_tj|jtj|jd�|_|��\|_|_g|_t��|_g|_g|_t|j|j�D]F}|j r�|j�!|�q�||jkr�|j�"|�q�||jkr�|j�"|�q�t#|j�|_$t#|j�|_%dS)z�Initializer.
Args:
fixer_names: a list of fixers to import
options: a dict with configuration.
explicit: a list of fixers to run even if they are explicit.
NrZr[rYF)�convert�logger)&�fixers�explicit�_default_options�copy�optionsr!r �!python_grammar_no_print_statement�grammarr*�getr[�errors�loggingZ getLoggerr]� fixer_log�wroterZDriverrr\�
get_fixers� pre_order�
post_order�files�bmZ
BottomMatcher�BMZ
bmi_pre_orderZbmi_post_orderrZ
BM_compatibleZ add_fixerrr0�bmi_pre_order_heads�bmi_post_order_heads)�selfZfixer_namesrbr_r/rrr�__init__�s>
�
zRefactoringTool.__init__c CsXg}g}|jD�]}t|iidg�}|�dd�d}|�|j�rR|t|j�d�}|�d�}|jd�dd �|D��}zt ||�}Wn&t
k
r�td
||f�d�YnX||j|j
�} | jr�|jdk r�||jkr�|�d|�q|�d
|�| jdk�r|�| �q| jdk�r|�| �qtd| j��qt�d�}
|j|
d�|j|
d�||fS)aInspects the options to load the requested patterns and handlers.
Returns:
(pre_order, post_order), where pre_order is the list of fixers that
want a pre-order AST traversal, and post_order is the list that want
post-order traversal.
rr2r���N�_�cSsg|]}|���qSr)�title)r3r$rrrr6�sz.RefactoringTool.get_fixers.<locals>.<listcomp>zCan't find %s.%sTzSkipping optional fixer: %szAdding transformation: %sZpreZpostzIllegal fixer order: %rZ run_order��key)r^r�rsplitr�FILE_PREFIX�len�split�CLASS_PREFIX�join�getattr�AttributeErrorrWrbrhr_�log_message� log_debug�orderr�operator�
attrgetter�sort)rrZpre_order_fixersZpost_order_fixersZfix_mod_path�modr4�parts�
class_nameZ fix_classr/Zkey_funcrrrrj�s:
�
zRefactoringTool.get_fixerscOs�dS)zCalled when an error occurs.Nr)rr�msg�args�kwdsrrr� log_error�szRefactoringTool.log_errorcGs|r||}|j�|�dS)zHook to log a message.N)r]�info�rrr�r�rrrr�szRefactoringTool.log_messagecGs|r||}|j�|�dSr8)r]�debugr�rrrr� szRefactoringTool.log_debugcCsdS)zTCalled with the old version, new version, and filename of a
refactored file.Nr)rr�old_text�new_text�filename�equalrrr�print_outputszRefactoringTool.print_outputcCs8|D].}tj�|�r$|�|||�q|�|||�qdS)z)Refactor a list of files and directories.N)�os�path�isdir�refactor_dir�
refactor_file)rr�items�write�
doctests_onlyZdir_or_filerrr�refactorszRefactoringTool.refactorc
Cs�tjd}t�|�D]�\}}}|�d|�|��|��|D]>}|�d�s>tj�|�d|kr>tj�||�} |� | ||�q>dd�|D�|dd�<qdS)z�Descends down a directory and refactor every Python file found.
Python files are assumed to have a .py extension.
Files and subdirectories starting with '.' are skipped.
�pyzDescending into %sr2rcSsg|]}|�d�s|�qSr1)r)r3Zdnrrrr6.s
z0RefactoringTool.refactor_dir.<locals>.<listcomp>N)
r��extsep�walkr�r�rr��splitextrr�)
rrZdir_namer�r�Zpy_ext�dirpathZdirnames� filenamesr�fullnamerrrr�s
�zRefactoringTool.refactor_dirc
Cs�zt|d�}Wn6tk
rD}z|�d||�WY�dSd}~XYnXzt�|j�d}W5|��Xtj|d|dd��}|��|fW5QR�SQRXdS) zG
Do our best to decode a Python source file correctly.
�rbzCan't open %s: %s)NNNrr#rv��encoding�newline) �open�OSErrorr��closer�detect_encodingrGrE�read)rrr��f�errr�rrr�_read_python_source0s
z#RefactoringTool._read_python_sourcecCs�|�|�\}}|dkrdS|d7}|rn|�d|�|�||�}|jsL||kr`|�|||||�q�|�d|�nH|�||�}|js�|r�|jr�|jt|�dd�|||d�n|�d|�dS)zRefactors a file.N�
zRefactoring doctests in %szNo doctest changes in %srt)r�r�zNo changes in %s)r�r��refactor_docstringr[�processed_file�refactor_string�was_changed�str)rrr�r�r��inputr��output�treerrrr�@s"�zRefactoringTool.refactor_filec
Cs�t|�}d|krtj|j_zVz|j�|�}Wn@tk
rl}z"|�d||jj |�WY�W�dSd}~XYnXW5|j|j_X||_
|�d|�|�||�|S)aFRefactor a given input string.
Args:
data: a string holding the code to be refactored.
name: a human-readable name for use in error/log messages.
Returns:
An AST corresponding to the refactored input stream; None if
there were errors during the parse.
rZzCan't parse %s: %s: %sNzRefactoring %s)
rVr rcrrdZparse_stringr"r�� __class__r�future_featuresr��
refactor_tree)rr�datarrSr�r�rrrr�Ws"
� zRefactoringTool.refactor_stringcCs�tj��}|rN|�d�|�|d�}|js2||krB|�|d|�q�|�d�n:|�|d�}|jsj|r~|jr~|�t |�d|�n
|�d�dS)NzRefactoring doctests in stdinz<stdin>zNo doctest changes in stdinzNo changes in stdin)
�sys�stdinr�r�r�r[r�r�r�r�)rrr�r�r�r�rrr�refactor_stdinrs
zRefactoringTool.refactor_stdinc
Cs�t|j|j�D]}|�||�q|�|j|���|�|j|���|j�|� ��}t
|����r�|jjD�]D}||krj||rj||j
tjjdd�|jr�||j
tjjd�t||�D]�}|||kr�||�|�zt|�Wntk
�rYq�YnX|j�r||jk�rq�|�|�}|r�|�||�}|dk r�|�|�|��D] }|j�s^g|_|j�|��qL|j�|� ��}|D]*} | |k�r�g|| <|| �|| ��q�q�qjqTt|j|j�D]}|�||��q�|jS)a�Refactors a parse tree (modifying the tree in place).
For compatible patterns the bottom matcher module is
used. Otherwise the tree is traversed node-to-node for
matches.
Args:
tree: a pytree.Node instance representing the root of the tree
to be refactored.
name: a human-readable name for this tree.
Returns:
True if the tree was modified, False otherwise.
T)ry�reverserxN)rrkrlZ
start_tree�traverse_byrprqro�runZleaves�anyr+r^r�rZBaseZdepthZkeep_line_orderZ
get_linenor(�remover�
ValueErrorZfixers_applied�match� transform�replacerr-Zfinish_treer�)
rrr�rr/Z match_set�node�results�newZnew_matchesZfxrrrrr��sJ
zRefactoringTool.refactor_treecCsV|sdS|D]D}||jD]4}|�|�}|r|�||�}|dk r|�|�|}qqdS)aTraverse an AST, applying a set of fixers to each node.
This is a helper method for refactor_tree().
Args:
fixers: a list of fixer instances.
traversal: a generator that yields AST nodes.
Returns:
None
N)rr�r�r�)rrr^Z traversalr�r/r�r�rrrr��s
zRefactoringTool.traverse_bycCs�|j�|�|dkr.|�|�d}|dkr.dS||k}|�||||�|r`|�d|�|js`dS|rv|�||||�n|�d|�dS)zR
Called when a file has been refactored and there may be changes.
NrzNo changes to %szNot writing changes to %s)rmrr�r�r�r[�
write_file)rrr�r�r�r�r�r�rrrr��szRefactoringTool.processed_filecCs�ztj|d|dd�}Wn6tk
rL}z|�d||�WY�dSd}~XYnX|�Fz|�|�Wn0tk
r�}z|�d||�W5d}~XYnXW5QRX|�d|�d|_dS) z�Writes a string to a file.
It first shows a unified diff between the old text and the new text, and
then rewrites the file; the latter is only done if the write option is
set.
�wrvr�zCan't create %s: %sNzCan't write %s: %szWrote changes to %sT)rEr�r�r�r�r�ri)rrr�r�r�r��fpr�rrrr��s*zRefactoringTool.write_filez>>> z... c
Csg}d}d}d}d}|jdd�D]�}|d7}|���|j�r~|dk rZ|�|�||||��|}|g}|�|j�} |d| �}q |dk r�|�||j�s�|||j��dkr�|� |�q |dk r�|�|�||||��d}d}|� |�q |dk �r
|�|�||||��d�
|�S)a�Refactors a docstring, looking for doctests.
This returns a modified version of the input string. It looks
for doctests, which start with a ">>>" prompt, and may be
continued with "..." prompts, as long as the "..." is indented
the same as the ">>>".
(Unfortunately we can't use the doctest module's parser,
since, like most parsers, it is not geared towards preserving
the original source.)
NrT��keependsrr�rv)�
splitlines�lstripr�PS1r-�refactor_doctest�find�PS2�rstriprr)
rrr�r��result�blockZblock_lineno�indent�lineno�line�irrrr�sJ����
�z"RefactoringTool.refactor_docstringc
s.z��||��}Wnjtk
r|}zL�j�tj�rN|D]}��d|�d��q6��d|||j j
|�|WY�Sd}~XYnX��||��r*t|�j
dd�}|d|d�||dd�} }| dg|dks�t| ��|d�d�s�|dd7<��j|�d �g}|�r*|��fd
d�|D�7}|S)z�Refactors one doctest.
A doctest is given as a block of lines, the first of which starts
with ">>>" (possibly indented), while the remaining lines start
with "..." (identically indented).
z
Source: %sr�z+Can't parse docstring in %s line %s: %s: %sNTr�rrtrcsg|]}��j|�qSr)r�)r3r��r�rrrrr6Zsz4RefactoringTool.refactor_doctest.<locals>.<listcomp>)�parse_blockr"r]ZisEnabledForrg�DEBUGr�r�r�r�rr�r�r��AssertionError�endswithr��pop)
rrr�r�r�r�r�r�r�r�Zclippedrr�rr�@s.�"z RefactoringTool.refactor_doctestcCs�|jrd}nd}|js$|�d|�n"|�d|�|jD]}|�|�q6|jrl|�d�|jD]}|�|�q\|jr�t|j�dkr�|�d�n|�dt|j��|jD]\}}}|j|f|�|�q�dS) N�werez
need to bezNo files %s modified.zFiles that %s modified:z$Warnings/messages while refactoring:rzThere was 1 error:zThere were %d errors:)rirmr�rhrfr|)rrr��file�messager�r�r�rrr� summarize]s$
zRefactoringTool.summarizecCs"|j�|�|||��}t�|_|S)z�Parses a block into a tree.
This is necessary to get correct line number / offset information
in the parser diagnostics and embedded into the parse tree.
)rZparse_tokens� wrap_toksrHr�)rrr�r�r�r�rrrr�tszRefactoringTool.parse_blockccsdt�|�||�j�}|D]F\}}\}}\} }
}||d7}| |d7} ||||f| |
f|fVqdS)z;Wraps a tokenize stream to systematically modify start/end.rN)rrD� gen_lines�__next__)rrr�r�r�r,rrUZline0Zcol0Zline1Zcol1Z line_textrrrr�~s
zRefactoringTool.wrap_toksccsx||j}||j}|}|D]N}|�|�r>|t|�d�Vn(||��dkrVdVntd||f��|}qdVqldS)z�Generates lines as expected by tokenize from a list of lines.
This strips the first len(indent + self.PS1) characters off each line.
Nr�zline=%r, prefix=%rrv)r�r�rr|r�r�)rrr�r��prefix1Zprefix2�prefixr�rrrr��s
zRefactoringTool.gen_lines)NN)FF)FF)FF)F)NFN)N)rrrr`r~r{rsrjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrY�s>�
4(
O�
+
rYc@seZdZdS)�MultiprocessingUnsupportedNrrrrrr��sr�csBeZdZ�fdd�Zd�fdd� Z�fdd�Z�fd d
�Z�ZS)�MultiprocessRefactoringToolcs"tt|�j||�d|_d|_dSr8)�superr�rs�queue�output_lock�rrr��kwargs�r�rrrs�sz$MultiprocessRefactoringTool.__init__Frc
s�|dkrtt���|||�Szddl�Wntk
r@t�YnX�jdk rTtd������_�� ��_
��fdd�t|�D�}z*|D]}|��q�tt���|||�W5�j��t|�D]}�j�
d�q�|D]}|��r�|��q�d�_XdS)Nrrz already doing multiple processescsg|]}�j�jd��qS))�target)ZProcess�_child)r3r���multiprocessingrrrrr6�s�z8MultiprocessRefactoringTool.refactor.<locals>.<listcomp>)r�r�r�r��ImportErrorr�r��RuntimeErrorZ
JoinableQueueZLockr��ranger�putZis_alive�start)rrr�r�r�Z
num_processesZ processesr�r$r�r�rr��s<
�
�
�
z$MultiprocessRefactoringTool.refactorcsN|j��}|dk rJ|\}}ztt|�j||�W5|j��X|j��}q
dSr8)r�reZ task_doner�r�r�)rrZtaskr�r�r�rrr��s
�z"MultiprocessRefactoringTool._childcs2|jdk r|j�||f�ntt|�j||�SdSr8)r�r�r�r�r�r�r�rrr��s
�z)MultiprocessRefactoringTool.refactor_file)FFr)rrrrsr�r�r��
__classcell__rrr�rr��s�r�)T)#rX�
__author__rEr�rr�rgr�r&� itertoolsrZpgen2rrrZ
fixer_utilrrvrr r
rnrr"rrr0r7r:rVrW�objectrYr�r�rrrr�<module>s8
(
?>