| 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 Z ddlZddlmZ ddlmZmZmZmZm Z m
Z
m Z m Z ddl
mZ ddlmZ ddlmZ ddlmZ e�e�Zeegef 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$e�d�Z%edd�dd�Z&G dd� de'�Z(G dd� d�Z)G dd � 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,e'�Z2G d-d.� d.�Z3dS )/z�
sphinx.util.cfamily
~~~~~~~~~~~~~~~~~~~
Utility functions common to the C and C++ domains.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� 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( )rO rP )r" rO rP r r r rH � s zASTGnuAttribute.__init__r+ c C s( | j g}| jr |�|| j�� d�|�S )N� )rO rP rJ �join)r" r, �resr r r r1 � s zASTGnuAttribute._stringify)r r r r2 r rH r? r1 r r r r rM � s rM c @ s@ e Zd Zee dd�dd�Zeed�dd�Ze dd�d d
�Z
dS ) �ASTGnuAttributeListN)�attrsr c C s
|| _ d S r( )rU )r" rU 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))rQ )rU rJ rR )r" r, rS �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 rM rH r? r2 r1 r
rD r r r r rT � s rT c @ s@ e Zd ZdZedd�dd�Zeed�dd�Zedd �d
d �Z dS ) �ASTIdAttributez*For simple attributes defined by the user.N)�idr c C s
|| _ d S r( �rY )r" rY r r r rH � s zASTIdAttribute.__init__r+ c C s | j S r( rZ r0 r r r r1 � s zASTIdAttribute._stringifyrA c C s |� t�| j| j�� d S r( )rJ r rK rY rC r r r rD � s z!ASTIdAttribute.describe_signature�
r r r �__doc__r2 rH r? r1 r
rD r r r r rX � s rX c @ sB e Zd ZdZeedd�dd�Zeed�dd�Zedd �d
d �Z dS ) �ASTParenAttributez)For paren attributes defined by the user.N)rY rF r c C s || _ || _d S r( �rY rF )r" rY 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_signaturer[ r r r r r] � s r] c @ s e Zd ZdS )rN Nr r r r r rN � s rN c @ s e Zd ZdS )�$UnsupportedMultiCharacterCharLiteralNr r r r r ra � s ra c @ s e Zd ZdS )�DefinitionErrorNr r r r r rb � s rb 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) �striprd re rf �pos�len�end�
last_match�_previous_state� otherErrorsZ allowFallbackExpressionParsing)r" rd re rf 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:
rQ )ri rb r2 rJ �splitrR )r" rn ro �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)rh �printrd )r" rz � 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 )Nr{ r| z2Invalid %s declaration: %s [error at %d]
%s
%sz
Main errorzPotential other errorrQ )rh rb ry rd rJ rm rw )r" rz rn r~ ZexMain�errr r r �fail s ��
zBaseParser.failc C s t j|| jd� d S )N)re )�loggerZwarningre )r" rz r r r �warn s zBaseParser.warn)�regexr c C s> |� | j| j�}|d ur:| j| jf| _|�� | _|| _dS dS �NTF)�matchrd rh rk rl rj )r" r� r� r r r r� s
zBaseParser.match)�stringr c C s8 t |�}| j| j| j| � |kr4| j|7 _dS dS r� )ri rd rh )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( )rh rj r) r r r �eof: s zBaseParser.eofc C s( z| j | j W S ty" Y dS 0 d S )NZEOF)rd rh �
IndexErrorr) r r r � current_char> s zBaseParser.current_charc C s | j d ur| j �� S d S d S r( )rk �groupr) r r r � matched_textE s
zBaseParser.matched_textc C s | j | jd � }| j| _|S r( )rd rh rj )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� rd rh r� )r" r� r r r �
assert_endQ s zBaseParser.assert_endc C s t �d S r( rx r) r r r �
id_attributes\ s zBaseParser.id_attributesc C s t �d S r( rx r) r r r �paren_attributes` s zBaseParser.paren_attributes)rj 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.rp z8Could not find end of balanced-token-seq starting at %d.) rh r� ri r� �keysrJ �popr� rd )r" rj 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� )rj 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� rh r� r� r� r� rE r� r� �
identifier_rer� � _parse_paren_expression_listrJ rM rT r� rX r� r] )r" r� rF rU rO ZexprsrY r r r �_parse_attributex sT
zBaseParser._parse_attributec C s t �d S r( rx r) r r r r� � s z'BaseParser._parse_paren_expression_list)(r r r r2 r r ZNoder
r= rH r r rb rw �propertyry r r� r� r r< r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r@ r� rN r� r r r r rc � s> �
8rc )4r\ r� �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 rM rT rX r] rN ra rb rc r r r r �<module> sB
(
"