Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
lib
/
python3
/
dist-packages
/
sphinx
/
util
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: 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 ( "
Save
Cancel