U \ªSh<ã@sîdZddlmZddlZddlmZddlmZmZddl m Z ddlmZddl mZdd lmZdd lmZe e¡ZeegefZe d¡Ze d¡Zejd ejdZe d¡Ze d¡Ze d¡Ze d¡Z ejdejdZ!ejdejdZ"e d¡Z#ejdejdZ$dddœdd„Z%Gdd„de&ƒZ'Gdd„dƒZ(Gd d!„d!e(ƒZ)Gd"d#„d#e)ƒZ*Gd$d%„d%e(ƒZ+Gd&d'„d'e)ƒZ,Gd(d)„d)e)ƒZ-Gd*d+„d+e)ƒZ.Gd,d-„d-e(ƒZ/Gd.d/„d/e(ƒZ0Gd0d1„d1e&ƒZ1Gd2d3„d3e&ƒZ2Gd4d5„d5ƒZ3dS)6z2Utility functions common to the C and C++ domains.é)ÚannotationsN©Údeepcopy)ÚAnyÚCallable)Únodes)ÚTextElement)Úaddnodes)ÚConfig)Úloggingz\s+z(@[a-zA-Z0-9_])[a-zA-Z0-9_]*\ba ( # 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 )Úflagsz[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! # 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 [+-]?( # 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Î ((?: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}) )) )' ÚstrÚNone)ÚmodeÚreturncCs|dkrtd|ƒ‚dS)N)Z lastIsNameZ noneIsNameZmarkTypeZmarkNameÚparamZudlz!Description mode '%s' is invalid.)Ú Exception)r©rúF/root/rtd-docs/venv/lib/python3.8/site-packages/sphinx/util/cfamily.pyÚverify_description_modeKsrc@seZdZdS)ÚNoOldIdErrorN©Ú__name__Ú __module__Ú__qualname__rrrrrPsrc@sheZdZdddœdd„ZdZddœdd „Zd ddœd d„Zddœdd„Zddœdd„Zddœdd„Z dS)ÚASTBaseBaserÚbool©ÚotherrcCs^t|ƒt|ƒk rdSz.|j ¡D]\}}|t||ƒkr WdSq Wntk rXYdSXdS)NFT)ÚtypeÚ__dict__ÚitemsÚgetattrÚAttributeError)ÚselfrÚkeyÚvaluerrrÚ__eq__VszASTBaseBase.__eq__N©rcCst|ƒS©Nr©r$rrrÚclonedszASTBaseBase.cloneÚStringifyTransformr ©Ú transformrcCstt|ƒƒ‚dSr)©ÚNotImplementedErrorÚrepr©r$r.rrrÚ _stringifygszASTBaseBase._stringifycCs| dd„¡S)NcSst|ƒSr))r ©ÚastrrrÚkóz%ASTBaseBase.__str__..©r3r*rrrÚ__str__jszASTBaseBase.__str__cCs| dd„¡S)NcSs| ¡Sr))Úget_display_stringr4rrrr6nr7z0ASTBaseBase.get_display_string..r8r*rrrr:mszASTBaseBase.get_display_stringcCsd|jjS)Nz<%s>)Ú __class__rr*rrrÚ__repr__pszASTBaseBase.__repr__) rrrr'Ú__hash__r+r3r9r:r<rrrrrUsrc@seZdZdddœdd„ZdS)ÚASTAttributerr©ÚsignodercCstt|ƒƒ‚dSr)r/©r$r@rrrÚdescribe_signatureyszASTAttribute.describe_signatureN)rrrrBrrrrr>xsr>c@s<eZdZdddœdd„Zdddœdd „Zd ddœdd „ZdS)ÚASTCPPAttributer r)ÚargrcCs ||_dSr)©rD)r$rDrrrÚ__init__~szASTCPPAttribute.__init__r,r-cCsd|jdS©Nz[[z]]rEr2rrrr3szASTCPPAttribute._stringifyrr?cCs:| t dd¡¡| t |j¡¡| t dd¡¡dSrG)Úappendr Zdesc_sig_punctuationrÚTextrDrArrrrB„sz"ASTCPPAttribute.describe_signatureN©rrrrFr3rBrrrrrC}srCc@s.eZdZddddœdd„Zdddœd d „ZdS)ÚASTGnuAttributer úASTBaseParenExprList | Noner)ÚnameÚargsrcCs||_||_dSr))rMrN)r$rMrNrrrrF‹szASTGnuAttribute.__init__r,r-cCs(|jg}|jr| ||jƒ¡d |¡S©NÚ)rMrNrHÚjoin)r$r.Úresrrrr3szASTGnuAttribute._stringifyN)rrrrFr3rrrrrKŠsrKc@s<eZdZdddœdd„Zdddœd d „Zdddœd d„ZdS)ÚASTGnuAttributeListzlist[ASTGnuAttribute]r©ÚattrsrcCs ||_dSr)©rU©r$rUrrrrF—szASTGnuAttributeList.__init__r,r r-cCsJdg}d}|jD]$}|s"| d¡d}| ||ƒ¡q| d¡d |¡S)Nz__attribute__((Tz, Fz))rP)rUrHrQ)r$r.rRÚfirstÚattrrrrr3šs zASTGnuAttributeList._stringifyrr?cCst|ƒ}| t |¡¡dSr)©r rHrrI©r$r@ÚtxtrrrrB¥sz&ASTGnuAttributeList.describe_signatureNrJrrrrrS–srSc@s@eZdZdZdddœdd„Zdddœd d „Zdddœd d„ZdS)ÚASTIdAttributez*For simple attributes defined by the user.r r)ÚidrcCs ||_dSr)©r^)r$r^rrrrFszASTIdAttribute.__init__r,r-cCs|jSr)r_r2rrrr3°szASTIdAttribute._stringifyrr?cCs| t |j¡¡dSr))rHrrIr^rArrrrB³sz!ASTIdAttribute.describe_signatureN©rrrÚ__doc__rFr3rBrrrrr]ªsr]c@sBeZdZdZddddœdd„Zdddœd d „Zdddœd d„ZdS)ÚASTParenAttributez)For paren attributes defined by the user.r r)r^rDrcCs||_||_dSr)©r^rD)r$r^rDrrrrFºszASTParenAttribute.__init__r,r-cCs|jd|jdS)Nú(ú)rcr2rrrr3¾szASTParenAttribute._stringifyrr?cCst|ƒ}| t |¡¡dSr)rZr[rrrrBÁsz$ASTParenAttribute.describe_signatureNr`rrrrrb·srbc@sZeZdZdddœdd„Zddœdd „Zddd œdd„Zd ddœdd„Zdddœdd„ZdS)ÚASTAttributeListzlist[ASTAttribute]rrTcCs ||_dSr)rVrWrrrrFÇszASTAttributeList.__init__Úintr(cCs t|jƒSr))ÚlenrUr*rrrÚ__len__ÊszASTAttributeList.__len__rcCst|j|jƒSr))rfrU)r$rrrrÚ__add__ÍszASTAttributeList.__add__r,r r-csd ‡fdd„|jDƒ¡S)Nú c3s|]}ˆ|ƒVqdSr)r)Ú.0rY©r.rrÚ Ñsz.ASTAttributeList._stringify..)rQrUr2rrmrr3ÐszASTAttributeList._stringifyrr?cCsdt|jƒdkrdS|jd |¡t|jƒdkr4dS|jdd…D]}| t ¡¡| |¡qBdS)Nré)rhrUrBrHr Zdesc_sig_space)r$r@rYrrrrBÓsz#ASTAttributeList.describe_signatureN)rrrrFrirjr3rBrrrrrfÆs rfc@seZdZdS)ÚASTBaseParenExprListNrrrrrrpàsrpc@seZdZdS)Ú$UnsupportedMultiCharacterCharLiteralNrrrrrrqæsrqc@seZdZdS)ÚDefinitionErrorNrrrrrrrêsrrc@s~eZdZdddddœdd„Zddd d œdd„Zedd œdd„ƒZdddœdd„Zdddœdd„Zdddœdd„Z dddœdd„Z dddœdd„Zdddœd d!„Zdd œd"d#„Z dddœd$d%„Zdddœd&d'„Zedd œd(d)„ƒZedd œd*d+„ƒZedd œd,d-„ƒZdd œd.d/„Zd0d1œddd2œd3d4„Zed5d6„ƒZed7d8„ƒZd9dd:œd;d<„Zd=d œd>d?„Zd@d œdAdB„ZdCd œdDdE„ZdFS)GÚ BaseParserr z"nodes.Node | tuple[str, int] | strr r)Ú definitionÚlocationÚconfigrcCsD| ¡|_||_||_d|_t|jƒ|_d|_d|_g|_ d|_ dS)Nr)rNT)ÚstriprtrurvÚposrhÚendÚ last_matchÚ_previous_stateÚotherErrorsZallowFallbackExpressionParsing)r$rtrurvrrrrFïs zBaseParser.__init__z list[Any]rr)ÚerrorsÚheaderrcCsìt|ƒdkrHt|ƒdkr4t|dt|ddƒƒStt|ddƒƒS|dg}|D]ˆ}t|dƒdkrÊd}| |d¡| d¡t|dƒ d¡D]0}t|ƒdkr¨q–| |¡| |¡| d¡q–qT| t|dƒ¡qTtd |¡ƒS)NrorÚ z z: rP)rhrrr rHÚsplitrQ)r$r}r~ÚresultÚeÚindentÚlinerrrÚ_make_multi_errorÿs$ zBaseParser._make_multi_errorr(cCst‚dSr)©r0r*rrrÚlanguageszBaseParser.language)ÚmsgrcCs,d|jd}t|›d|j›d|›ƒdS)Nú-ú^r)rxÚprintrt)r$rˆÚ indicatorrrrÚstatusszBaseParser.statuscCslg}d|jd}td|j||j|j|fƒ}| |df¡|jD]}| |df¡qBg|_| |d¡‚dS)Nr‰rŠz2Invalid %s declaration: %s [error at %d] %s %sz Main errorzPotential other errorrP)rxrrr‡rtrHr|r…)r$rˆr}rŒZexMainÚerrrrrÚfailsÿÿ zBaseParser.failcCstj||jddS)N)ru)ÚloggerÚwarningru)r$rˆrrrÚwarn*szBaseParser.warnzre.Pattern[str]r)ÚregexrcCs>| |j|j¡}|dk r:|j|jf|_| ¡|_||_dSdS©NTF)Úmatchrtrxrzr{ry)r$r“r•rrrr•-s zBaseParser.match)ÚstringrcCs8t|ƒ}|j|j|j|…|kr4|j|7_dSdSr”)rhrtrx)r$r–ZstrlenrrrÚskip_string6s zBaseParser.skip_string)ÚwordrcCs| t dt |¡¡¡S)Nz\b%s\b)r•ÚreÚcompileÚescape©r$r˜rrrÚ skip_word=szBaseParser.skip_wordcCs | t¡Sr))r•Ú_whitespace_rer*rrrÚskip_ws@szBaseParser.skip_wscCs| |¡r| ¡dSdSr”)rrŸrœrrrÚskip_word_and_wsCs zBaseParser.skip_word_and_wscCs| |¡r| ¡dSdSr”)r—rŸ)r$r–rrrÚskip_string_and_wsIs zBaseParser.skip_string_and_wscCs|j|jkSr))rxryr*rrrÚeofOszBaseParser.eofcCs*z|j|jWStk r$YdSXdS)NZEOF)rtrxÚ IndexErrorr*rrrÚcurrent_charSszBaseParser.current_charcCs|jdk r|j ¡SdSrO)rzÚgroupr*rrrÚmatched_textZs zBaseParser.matched_textcCs|j|jd…}|j|_|Sr))rtrxry)r$ÚrvrrrÚ read_rest`szBaseParser.read_restF)ÚallowSemicolon)r©rcCsF| ¡|r2|jsB|j|jd…dkrB| d¡n|jsB| d¡dS)Nú;z Expected end of definition or ;.zExpected end of definition.)rŸr¢rtrxr)r$r©rrrÚ assert_endeszBaseParser.assert_endcCst‚dSr)r†r*rrrÚ id_attributespszBaseParser.id_attributescCst‚dSr)r†r*rrrÚparen_attributestszBaseParser.paren_attributesz list[str])ryrcCsÂddddœ}|j}g}|jsžt|ƒdkr4|j|kr4qž|j|krP| ||j¡n>t|ƒdkrt|j|dkrt| ¡n|jdkrŽ| d|j¡|jd 7_q|jr²| d |¡|j||j…S)Nreú]Ú})rdú[Ú{réÿÿÿÿz)]}z&Unexpected '%s' in balanced-token-seq.roz8Could not find end of balanced-token-seq starting at %d.)rxr¢rhr¤rHÚpoprrt)r$ryZbracketsÚstartPosÚsymbolsrrrÚ_parse_balanced_token_seqxs$ ÿz$BaseParser._parse_balanced_token_seqzASTAttribute | NonecCs–| ¡|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 | d¡ràqì| d¡q | d¡s| d ¡t|ƒS|jD]}| |¡rt|ƒSq|jD]Z}| |¡sJq6| d¡s`| d¡|jdgd}| d¡s„| d¡t||ƒSdS)Nr°r®)ryz!Expected ']' in end of attribute.z-Expected ']' in end of attribute after [[...]Z __attribute__rdz#Expected '(' after '__attribute__'.z$Expected '(' after '__attribute__('.ú,rez2Expected identifier, ')', or ',' in __attribute__.z(Expected ')' after '__attribute__((...)'z0Expected '(' after user-defined paren-attribute.z1Expected ')' to end user-defined paren-attribute.)rŸrxr¡r—r¶rrCr r•Ú identifier_rer¦Ú_parse_paren_expression_listrHrKrSr¬r]rrb)r$r´rDrUrMZexprsr^rrrÚ_parse_attributeŒsT zBaseParser._parse_attributerfcCs*g}| ¡}|dkrq"| |¡qt|ƒSr))rºrHrf)r$rRrYrrrÚ_parse_attribute_listÃsz BaseParser._parse_attribute_listrLcCst‚dSr)r†r*rrrr¹Ìsz'BaseParser._parse_paren_expression_listN)rrrrFr…Úpropertyr‡rrr’r•r—rrŸr r¡r¢r¤r¦r¨r«r¬rr¶rºr»r¹rrrrrsîs: 7 rs)4raÚ __future__rr™ÚcopyrÚtypingrrZdocutilsrZdocutils.nodesrZsphinxr Z sphinx.configr Zsphinx.utilrÚ getLoggerrrr r,ršržZanon_identifier_reÚVERBOSEr¸Zinteger_literal_reZoctal_literal_reZhex_literal_reZbinary_literal_reZintegers_literal_suffix_reZfloat_literal_reZfloat_literal_suffix_reZchar_literal_rerrrrr>rCrKrSr]rbrfrprqrrrsrrrrÚsX ù ÷ ô ô#