| Server IP : 127.0.0.1 / Your IP : 216.73.216.109 Web Server : Apache/2.4.54 (Win64) OpenSSL/1.1.1q PHP/8.1.10 System : Windows NT DESKTOP-E5T4RUN 10.0 build 19045 (Windows 10) AMD64 User : SERVERWEB ( 0) PHP Version : 8.1.10 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/cygwin64/lib/python3.9/site-packages/sphinx/pycode/__pycache__/ |
Upload File : |
a
�abUS � @ sv d dl Z d dlZd dlZd dlZd dlmZ d dl mZ d dlmZm Z m
Z
m Z m Z m
Z
mZ d dlmZmZ d dlmZmZmZmZmZ d dlmZ d dlmZmZ e�d �Z e�d
�Z e�d �Z e e d �d
d�Z ej!eej" d�dd�Z#d$ej!ej$ee d�dd�Z%e e d�dd�Z&G dd� d�Z'G dd� d�Z(G d d � d e(�Z)G d d � d ej*�Z+G d d!� d!e(�Z,G d"d#� d#�Z-dS )%� N)� OrderedDict)� Signature)�DEDENT�INDENT�NAME�NEWLINE�NUMBER�OP�STRING)�COMMENT�NL)�Any�Dict�List�Optional�Tuple)�ast)�parse�unparsez^\s*#: ?(.*)
?
?$z^\s*$z ^\s*(#.*)?$)�code�returnc C s | � dd�S )N� � )�replace)r � r �8/usr/lib/python3.9/site-packages/sphinx/pycode/parser.py�filter_whitespace s r ��noder c C s t | tj�r| jS | jgS d S �N)�
isinstancer �Assign�targets�target)r r r r �get_assign_targets s r$ )r �selfr c C s |r
|j }| jj}|dv r(td| ��n�|dkrX|d u sB| j|krJ| jgS td| ��n�|dv r�g }| jD ],}z|�t||�� W qj ty� Y qj0 qj|S |dkr�| jjjdkr�|r�| jj|kr�dt| j |�d gS td| ��n0|d kr�| gS |d
k�r
t| j|�S t
d | ��d S ) N)ZIndexZNumZSlice�StrZ Subscriptz %r does not create new variable�Namez*The assignment %r is not instance variable)r r Z Attributez%sr �strZStarredzUnexpected node name %r) �arg� __class__�__name__� TypeError�id�elts�extend�get_lvar_names�value�attr�NotImplementedError)r r% Zself_idZ node_name�members�eltr r r r0 ( s4
r0 )�sr c C s: d d�dd�}| |_ t�|�}|r2|�d��d�S dS d S )N�r c S s d S r r r r r r �dummyT s z dedent_docstring.<locals>.dummyz
� )�__doc__�inspectZgetdoc�lstrip�rstrip)r6 r8 � docstringr r r �dedent_docstringR s
r? c @ sb e Zd Zeeeeef eeef edd�dd�Zeed�dd�Z eed�d d
�Z
ed �d d
�Z dS )�TokenN)�kindr1 �start�end�sourcer c C s" || _ || _|| _|| _|| _d S r )rA r1 rB rC rD )r% rA r1 rB rC rD r r r �__init__c s
zToken.__init__)�otherr c C sf t |t�r| j|kS t |t�r(| j|kS t |ttf�rJ| j| jgt|�kS |d u rVdS td| ��d S )NFzUnknown value: %r)r �intrA r( r1 �list�tuple�
ValueError)r% rF r r r �__eq__k s
z Token.__eq__)�
conditionsr c s t � fdd�|D ��S )Nc 3 s | ]}� |kV qd S r r )�.0� candidate�r% r r � <genexpr>x � z Token.match.<locals>.<genexpr>)�any)r% rL r rO r �matchw s z Token.matchr7 c C s dt j| j | j�� f S )Nz<Token kind=%r value=%r>)�tokenize�tok_namerA r1 �striprO r r r �__repr__z s �zToken.__repr__) r+ �
__module__� __qualname__rG r
r r( rE �boolrK rS rW r r r r r@ ` s � r@ c @ sR e Zd Zee dd�dd�Zeed�dd�Zed�d d
�Z e
ee d �d d
�Z dS )�TokenProcessorN)�buffersr c s2 t |�� || _t�� fdd��| _d | _d | _d S )Nc s t � �S r )�nextr ��linesr r �<lambda>� rQ z)TokenProcessor.__init__.<locals>.<lambda>)�iterr\ rT �generate_tokens�tokens�current�previous)r% r\ r r^ r rE � s
zTokenProcessor.__init__��linenor c C s | j |d S �N� �r\ �r% rg r r r �get_line� s zTokenProcessor.get_liner7 c C s< z | j | _tt| j�� | _ W n ty4 d | _ Y n0 | j S r )rd re r@ r] rc �
StopIterationrO r r r � fetch_token� s zTokenProcessor.fetch_token)� conditionr c C s� g }| � � r�|�| j� | j|kr&q�q| jtdgkrH|| �tdg�7 }q| jtdgkrj|| �tdg�7 }q| jtdgkr|| �tdg�7 }q|S )N�(�)�{�}�[�])rn �appendrd r � fetch_until)r% ro rc r r r rw � s
zTokenProcessor.fetch_until) r+ rX rY r r( rE rG rl r@ rn r
rw r r r r r[ s
r[ c sH e Zd Zee dd�� fdd� Zee d�dd�Zdd�dd �Z� Z S )
�AfterCommentParserN�r_ r c s t � �|� d | _d S r )�superrE �comment�r% r_ �r* r r rE � s zAfterCommentParser.__init__r7 c C s� g }| � � r�|�| j� | jtdgkr:|| �tdg�7 }q| jtdgkr\|| �tdg�7 }q| jtdgkr~|| �tdg�7 }q| jtkr�|| �t�7 }q| jtdgkr�q�q| jjttt t
fvrq�q|S )Nrp rq rr rs rt ru �;) rn rv rd r rw r r rA r r r
)r% rc r r r � fetch_rvalue� s
z AfterCommentParser.fetch_rvaluec C sF | � � �tdgtt�sq | jtdgkr.| �� | jtkrB| jj| _d S )N�=) rn rS r r r rd r r1 r{ rO r r r r � s
zAfterCommentParser.parse)
r+ rX rY r r( rE r@ r r �
__classcell__r r r} r rx � s rx c s� e Zd Zee edd�� fdd� Zeeee d�dd�Zedd�dd �Zedd�d
d �Z e
j dd �d
d�Z eedd�dd�Z
ee
jdd�dd�Zee
j ed�dd�Zee
j ed�dd�Zee
j d�dd �Zeed �d d �Ze
jdd �� fd!d"� Ze
jdd �d#d$�Ze
jdd �d%d&�Z e
j dd �d'd(�Z e
j dd �d)d*�Z e
j!dd �d+d,�Z"e
j#dd �d-d.�Z$e
j%dd �d/d0�Z&e
j dd �d1d2�Z'e
j(dd �d3d4�Z)� Z*S )5�VariableCommentPickerN)r\ �encodingr c sn t �� | _|| _|| _g | _g | _d | _t� | _ i | _
d | _ i | _ g | _
i | _d | _d | _d | _t� �� d S r )� itertools�count�counterr\ r� �context�current_classes�current_functionr �comments� annotationsre � deforders�finals� overloads�typing� typing_final�typing_overloadrz rE )r% r\ r� r} r r rE � s
z VariableCommentPicker.__init__)�namer c C sD | j r4| jr.| jd dkr.| jd d� |g S d S n | j|g S d S )N���rE )r� r� r� )r% r� r r r �get_qualname_for� s
z&VariableCommentPicker.get_qualname_forc C s( | � |�}|r$t| j�| jd�|�< d S �N�.)r� r] r� r� �join�r% r� �qualnamer r r � add_entry� s
z VariableCommentPicker.add_entryc C s$ | � |�}|r | j�d�|�� d S r� )r� r� rv r� r� r r r �add_final_entry� s
z%VariableCommentPicker.add_final_entry)�funcr c C sB ddl m} | �|j�}|r>| j�d�|�g �}|�||�� d S )Nr )�signature_from_astr� )Zsphinx.util.inspectr� r� r� r� �
setdefaultr� rv )r% r� r� r� r� r r r �add_overload_entry s
z(VariableCommentPicker.add_overload_entry)r� r{ r c C s2 | � |�}|r.d�|d d� �}|| j||f< d S �Nr� r� )r� r� r� )r% r� r{ r� �basenamer r r �add_variable_comment s
z*VariableCommentPicker.add_variable_comment)r� �
annotationr c C s6 | � |�}|r2d�|d d� �}t|�| j||f< d S r� )r� r� r r� )r% r� r� r� r� r r r �add_variable_annotation s
z-VariableCommentPicker.add_variable_annotation)�
decoratorsr c C sf g }| j r|�d| j � | jr,|�| j� |D ]0}zt|�|v rJW dS W q0 ty^ Y q00 q0dS )Nz%s.finalTF)r� rv r� r r3 )r% r� �final� decoratorr r r �is_final s z VariableCommentPicker.is_finalc C sf g }| j r|�d| j � | jr,|�| j� |D ]0}zt|�|v rJW dS W q0 ty^ Y q00 q0dS )Nz %s.overloadTF)r� rv r� r r3 )r% r� �overloadr� r r r � is_overload' s z!VariableCommentPicker.is_overloadr7 c C sJ | j r | j jjr | j jjd S | j rBt| j jdd �rB| j jjd S d S d S )Nr � posonlyargs)r� �args�getattrr� rO r r r �get_self7 s �z VariableCommentPicker.get_selfrf c C s | j |d S rh rj rk r r r rl B s z VariableCommentPicker.get_liner c s t � �|� || _d S r )rz �visitre �r% r r} r r r� F s zVariableCommentPicker.visitc C sn |j D ]b}| �|jp|j� |jdkr6|jp0|j| _q|jdkrP|jpJ|j| _q|jdkr|jpd|j| _qd S )Nr� z typing.finalztyping.overload)�namesr� �asnamer� r� r� r� �r% r r� r r r � visit_ImportK s
z"VariableCommentPicker.visit_Importc C sh |j D ]\}| �|jp|j� |jdkr@|jdkr@|jp:|j| _q|jdkr|jdkr|jp^|j| _qd S )Nr� r� r� )r� r� r� r� �moduler� r� r� r r r �visit_ImportFromW s
z&VariableCommentPicker.visit_ImportFromc s� z0t |�}t� fdd�|D �g �}� �|j�}W n tyD Y d S 0 t|d�rp|jrp|D ]}� �||j� qZn(t|d�r�|jr�|D ]}� �||j� q�t ||j
d � g� j |jd � �}|� � |j
�rt�|j
��r|D ]$}� �|t�d|j
�� � �|� q�d S t�|d |j
� ��r�g }t|jd �D ]@}� �|jd | �} t�| ��rh|�t�d| �� n �qr�q0|�r�td�t|���}
|D ] }� �||
� � �|� �q�d S |D ]}� �|� �q�d S )Nc s g | ]}t |� �� d ��qS )rO )r0 r� )rM �trO r r �
<listcomp>e rQ z6VariableCommentPicker.visit_Assign.<locals>.<listcomp>r� � type_commentz\1ri �
)r$ �sumrl rg r, �hasattrr� r� r� rx �
col_offsetr\ r r{ �
comment_rerS r� �subr� � indent_re�rangerv r? r� �reversed) r% r r" �varnamesZ current_line�varname�parserZ
comment_lines�iZ before_liner{ r rO r � visit_Assigna sH �
z"VariableCommentPicker.visit_Assignc C s | � |� d S r )r� r� r r r �visit_AnnAssign� s z%VariableCommentPicker.visit_AnnAssignc C s� t | jtjtjf�r�t |jtj�r�zpt| j�}t|d | � � �}|D ]J}t |jj
t �r`|jj
}n|jj
� | j
ppd�}| �|t|�� | �|� qDW n ty� Y n0 d S )Nr �utf-8)r re r r! � AnnAssignr1 r& r$ r0 r� r6 r( �decoder� r� r? r� r, )r% r r" r� r� r> r r r �
visit_Expr� s �
z VariableCommentPicker.visit_Exprc C s0 |j D ]}| �|� q|jD ]}| �|� q d S r )�bodyr� �orelse)r% r Zsubnoder r r � visit_Try� s
z VariableCommentPicker.visit_Tryc C st | j �|j� | �|j� | �|j�r2| �|j� | j�|j� || _|j D ]}| �
|� qL| j� � | j � � d S r ) r� rv r� r� r� �decorator_listr� r� re r� r� �pop�r% r �childr r r �visit_ClassDef� s
z$VariableCommentPicker.visit_ClassDefc C s� | j d u r~| �|j� | �|j�r.| �|j� | �|j�rD| �|� | j� |j� || _ |j
D ]}| � |� q^| j� � d | _ d S r )
r� r� r� r� r� r� r� r� r� rv r� r� r� r� r r r �visit_FunctionDef� s
z'VariableCommentPicker.visit_FunctionDefc C s | � |� d S r )r� r� r r r �visit_AsyncFunctionDef� s z,VariableCommentPicker.visit_AsyncFunctionDef)+r+ rX rY r r( rE r r� r� r� r Z FunctionDefr� r� �ASTr� �exprrZ r� r� r) r� rG rl r� ZImportr� Z
ImportFromr� r! r� r� r� ZExprr� ZTryr� ZClassDefr� r� ZAsyncFunctionDefr� r� r r r} r r� � s*
0
r� c sp e Zd Zee dd�� fdd� Zeeeeef dd�dd�Zdd�d d
�Z edd �d d
�Z
dd�dd�Z � Z S )�DefinitionFinderNry c s( t � �|� d | _g | _g | _i | _d S r )rz rE r� r� �indents� definitionsr| r} r r rE � s
zDefinitionFinder.__init__)r� �entryr c C s4 | j r&| j d d dkr&|d dkr&n
|| j|< d S )Nr� r �def)r� r� )r% r� r� r r r �add_definition� s $z DefinitionFinder.add_definitionr7 c C s� | � � }|d u rq�q |tkr q |tdgkrX| jd u sF| j�tttt�rX| j d u r�|| _ q |�t
dg�rr| � d� q |�t
dg�r�| � d� q |tkr�| j �
d� q |tkr | �� q d S )N�@�classr� )rF NN)rn r r re rS r r r r r� r �parse_definitionr� rv �finalize_block)r% �tokenr r r r � s$ �
zDefinitionFinder.parse)�typr c C s� | � � }| j�|j� d�| j�}| jr<| jjd }d | _n
|jd }| �tdg� | � � � t
t �r�| �t � | j
�|||f� n"| �||||jd f� | j�� d S )Nr� r �:)rn r� rv r1 r� r� rB rw r rS r r r r� r� rC r� )r% r� r� �funcname� start_posr r r r� � s
z!DefinitionFinder.parse_definitionc C sj | j �� }|d dkrf|\}}}| jjd d }t�| �|��rJ|d8 }q0| �||||f� | j�� d S )Nr rF ri ) r� r� rd rC � emptyline_rerS rl r� r� )r% Z
definitionr� r� r� Zend_posr r r r� s
z DefinitionFinder.finalize_block)
r+ rX rY r r( rE r rG r� r r� r� r� r r r} r r� � s
r� c @ sJ e Zd Zd
eedd�dd�Zdd�dd�Zdd�d d
�Zdd�d d �ZdS )�Parserr� N)r r� r c C s8 t |�| _|| _i | _i | _i | _i | _g | _i | _d S r ) r r r� r� r� r� r� r� r� )r% r r� r r r rE # s
zParser.__init__r7 c C s | � � | �� d S r )�parse_commentsr� rO r r r r - s z Parser.parsec C sT t | j�}t| j�d�| j�}|�|� |j| _|j| _|j| _|j | _ |j
| _
d S �NT) r r r� �
splitlinesr� r� r� r� r� r� r� )r% ZtreeZpickerr r r r� 2 s
zParser.parse_commentsc C s$ t | j�d��}|�� |j| _d S r� )r� r r� r r� )r% r� r r r r� = s zParser.parse_definition)r� )r+ rX rY r( rE r r� r� r r r r r� s
r� )N).r; r� �rerT � collectionsr r r� r r r r r r r
r r r� r
r r r r Zsphinx.pycode.astr r r �compiler� r� r� r( r r� r� r$ r) r0 r? r@ r[ rx Z NodeVisitorr� r� r� r r r r �<module>
s0 $
* -- zK