| 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/util/__pycache__/ |
Upload File : |
a
�ab�7 � @ s� d dl Z d dlmZ d dlmZmZmZmZmZm Z m
Z
m Z d dl m
Z
d dlmZ d dlmZ d dlmZ e�e�Zeegef Ze �d�Ze �d �Ze �d
�Z e �d �Z e �d �Z e �d
�Z e �d�Z e �d�Z!e �d�Z"e �d�Z#e �d�Z$edd�dd�Z%G dd� de&�Z'G dd� d�Z(G dd� de(�Z)G d d � d e)�Z*G d d � d e(�Z+G d d!� d!e)�Z,G d"d#� d#e)�Z-G d$d%� d%e)�Z.G d&d'� d'e(�Z/G d(d)� d)e&�Z0G d*d+� d+e&�Z1G d,d-� d-�Z2dS ).� N��deepcopy)�Any�Callable�List�Match�Optional�Pattern�Tuple�Union)�nodes)� TextElement)�Config)�loggingz(?u)\s+z (@[a-zA-Z0-9_])[a-zA-Z0-9_]*\ba
(?x)
( # This 'extends' _anon_identifier_re with the ordinary identifiers,
# make sure they are in sync.
(~?\b[a-zA-Z_]) # ordinary identifiers
| (@[a-zA-Z0-9_]) # our extension for names of anonymous entities
)
[a-zA-Z0-9_]*\b
z[1-9][0-9]*(\'[0-9]+)*z0[0-7]*(\'[0-7]+)*z"0[xX][0-9a-fA-F]+(\'[0-9a-fA-F]+)*z0[bB][01]+(\'[01]+)*a% (?x)
# unsigned and/or (long) long, in any order, but at least one of them
(
([uU] ([lL] | (ll) | (LL))?)
|
(([lL] | (ll) | (LL)) [uU]?)
)\b
# the ending word boundary is important for distinguishing
# between suffixes and UDLs in C++
a (?x)
[+-]?(
# decimal
([0-9]+(\'[0-9]+)*[eE][+-]?[0-9]+(\'[0-9]+)*)
| (([0-9]+(\'[0-9]+)*)?\.[0-9]+(\'[0-9]+)*([eE][+-]?[0-9]+(\'[0-9]+)*)?)
| ([0-9]+(\'[0-9]+)*\.([eE][+-]?[0-9]+(\'[0-9]+)*)?)
# hex
| (0[xX][0-9a-fA-F]+(\'[0-9a-fA-F]+)*[pP][+-]?[0-9a-fA-F]+(\'[0-9a-fA-F]+)*)
| (0[xX]([0-9a-fA-F]+(\'[0-9a-fA-F]+)*)?\.
[0-9a-fA-F]+(\'[0-9a-fA-F]+)*([pP][+-]?[0-9a-fA-F]+(\'[0-9a-fA-F]+)*)?)
| (0[xX][0-9a-fA-F]+(\'[0-9a-fA-F]+)*\.([pP][+-]?[0-9a-fA-F]+(\'[0-9a-fA-F]+)*)?)
)
z[fFlL]\bz�(?x)
((?:u8)|u|U|L)?
'(
(?:[^\\'])
| (\\(
(?:['"?\\abfnrtv])
| (?:[0-7]{1,3})
| (?:x[0-9a-fA-F]{2})
| (?:u[0-9a-fA-F]{4})
| (?:U[0-9a-fA-F]{8})
))
)'
)�mode�returnc C s | dvrt d| ��d S )N)Z
lastIsNameZ
noneIsNameZmarkTypeZmarkNameZparamZudlz!Description mode '%s' is invalid.)� Exception)r � r �7/usr/lib/python3.9/site-packages/sphinx/util/cfamily.py�verify_description_modeP s r c @ s e Zd ZdS )� NoOldIdErrorN��__name__�
__module__� __qualname__r r r r r U s r c @ sz e Zd ZU eed�dd�ZdZeg ef e d< ed�dd�Z
e e d �d
d �Z
e d�d d
�Ze d�dd�Ze d�dd�ZdS )� ASTBaseBase)�otherr c C s\ t | �t |�urdS z.| j�� D ] \}}|t||�kr W dS q W n tyV Y dS 0 dS )NFT)�type�__dict__�items�getattr�AttributeError)�selfr �key�valuer r r �__eq__[ s zASTBaseBase.__eq__N�__hash__�r c C s t | �S �Nr �r" r r r �cloneh s zASTBaseBase.clone�� transformr c C s t t| ���d S r( ��NotImplementedError�repr�r" r, r r r �
_stringifyk s zASTBaseBase._stringifyc C s | � dd� �S )Nc S s t | �S r( )�str��astr r r �<lambda>o � z%ASTBaseBase.__str__.<locals>.<lambda>�r1 r) r r r �__str__n s zASTBaseBase.__str__c C s | � dd� �S )Nc S s | � � S r( )�get_display_stringr3 r r r r5 r r6 z0ASTBaseBase.get_display_string.<locals>.<lambda>r7 r) r r r r9 q s z ASTBaseBase.get_display_stringc C s d| j j S )Nz<%s>)� __class__r r) r r r �__repr__t s zASTBaseBase.__repr__)r r r r �boolr% r& r �int�__annotations__r* �StringifyTransformr2 r1 r8 r9 r; r r r r r Z s
r c @ s e Zd Zedd�dd�ZdS )� ASTAttributeN��signoder c C s t t| ���d S r( r- �r" rB r r r �describe_signature} s z ASTAttribute.describe_signature)r r r r
rD r r r r r@ | s r@ c @ s< e Zd Zedd�dd�Zeed�dd�Zedd�d d
�ZdS ) �ASTCPPAttributeN)�argr c C s
|| _ d S r( �rF )r" rF r r r �__init__� s zASTCPPAttribute.__init__r+ c C s d| j d S )Nz[[z]]rG r0 r r r r1 � s zASTCPPAttribute._stringifyrA c C s t | �}|�t�||�� d S r( �r2 �appendr �Text�r" rB Ztxtr r r rD � s z"ASTCPPAttribute.describe_signature� r r r r2 rH r? r1 r
rD r r r r rE � s rE c @ s2 e Zd Zeed dd�dd�Zeed�dd�ZdS ) �ASTGnuAttribute�ASTBaseParenExprListN)�name�argsr c C s || _ || _d S r( )rP rQ )r" rP rQ r r r rH � s zASTGnuAttribute.__init__r+ c C s( | j g}| jr |�|| j�� d�|�S )N� )rP rQ rJ �join)r" r, �resr r r r1 � s zASTGnuAttribute._stringify)r r r r2 r rH r? r1 r r r r rN � s rN c @ s@ e Zd Zee dd�dd�Zeed�dd�Ze dd�d d
�Z
dS ) �ASTGnuAttributeListN)�attrsr c C s
|| _ d S r( )rV )r" rV r r r rH � s z ASTGnuAttributeList.__init__r+ c C sJ dg}d}| j D ]$}|s"|�d� d}|�||�� q|�d� d�|�S )Nz__attribute__((Tz, Fz))rR )rV rJ rS )r" r, rT �first�attrr r r r1 � s
z ASTGnuAttributeList._stringifyrA c C s t | �}|�t�||�� d S r( rI rL r r r rD � s z&ASTGnuAttributeList.describe_signature) r r r r rN rH r? r2 r1 r
rD r r r r rU � s rU c @ s< e Zd Zedd�dd�Zeed�dd�Zedd�d d
�ZdS ) �ASTIdAttributeN)�idr c C s
|| _ d S r( �rZ )r" rZ r r r rH � s zASTIdAttribute.__init__r+ c C s | j S r( r[ r0 r r r r1 � s zASTIdAttribute._stringifyrA c C s |� t�| j| j�� d S r( )rJ r rK rZ rC r r r rD � s z!ASTIdAttribute.describe_signaturerM r r r r rY � s rY c @ s> e Zd Zeedd�dd�Zeed�dd�Zedd�d d
�ZdS ) �ASTParenAttributeN)rZ rF r c C s || _ || _d S r( �rZ rF )r" rZ rF r r r rH � s zASTParenAttribute.__init__r+ c C s | j d | j d S )N�(�)r] r0 r r r r1 � s z ASTParenAttribute._stringifyrA c C s t | �}|�t�||�� d S r( rI rL r r r rD � s z$ASTParenAttribute.describe_signaturerM r r r r r\ � s r\ c @ s e Zd ZdS )rO Nr r r r r rO � s rO c @ s e Zd ZdS )�$UnsupportedMultiCharacterCharLiteralNr r r r r r` � s r` c @ s e Zd ZdS )�DefinitionErrorNr r r r r ra � s ra c @ s� e Zd Zeeejeeef ef ddd�dd�Z e
e ee d�dd�Z
eed �d
d ��Zedd �d
d�Zedd �dd�Zedd �dd�Zeed�dd�Zeed�dd�Zeed�dd�Zed �d d �Zeed�d d �Zeed�d d!�Zeed �d"d#��Zeed �d$d%��Z eed �d&d'��Z ed �d(d)�Z d*d+�edd,�d-d.�Z ed/d0� �Z ed1d2� �Z!e
e ed3�d4d5�Z"e#e$ d �d6d7�Z%e&d �d8d9�Z'dS ):�
BaseParserr N)�
definition�location�configr c C sD |� � | _|| _|| _d| _t| j�| _d | _d| _g | _ d| _
d S )Nr )r NT) �striprc rd re �pos�len�end�
last_match�_previous_state� otherErrorsZ allowFallbackExpressionParsing)r" rc rd re r r r rH � s
zBaseParser.__init__)�errors�headerr c C s� t |�dkrHt |�dkr4t|d t|d d � �S tt|d d ��S |dg}|D ]�}t |d �dkr�d}|�|d � |�d� t|d ��d�D ]0}t |�dkr�q�|�|� |�|� |�d� q�qT|�t|d �� qTtd�|��S )N� r �
z z:
rR )rh ra r2 rJ �splitrS )r" rm rn �result�e�indent�liner r r �_make_multi_error� s$
z BaseParser._make_multi_errorr' c C s t �d S r( �r. r) r r r �language s zBaseParser.language)�msgr c C s& d| j d }td|| j|f � d S )N�-�^z%s
%s
%s)rg �printrc )r" ry � indicatorr r r �status s zBaseParser.statusc C sl g }d| j d }td| j|| j | j|f �}|�|df� | jD ]}|�|df� qBg | _| �|d��d S )Nrz r{ z2Invalid %s declaration: %s [error at %d]
%s
%sz
Main errorzPotential other errorrR )rg ra rx rc rJ rl rv )r" ry rm r} ZexMain�errr r r �fail s ��
zBaseParser.failc C s t j|| jd� d S )N)rd )�loggerZwarningrd )r" ry r r r �warn s zBaseParser.warn)�regexr c C s> |� | j| j�}|d ur:| j| jf| _|�� | _|| _dS dS �NTF)�matchrc rg rj rk ri )r" r� r� r r r r� s
zBaseParser.match)�stringr c C s8 t |�}| j| j| j| � |kr4| j|7 _dS dS r� )rh rc rg )r" r� Zstrlenr r r � skip_string! s
zBaseParser.skip_string)�wordr c C s | � t�dt�|� ��S )Nz\b%s\b)r� �re�compile�escape�r" r� r r r � skip_word( s zBaseParser.skip_wordc C s
| � t�S r( )r� �_whitespace_rer) r r r �skip_ws+ s zBaseParser.skip_wsc C s | � |�r| �� dS dS r� )r� r� r� r r r �skip_word_and_ws. s
zBaseParser.skip_word_and_wsc C s | � |�r| �� dS dS r� )r� r� )r" r� r r r �skip_string_and_ws4 s
z BaseParser.skip_string_and_wsc C s | j | jkS r( )rg ri r) r r r �eof: s zBaseParser.eofc C s( z| j | j W S ty" Y dS 0 d S )NZEOF)rc rg �
IndexErrorr) r r r � current_char> s zBaseParser.current_charc C s | j d ur| j �� S d S d S r( )rj �groupr) r r r � matched_textE s
zBaseParser.matched_textc C s | j | jd � }| j| _|S r( )rc rg ri )r" �rvr r r � read_restL s zBaseParser.read_restF)�allowSemicolon)r� r c C sF | � � |r2| jsB| j| jd � dkrB| �d� n| jsB| �d� d S )N�;z Expected end of definition or ;.zExpected end of definition.)r� r� rc rg r� )r" r� r r r �
assert_endQ s zBaseParser.assert_endc C s t �d S r( rw r) r r r �
id_attributes\ s zBaseParser.id_attributesc C s t �d S r( rw r) r r r �paren_attributes` s zBaseParser.paren_attributes)ri r c C s� dddd�}| j }g }| js�t|�dkr4| j|v r4q�| j|�� v rT|�|| j � n>t|�dkrx| j|d krx|�� n| jdv r�| �d| j � | j d 7 _ q| jr�| �d
| � | j|| j � S ) Nr_ �]�})r^ �[�{r ���z)]}z&Unexpected '%s' in balanced-token-seq.ro z8Could not find end of balanced-token-seq starting at %d.) rg r� rh r� �keysrJ �popr� rc )r" ri Zbrackets�startPosZsymbolsr r r �_parse_balanced_token_seqd s$
�z$BaseParser._parse_balanced_token_seqc C s� | � � | j}| �d�rh| �d�s*|| _n>| jdgd�}| �d�sL| �d� | �d�s`| �d� t|�S | �d��r| �d�s�| �d� | �d�s�| �d � g }| �t �r�| j
}| � � }|� t
||�� | �d
�r�q�q�| �d �r�q�q�| �d � q�| �d ��s| �d
� t|�S | jD ] }| �|��rt|� S �q| jD ]Z}| �|��sN�q:| �d��sd| �d� | jd gd�}| �d ��s�| �d� t||� S d S )Nr� r� )ri z!Expected ']' in end of attribute.z-Expected ']' in end of attribute after [[...]Z
__attribute__r^ z#Expected '(' after '__attribute__'.z$Expected '(' after '__attribute__('.�,r_ z2Expected identifier, ')', or ',' in __attribute__.z(Expected ')' after '__attribute__((...)'z0Expected '(' after user-defined paren-attribute.z1Expected ')' to end user-defined paren-attribute.)r� rg r� r� r� r� rE r� r� �
identifier_rer� � _parse_paren_expression_listrJ rN rU r� rY r� r\ )r" r� rF rV rP ZexprsrZ r r r �_parse_attributex sT
zBaseParser._parse_attributec C s t �d S r( rw r) r r r r� � s z'BaseParser._parse_paren_expression_list)(r r r r2 r r ZNoder
r= rH r r ra rv �propertyrx r~ r� r� r r< r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r@ r� rO r� r r r r rb � s> �
8rb )3r� �copyr �typingr r r r r r r
r Zdocutilsr Zdocutils.nodesr
Z
sphinx.configr Z sphinx.utilr Z getLoggerr r� r2 r? r� r� Zanon_identifier_rer� Zinteger_literal_reZoctal_literal_reZhex_literal_reZbinary_literal_reZintegers_literal_suffix_reZfloat_literal_reZfloat_literal_suffix_reZchar_literal_rer r r r r@ rE rN rU rY r\ rO r` ra rb r r r r �<module> s@ (
"