File: //lib/python3/dist-packages/sphinx/util/__pycache__/cfamily.cpython-310.pyc
o
�$�a�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%deddfdd�Z&G dd� de'�Z(G dd� d�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-e'�Z2G d.d/� d/�Z3dS )0z�
sphinx.util.cfamily
~~~~~~~~~~~~~~~~~~~
Utility functions common to the C and C++ domains.
:copyright: Copyright 2007-2021 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 | dvr
t d| ��d S )N)�
lastIsName�
noneIsName�markType�markName�param�udlz!Description mode '%s' is invalid.)� Exception)r � r �5/usr/lib/python3/dist-packages/sphinx/util/cfamily.py�verify_description_modeP s �r c @ � e Zd ZdS )� NoOldIdErrorN��__name__�
__module__� __qualname__r r r r r U s r c @ s~ e Zd ZU dedefdd�ZdZeg ef e d< defdd�Z
d e de fd
d �Z
de fd d
�Zde fdd�Zde fdd�ZdS )� ASTBaseBase�otherr c C sZ t | �t |�ur
dS z| j�� D ]\}}|t||�kr W dS qW dS ty, Y dS w )NFT)�type�__dict__�items�getattr�AttributeError)�selfr# �key�valuer r r �__eq__[ s �� ��zASTBaseBase.__eq__N�__hash__c C � t | �S �Nr �r) r r r �cloneh s zASTBaseBase.clone� transformc C � t t| ���r/ ��NotImplementedError�repr�r) r2 r r r �
_stringifyk � zASTBaseBase._stringifyc C � | � dd� �S )Nc S r. r/ )�str��astr r r �<lambda>o � z%ASTBaseBase.__str__.<locals>.<lambda>�r8 r0 r r r �__str__n � zASTBaseBase.__str__c C r: )Nc S s | � � S r/ )�get_display_stringr< r r r r> r r? z0ASTBaseBase.get_display_string.<locals>.<lambda>r@ r0 r r r rC q rB z ASTBaseBase.get_display_stringc C s d| j j S )Nz<%s>)� __class__r r0 r r r �__repr__t r9 zASTBaseBase.__repr__)r r r! r �boolr, r- r �int�__annotations__r1 �StringifyTransformr; r8 rA rC rE r r r r r" Z s
r" c @ s e Zd Zdeddfdd�ZdS )� ASTAttribute�signoder Nc C r3 r/ r4 �r) rK r r r �describe_signature} r9 z ASTAttribute.describe_signature)r r r! r
rM r r r r rJ | s rJ c @ sB e Zd Zdeddfdd�Zdedefdd�Zd eddfd
d �ZdS ) �ASTCPPAttribute�argr Nc C �
|| _ d S r/ �rO )r) rO r r r �__init__� �
zASTCPPAttribute.__init__r2 c C s d| j d S )Nz[[z]]rQ r7 r r r r8 � rB zASTCPPAttribute._stringifyrK c C � t | �}|�t�||�� d S r/ �r; �appendr �Text�r) rK �txtr r r rM � � z"ASTCPPAttribute.describe_signature) r r r! r; rR rI r8 r
rM r r r r rN � s rN c @ s8 e Zd Zdeded ddfdd�Zdedefd d
�ZdS ) �ASTGnuAttribute�name�args�ASTBaseParenExprListr Nc C � || _ || _d S r/ )r\ r] )r) r\ r] r r r rR � �
zASTGnuAttribute.__init__r2 c C s( | j g}| jr|�|| j�� d�|�S )N� )r\ r] rV �join)r) r2 �resr r r r8 � s
zASTGnuAttribute._stringify)r r r! r; r rR rI r8 r r r r r[ � s r[ c @ sF e Zd Zdee ddfdd�Zdedefdd�Zd e ddfd
d �Z
dS ) �ASTGnuAttributeList�attrsr Nc C rP r/ )re )r) re r r r rR � rS z ASTGnuAttributeList.__init__r2 c C sJ dg}d}| j D ]}|s|�d� d}|�||�� q|�d� d�|�S )Nz__attribute__((Tz, Fz))ra )re rV rb )r) r2 rc �first�attrr r r r8 � s
z ASTGnuAttributeList._stringifyrK c C rT r/ rU rX r r r rM � rZ z&ASTGnuAttributeList.describe_signature) r r r! r r[ rR rI r; r8 r
rM r r r r rd � s rd c @ sF e Zd ZdZdeddfdd�Zdedefdd �Zd
eddfd d �Z dS )
�ASTIdAttributez*For simple attributes defined by the user.�idr Nc C rP r/ �ri )r) ri r r r rR � rS zASTIdAttribute.__init__r2 c C s | j S r/ rj r7 r r r r8 � s zASTIdAttribute._stringifyrK c C s |� t�| j| j�� d S r/ )rV r rW ri rL r r r rM � � z!ASTIdAttribute.describe_signature�
r r r! �__doc__r; rR rI r8 r
rM r r r r rh � s
rh c @ sJ e Zd ZdZdededdfdd�Zdedefd d
�Zd eddfd d
�Z dS )�ASTParenAttributez)For paren attributes defined by the user.ri rO r Nc C r_ r/ �ri rO )r) ri rO r r r rR � r` zASTParenAttribute.__init__r2 c C s | j d | j d S )N�(�)ro r7 r r r r8 � � z ASTParenAttribute._stringifyrK c C rT r/ rU rX r r r rM � rZ z$ASTParenAttribute.describe_signaturerl r r r r rn � s
rn c @ r )r^ Nr r r r r r^ � � r^ c @ r )�$UnsupportedMultiCharacterCharLiteralNr r r r r rt � rs rt c @ r )�DefinitionErrorNr r r r r ru � rs ru c @ s� e Zd Zdedeejeeef ef ddddfdd�Z d e
e d
ede fd d �Z
edefd
d��Zdeddfdd�Zdeddfdd�Zdeddfdd�Zdedefdd�Zdedefdd�Zd edefd d �Zdefd d �Zd edefd!d"�Zdedefd#d$�Zedefd%d&��Zedefd'd(��Z edefd)d*��Z defd+d,�Z d-d.�d/eddfd0d1�Z ed2d3� �Z ed4d5� �Z!d6e
e defd7d8�Z"de#e$ fd9d:�Z%de&fd;d<�Z'dS )=�
BaseParser�
definition�location�configr r Nc C sD |� � | _|| _|| _d| _t| j�| _d | _d| _g | _ d| _
d S )Nr )r NT) �striprw rx ry �pos�len�end�
last_match�_previous_state� otherErrors� allowFallbackExpressionParsing)r) rw rx ry r r r rR � s
zBaseParser.__init__�errors�headerc C s� t |�dkr$t |�dkrt|d t|d d � �S tt|d d ��S |dg}|D ]D}t |d �dkred}|�|d � |�d� t|d ��d�D ]}t |�dkrTqK|�|� |�|� |�d� qKq*|�t|d �� q*td�|��S )N� r �
z z:
ra )r| ru r; rV �splitrb )r) r� r� �result�e�indent�liner r r �_make_multi_error� s&
�z BaseParser._make_multi_errorc C � t �r/ �r5 r0 r r r �language � zBaseParser.language�msgc C s& d| j d }td|| j|f � d S )N�-�^z%s
%s
%s)r{ �printrw )r) r� � indicatorr r r �status s zBaseParser.statusc C sh g }d| j d }td| j|| j | j|f �}|�|df� | jD ] }|�|df� q!g | _| �|d��)Nr� r� z2Invalid %s declaration: %s [error at %d]
%s
%sz
Main errorzPotential other errorra )r{ ru r� rw rV r� r� )r) r� r� r� �exMain�errr r r �fail s ��
zBaseParser.failc C s t j|| jd� d S )N)rx )�logger�warningrx )r) r� r r r �warn rr zBaseParser.warn�regexc C s> |� | j| j�}|d ur | j| jf| _|�� | _|| _dS dS �NTF)�matchrw r{ r~ r r} )r) r� r� r r r r� s
zBaseParser.match�stringc C s8 t |�}| j| j| j| � |kr| j|7 _dS dS r� )r| rw r{ )r) r� �strlenr r r � skip_string! s
zBaseParser.skip_string�wordc C s | � t�dt�|� ��S )Nz\b%s\b)r� �re�compile�escape�r) r� r r r � skip_word( rk zBaseParser.skip_wordc C s
| � t�S r/ )r� �_whitespace_rer0 r r r �skip_ws+ rS zBaseParser.skip_wsc C � | � |�r | �� dS dS r� )r� r� r� r r r �skip_word_and_ws. �
zBaseParser.skip_word_and_wsc C r� r� )r� r� )r) r� r r r �skip_string_and_ws4 r� z BaseParser.skip_string_and_wsc C s | j | jkS r/ )r{ r} r0 r r r �eof: s zBaseParser.eofc C s$ z| j | j W S ty Y dS w )N�EOF)rw r{ �
IndexErrorr0 r r r � current_char> s
�zBaseParser.current_charc C s | j d ur
| j �� S d S r/ )r~ �groupr0 r r r � matched_textE s
zBaseParser.matched_textc C s | j | jd � }| j| _|S r/ )rw r{ r} )r) �rvr r r � read_restL s zBaseParser.read_restF)�allowSemicolonr� c C sT | � � |r | js| j| jd � dkr | �d� d S d S d S | js(| �d� d S d S )N�;z Expected end of definition or ;.zExpected end of definition.)r� r� rw r{ r� )r) r� r r r �
assert_endQ s ��zBaseParser.assert_endc C r� r/ r� r0 r r r �
id_attributes\ r� zBaseParser.id_attributesc C r� r/ r� r0 r r r �paren_attributes` r� zBaseParser.paren_attributesr} c C s� dddd�}| j }g }| jsSt|�dkr| j|v rn9| j|�� v r*|�|| j � n t|�dkr<| j|d kr<|�� n
| jdv rI| �d| j � | j d 7 _ | jr| jr]| �d
| � | j|| j � S ) Nrq �]�})rp �[�{r ���z)]}z&Unexpected '%s' in balanced-token-seq.r� z8Could not find end of balanced-token-seq starting at %d.) r{ r� r| r� �keysrV �popr� rw )r) r} �brackets�startPos�symbolsr r r �_parse_balanced_token_seqd s&
�
�z$BaseParser._parse_balanced_token_seqc C s� | � � | j}| �d�r4| �d�s|| _n | jdgd�}| �d�s&| �d� | �d�s0| �d� t|�S | �d�r�| �d�sC| �d� | �d�sM| �d � g } | �t �rd| j
}| � � }|� t
||�� | �d �rjqO| �d �rpn| �d
� qP| �d �s�| �d� t|�S | jD ]
}| �|�r�t|� S q�| jD ])}| �|�s�q�| �d�s�| �d� | jd gd�}| �d �s�| �d� t||� S d S )Nr� r� )r} z!Expected ']' in end of attribute.z-Expected ']' in end of attribute after [[...]�
__attribute__rp z#Expected '(' after '__attribute__'.z$Expected '(' after '__attribute__('.r� �,rq z2Expected identifier, ')', or ',' in __attribute__.z(Expected ')' after '__attribute__((...)'z0Expected '(' after user-defined paren-attribute.z1Expected ')' to end user-defined paren-attribute.)r� r{ r� r� r� r� rN r� r� �
identifier_rer� � _parse_paren_expression_listrV r[ rd r� rh r� rn )r) r� rO re r\ �exprsri r r r �_parse_attributex sZ
�
�
zBaseParser._parse_attributec C r� r/ r� r0 r r r r� � s z'BaseParser._parse_paren_expression_list)(r r r! r; r r �Noder
rG rR r r ru r� �propertyr� r� r� r� r rF r� r� r� r� r� r� r� r� r� r� r� r� r� r� r rJ r� r^ r� r r r r rv � sF ��
�
8rv )4rm r� �copyr �typingr r r r r r r
r �docutilsr �docutils.nodesr
�
sphinx.configr � sphinx.utilr � getLoggerr r� r; rI r� r� �anon_identifier_rer� �integer_literal_re�octal_literal_re�hex_literal_re�binary_literal_re�integers_literal_suffix_re�float_literal_re�float_literal_suffix_re�char_literal_rer r r r" rJ rN r[ rd rh rn r^ rt ru rv r r r r �<module> sD
(
"