|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/sphinx/pycode/__pycache__/ |
Upload File : |
o
�$�a� � @ s� U d Z ddlZddlmZmZmZmZmZ ejdkr ddl Z nzddl
m Z W n
e y4 ddl Z Y nw i e j
d�e jd�e jd�e jd �e jd
�e jd �e jd �e jd
�e jd�e jd�e jd�e jd�e jd�e jd�e jd�e j d�e j d�e j de j di�Z eee j! e"f e#d< d'de"de"dd fd d �Z$ed(d dde"ddfd!d"��Z%ed(d e j!de"de"fd#d"��Z%d(d ee j! de"dee" fd$d"�Z%G d%d&� d&e j&�Z'dS ))z�
sphinx.pycode.ast
~~~~~~~~~~~~~~~~~
Helpers for AST (Abstract Syntax Tree).
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�Dict�List�Optional�Type�overload�� � )�ast3�+�and�&�|�^�/z//�~z<<�@�*�%�not�**�orz>>�-� OPERATORS�exec�code�mode�returnzast.ASTc C sR z t j| |dd�W S ty t j| |d� Y S ty( t j| |d� Y S w )z{Parse the *code* using the built-in ast or typed_ast libraries.
This enables "type_comments" feature if possible.
T)r �
type_comments)r )�ast�parse� SyntaxError� TypeError)r r � r# �3/usr/lib/python3/dist-packages/sphinx/pycode/ast.pyr / s �r � �nodec C � d S �Nr# �r& r r# r# r$ �unparseA � r* c C r' r( r# r) r# r# r$ r* F r+ c C s( | du rdS t | t�r
| S t|��| �S )zUnparse an AST to string.N)�
isinstance�str�_UnparseVisitor�visitr) r# r# r$ r* K s
c @ s& e Zd Zd<deddfdd�Zdejdefdd �ZeD ] Z ee
� d
� e j �< qdej defd d �Z
d
ej deej defdd�Zdejdefdd�Zdejdefdd�Zdejdefdd�Zdejdefdd�Zdejdefdd�Zdejdefdd �Zdej defd d �Z dej defd d �Z dej defd!d"�Z!dej"defd#d$�Z#dej$defd%d&�Z%dej&defd'd(�Z'dej(defd)d*�Z)dej*defd+d,�Z+dej,defd-d.�Z-e.j/d/k �r
dej0defd0d1�Z1dej2defd2d3�Z3dej4defd4d5�Z5dej6defd6d7�Z7dej8defd8d9�Z9d:d;� Z:dS )=r. r% r r Nc C s
|| _ d S r( )r )�selfr r# r# r$ �__init__V �
z_UnparseVisitor.__init__r& c C s
t |j S r( )r � __class__�r0 r& r# r# r$ � _visit_opY r2 z_UnparseVisitor._visit_opzvisit_{}c C s" |j rd|j| �|j �f S |jS )Nz%s: %s)�
annotation�argr/ r4 r# r# r$ � visit_arg^ s z_UnparseVisitor.visit_argr7 �defaultc C s@ | � |�}|r |jr|d| � |� 7 }|S |d| � |� 7 }|S )z&Unparse a single argument to a string.z = %sz=%s)r/ r6 )r0 r7 r9 �namer# r# r$ �_visit_arg_with_defaultd s
�z'_UnparseVisitor._visit_arg_with_defaultc
C s� t |j�}t|j�}d}t|d�r |t|j�7 }||7 }tt|�|�D ]}|�dd � q#t |j�}tt|�t|j ��D ]}|�dd � q;g }t|d�rht
|j�D ]\}} |� | � | || �� qP|jrh|� d� t
|j�D ]\}} |� | � | ||| �� qm|j
r�|� d| �|j
� � |j r�|j
s�|� d� t
|j �D ]\}} |� | � | || �� q�|jr�|� d| �|j� � d�|�S )Nr � posonlyargsr r r �, )�list�defaults�len�args�hasattrr< �range�insert� kw_defaults�
kwonlyargs� enumerate�appendr; �varargr/ �kwarg�join)
r0 r& r? � positionalsr< �_rE rA �ir7 r# r# r$ �visit_argumentsn s8
z _UnparseVisitor.visit_argumentsc C s d| � |j�|jf S )Nz%s.%s)r/ �value�attrr4 r# r# r$ �visit_Attribute� s z _UnparseVisitor.visit_Attributec s$ d� � fdd�|j|j|jfD ��S )N� c 3 � � | ]}� � |�V qd S r( �r/ ��.0�e�r0 r# r$ � <genexpr>� � � z._UnparseVisitor.visit_BinOp.<locals>.<genexpr>)rK �left�op�rightr4 r# rY r$ � visit_BinOp� s $z_UnparseVisitor.visit_BinOpc s* d� � |j� }|�� fdd�|jD ��S )Nz %s c 3 rT r( rU rV rY r# r$ rZ � r[ z/_UnparseVisitor.visit_BoolOp.<locals>.<genexpr>)r/ r] rK �values)r0 r& r] r# rY r$ � visit_BoolOp� s z _UnparseVisitor.visit_BoolOpc sB � fdd�|j D �� fdd�|jD � }d� �|j�d�|�f S )Nc s g | ]}� � |��qS r# rU rV rY r# r$ �
<listcomp>� s z._UnparseVisitor.visit_Call.<locals>.<listcomp>c s" g | ]
}d |j � �|j�f �qS )z%s=%s)r7 r/ rP �rW �krY r# r$ rb � s " z%s(%s)r= )rA �keywordsr/ �funcrK )r0 r& rA r# rY r$ �
visit_Call� s �z_UnparseVisitor.visit_Callc C sR |j tu rdS t|j tttf�r$| jr tjdkr t �
| j|�S t |j �S t |j �S )N�...r ) rP �Ellipsisr, �int�float�complexr �sys� version_infor �get_source_segment�reprr4 r# r# r$ �visit_Constant� s
z _UnparseVisitor.visit_Constantc sN � fdd�|j D �}� fdd�|jD �}dd� t||�D �}dd�|� d S )Nc 3 rT r( rU rc rY r# r$ rZ � r[ z-_UnparseVisitor.visit_Dict.<locals>.<genexpr>c 3 rT r( rU )rW �vrY r# r$ rZ � r[ c s s � | ] \}}|d | V qdS )z: Nr# )rW rd rr r# r# r$ rZ � s � �{r= �})�keysr` �ziprK )r0 r& ru r` �itemsr# rY r$ �
visit_Dict� s z_UnparseVisitor.visit_Dictc C s | � |j�S r( )r/ rP r4 r# r# r$ � visit_Index� s z_UnparseVisitor.visit_Indexc C s d| � |j� S )Nzlambda %s: ...)r/ rA r4 r# r# r$ � visit_Lambda� s z _UnparseVisitor.visit_Lambdac �" dd� � fdd�|jD �� d S )N�[r= c 3 rT r( rU rV rY r# r$ rZ � r[ z-_UnparseVisitor.visit_List.<locals>.<genexpr>�]�rK �eltsr4 r# rY r$ �
visit_List� � "z_UnparseVisitor.visit_Listc C s |j S r( )�idr4 r# r# r$ �
visit_Name� s z_UnparseVisitor.visit_Namec r{ )Nrs r= c 3 rT r( rU rV rY r# r$ rZ � r[ z,_UnparseVisitor.visit_Set.<locals>.<genexpr>rt r~ r4 r# rY r$ � visit_Set� r� z_UnparseVisitor.visit_Setc s� dt jdtfdd�}||j�r'd�� fdd�|jjD ��}d� �|j�|f S t|jt j �rM||jj�rMd�� fd d�|jjjD ��}d� �|j�|f S d� �|j�� �|j�f S )
NrP r c S s, t | tj�ot| j�otdd� | jD �� S )Nc s s � | ] }t |tj�V qd S r( )r, r �Starred)rW �eltr# r# r$ rZ � s � zK_UnparseVisitor.visit_Subscript.<locals>.is_simple_tuple.<locals>.<genexpr>)r, r �Tuple�boolr �any)rP r# r# r$ �is_simple_tuple� s
��z8_UnparseVisitor.visit_Subscript.<locals>.is_simple_tupler= c 3 rT r( rU rV rY r# r$ rZ � r[ z2_UnparseVisitor.visit_Subscript.<locals>.<genexpr>z%s[%s]c 3 rT r( rU rV rY r# r$ rZ � r[ )
r �ASTr� �slicerK r r/ rP r, �Index)r0 r& r� r r# rY r$ �visit_Subscript� s
z _UnparseVisitor.visit_Subscriptc C s d| � |j�| � |j�f S )Nz%s %s)r/ r] �operandr4 r# r# r$ �
visit_UnaryOp� s z _UnparseVisitor.visit_UnaryOpc sV t |j�dkr dS t |j�dkrd� �|jd � S dd�� fdd�|jD �� d S )
Nr z()� z(%s,)�(r= c 3 rT r( rU rV rY r# r$ rZ � r[ z._UnparseVisitor.visit_Tuple.<locals>.<genexpr>�))r@ r r/ rK r4 r# rY r$ � visit_Tuple� s
"z_UnparseVisitor.visit_Tupler c C �
t |j�S r( �rp �sr4 r# r# r$ � visit_Bytes� r2 z_UnparseVisitor.visit_Bytesc C s dS )Nrh r# r4 r# r# r$ �visit_Ellipsis� s z _UnparseVisitor.visit_Ellipsisc C r� r( )rp rP r4 r# r# r$ �visit_NameConstant� r2 z"_UnparseVisitor.visit_NameConstantc C r� r( )rp �nr4 r# r# r$ � visit_Num� r2 z_UnparseVisitor.visit_Numc C r� r( r� r4 r# r# r$ � visit_Str� r2 z_UnparseVisitor.visit_Strc C s t dt|�j ��)NzUnable to parse %s object)�NotImplementedError�type�__name__r4 r# r# r$ �
generic_visit� s z _UnparseVisitor.generic_visit�r% );r� �
__module__� __qualname__r- r1 r r� r5 r �_op�locals�formatr7 r8 r r; � argumentsrO � AttributerR �BinOpr_ �BoolOpra �Callrg �Constantrq r rx r� ry �Lambdarz r r� �Namer� �Setr� � Subscriptr� �UnaryOpr� r� r� rm rn �Bytesr� ri r� � NameConstantr� �Numr� �Strr� r� r# r# r# r$ r. U s:
& r. )r r� )(�__doc__rm �typingr r r r r rn r � typed_astr
� ImportError�Add�And�BitAnd�BitOr�BitXor�Div�FloorDiv�Invert�LShift�MatMult�Mult�Mod�Not�Pow�Or�RShift�Sub�UAdd�USubr r� r- �__annotations__r r* � NodeVisitorr. r# r# r# r$ �<module> sn
��������� �
� � �
����� � "