�
� f� � � � d Z dZddlZddlZddlmZ ddlmZ ddlm Z G d� d e
� � Z G d
� d e
� � Z i a
d � ZdS )
a� A bottom-up tree matching algorithm implementation meant to speed
up 2to3's matching process. After the tree patterns are reduced to
their rarest linear path, a linear Aho-Corasick automaton is
created. The linear automaton traverses the linear paths from the
leaves to the root of the AST and returns a set of nodes for further
matching. This reduces significantly the number of candidate nodes.z+George Boutsioukis <gboutsioukis@gmail.com>� N)� defaultdict� )�pytree)� reduce_treec �6 � e Zd ZdZ ej � � Zd� ZdS )�BMNodez?Class for a node of the Aho-Corasick automaton used in matchingc �l � i | _ g | _ t t j � � | _ d| _ d S )N� )�transition_table�fixers�nextr �count�id�content��selfs �:/opt/alt/python311/lib64/python3.11/lib2to3/btm_matcher.py�__init__zBMNode.__init__ s- � � "�� ��� ��v�|�$�$����� � � � N)�__name__�
__module__� __qualname__�__doc__� itertoolsr r � r r r r s8 � � � � � �I�I� �I�O� � �E�� � � � r r c �0 � e Zd ZdZd� Zd� Zd� Zd� Zd� ZdS )�
BottomMatcherzgThe main matcher class. After instantiating the patterns should
be added using the add_fixer methodc � � t � � | _ t � � | _ | j g| _ g | _ t
j d� � | _ d S )N�RefactoringTool) �set�matchr �root�nodesr �logging� getLogger�loggerr s r r zBottomMatcher.__init__ sA � ��U�U��
��H�H�� ��i�[��
��� � �'�(9�:�:�� � � r c � � | j � |� � t |j � � }|� � � }| � || j �� � }|D ] }|j � |� � � dS )z�Reduces a fixer's pattern tree to a linear path and adds it
to the matcher(a common Aho-Corasick automaton). The fixer is
appended on the matching states and called when they are
reached��startN)r �appendr � pattern_tree�get_linear_subpattern�addr" )r �fixer�tree�linear� match_nodes�
match_nodes r � add_fixerzBottomMatcher.add_fixer% s� � �
� ���5�!�!�!��5�-�.�.���+�+�-�-���h�h�v�T�Y�h�7�7� �%� ,� ,�J� � � $� $�U� +� +� +� +� ,� ,r c �� � |s|gS t |d t � � r\g }|d D ]O}| � ||�� � }|D ]3}|� | � |dd� |� � � � �4�P|S |d |j vr t � � }||j |d < n|j |d }|dd� r | � |dd� |�� � }n|g}|S )z5Recursively adds a linear pattern to the AC automatonr r( r N)�
isinstance�tupler- �extendr r )r �patternr) r1 � alternative� end_nodes�end� next_nodes r r- zBottomMatcher.add1 s& � � � ��7�N� �g�a�j�%� (� (� � �K� &�q�z�
C�
C� � !�H�H�[��H� >� >� �$� C� C�C� �&�&�t�x�x����� �S�'A�'A�B�B�B�B�C� � � �q�z��!7�7�7� "�H�H� �5>��&�w�q�z�2�2� "� 2�7�1�:� >� ��q�r�r�{�
(� �H�H�W�Q�R�R�[� �H� B� B� � � &�K� � � r c �6 � | j }t t � � }|D ]�}|}|r�d|_ |j D ]0}t |t j � � r|j dk r d|_ n�1|j dk r|j }n|j }||j
v r3|j
| }|j D ] }|| � |� � � nV| j }|j
�
|j
j rnD||j
v r2|j
| }|j D ] }|| � |� � � |j
}|��|S )au The main interface with the bottom matcher. The tree is
traversed from the bottom using the constructed
automaton. Nodes are only checked once as the tree is
retraversed. When the automaton fails, we give it one more
shot(in case the above tree matches as a whole with the
rejected leaf), then we break for the next leaf. There is the
special case of multiple arguments(see code comments) where we
recheck the nodes
Args:
The leaves of the AST tree to be matched
Returns:
A dictionary of node matches with fixers as the keys
T�;Fr )r" r �list� was_checked�childrenr5 r �Leaf�value�typer r r* �parent) r �leaves�current_ac_node�results�leaf�current_ast_node�child�
node_tokenr. s r �runzBottomMatcher.runS s � � �)�� �d�#�#��� # ;� # ;�D� #� �"� !
;�/3� �,� -� 6� � �E�!�%���5�5� �%�+��:L�:L�7<�(�4� ���#�(�A�-�-�!1�!7�J�J�!1�!6�J� � �!A�A�A�&5�&F�z�&R�O�!0�!7� @� @�� ���-�-�.>�?�?�?�?�@� '+�i�O�(�/�;� ,� 3� ?� <� � "�_�%E�E�E�*9�*J�:�*V��%4�%;� D� D�E� #�E�N� 1� 1�2B� C� C� C� C�#3�#:� �C #� !
;��D �r c �n �� t d� � �fd�� �| j � � t d� � dS )z<Prints a graphviz diagram of the BM automaton(for debugging)z
digraph g{c
�" �� | j � � � D ]s}| j | }t d| j |j t |� � t |j � � fz � � |dk rt |j � � �|� � �td S )Nz%d -> %d [label=%s] //%sr )r �keys�printr � type_repr�strr r )�node� subnode_key�subnode�
print_nodes �r rW z*BottomMatcher.print_ac.<locals>.print_node� s� �� � #� 4� 9� 9� ;� ;�
$�
$� � �/� �<���0��w��
�I�k�,B�,B�C���DW�DW�X�Y� Z� Z� Z� �!�#�#��'�/�*�*�*��
�7�#�#�#�#�
$�
$r �}N)rQ r" )r rW s @r �print_aczBottomMatcher.print_ac� sM �� �
�l���� $� $� $� $� $� �
�4�9� � � �
�c�
�
�
�
�
r N) r r r r r r3 r- rM rY r r r r r sk � � � � � �+� +�;� ;� ;�
,�
,�
,� � � �D6� 6� 6�p � � � � r r c �� � t sGddlm} |j � � � D ]'\ }}t |� � t k r
|t |< �(t � | | � � S )Nr )�python_symbols)� _type_reprs�pygramr[ �__dict__�itemsrD �int�
setdefault)�type_numr[ �name�vals r rR rR � sq � � � 9�*�*�*�*�*�*� (�0�6�6�8�8� 9� 9�I�D�#��C�y�y�C� � �D��S�!1�� � !� !�(�H� 5� 5�5r )r �
__author__r$ r � collectionsr r
r � btm_utilsr �objectr r r\ rR r r r �<module>ri s� ��G� G� ;�
� ���� � � � � #� #� #� #� #� #� � � � � � � "� "� "� "� "� "�� � � � �V� � � �}� }� }� }� }�F� }� }� }�@ � �6� 6� 6� 6� 6r