3
T'íc+[ ã / @ s d Z ddlZddlmZmZmZmZmZmZm Z m
Z
m Z m Z m
Z
ddlmZ ddlmZmZmZmZ ddlmZ ddlmZ ddlmZ dd lm Z dd
l m Z dd l m Z dd l!m"Z" dd
l#m$Z$m%Z% ddl&m'Z' ddl(m)Z)m*Z* ddl+m,Z,m-Z- ddl.m/Z/ ddl0m1Z1 ddl2m3Z3 ddl4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZG ddlHmIZImJZJmKZK ddlLmMZM ddlNmOZO ddlPmQZQ e3jReSZTe dZUe d3 ZVd!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOg/ZWdPdQdRdSdTdUdVdWgZXdXdYgdZd[gd\d]gd^d_gd`dagdbdcddgdedfdgdhgdidjgdkdlgdmdndogdpdqgg ZYdrdsdmd`dkdldtdudvdwg
ZZdxdydzd{d|d}d~ddddddd
gZ[dZ\dddgZ]ej^dej_Z`ej^dZaG dd debZcG dd de6ZdG dd de6ZeG dd dedZfG dd dedZgG dd degZhG dd dehZiG dd dehZjG dd dehZkG dd dehZlG dd d egZmG d¡d¢ d¢egZnG d£d¤ d¤edZoG d¥d¦ d¦eoZpG d§d¨ d¨eoZqG d©dª dªeoZrG d«d¬ d¬eoZsG dd® d®eoZtG d¯d° d°egZuG d±d² d²egZvG d³d´ d´egZwG dµd¶ d¶egZxG d·d¸ d¸egZyG d¹dº dºegZzG d»d¼ d¼edZ{G d½d¾ d¾egZ|G d¿dÀ dÀegZ}G dÁd dÂedZ~G dÃdÄ dÄe~ZG dÅdÆ dÆe~ZG dÇdÈ dÈedZG dÉdÊ dÊedZG dËdÌ dÌe6ZG dÍdÎ dÎedZG dÏdÐ dÐedZ
G dÑdÒ dÒedZG dÓdÔ dÔeZG dÕdÖ dÖeZG d×dØ dØeZG dÙdÚ dÚeZG dÛdÜ dÜe7ZG dÝdÞ dÞedZG dßdà dàedZG dád d edZG dâd d edZG dãdä däedZG dåd d edZG dæd dedZG dçd dedZG dèd d edZG déd d edZG dêdë dëe6ZG dìdí díZG dîdï dïZG dðdñ dñZG dòdó dóe8ZefdôdõdöZG d÷dø døe"e ZG dùdú dúeZeKdûe)düd4d d5deJde)dd6ddeIde)d d
d7d eId
e)dd
d8d gZG dd deZG dd deZ G dd deZ¡G dd deZ¢G dd deZ£G dd deZ¤G d d d eZ¥G d d d eMZ¦G d d! d!eMZ§G d"d# d#eMZ¨G d$d% d%ejZ©G d&d' d'e/ZªG d(d) d)e"Z«G d*d+ d+e-Z¬G d,d- d-e,ZG d.d/ d/e$Z®e ee¯ef d0d1d2Z°dS (9 zThe C language domain.é N) ÚAnyÚCallableÚDictÚ GeneratorÚIteratorÚListÚOptionalÚTupleÚTypeVarÚUnionÚcast)Únodes)ÚElementÚNodeÚ TextElementÚsystem_message)Ú
directives)Úaddnodes)Ú pending_xref)ÚSphinx)ÚBuilder)ÚRemovedInSphinx50Warning)ÚObjectDescription)ÚDomainÚObjType)ÚBuildEnvironment)Ú_Ú__)Ú
SphinxRoleÚXRefRole)ÚSphinxTransform)ÚReferencesResolver)Úlogging)Ú ASTAttributeÚ ASTBaseBaseÚASTBaseParenExprListÚ
BaseParserÚDefinitionErrorÚ NoOldIdErrorÚStringifyTransformÚ$UnsupportedMultiCharacterCharLiteralÚanon_identifier_reÚbinary_literal_reÚchar_literal_reÚfloat_literal_reÚfloat_literal_suffix_reÚhex_literal_reÚ
identifier_reÚinteger_literal_reÚintegers_literal_suffix_reÚoctal_literal_reÚverify_description_mode)ÚFieldÚ GroupedFieldÚ
TypedField)ÚSphinxDirective)Ú make_refnode)Ú
OptionSpecÚTÚ ASTStructÚASTUnionÚASTEnumÚ
ASTEnumeratorÚASTTypeÚASTTypeWithInitÚASTMacroÚautoÚbreakZcaseÚcharÚconstÚcontinueÚdefaultZdoÚdoubleÚelseÚenumÚexternÚfloatÚforÚgotoÚifÚinlineÚintÚlongÚregisterÚrestrictÚreturnÚshortÚsignedÚsizeofÚstaticÚstructÚswitchÚtypedefÚunionZunsignedÚvoidÚvolatileÚwhileZ_AlignasZ_AlignofZ_AtomicZ_BoolZ_ComplexZ
_Decimal32Z
_Decimal64Z _Decimal128Z_GenericZ
_ImaginaryZ _NoreturnZ_Static_assertÚ
_Thread_localZalignasÚalignofÚboolÚcomplexÚ imaginaryZnoreturnZ
static_assertÚ thread_localz||Úorz&&Úandú|Zbitorú^Úxorú&Zbitandz==z!=Znot_eqz<=z>=ú<ú>z<<z>>ú+ú-Ú*ú/ú%z.*z->*z++z--ú!Únotú~Zcomplú=z*=z/=z%=z+=z-=z>>=z<<=z&=Zand_eqz^=Zxor_eqz|=Zor_eqé zc.zCv2.z>[LuU8]?('([^'\\]*(?:\\.[^'\\]*)*)'|"([^"\\]*(?:\\.[^"\\]*)*)")an (?x)
\b(
void|_Bool
|signed|unsigned
|short|long
|char
|int
|__uint128|__int128
|__int(8|16|32|64|128) # extension
|float|double
|_Decimal(32|64|128)
|_Complex|_Imaginary
|__float80|_Float64x|__float128|_Float128|__ibm128 # extension
|__fp16 # extension
|_Sat|_Fract|fract|_Accum|accum # extension
)\b
c @ s, e Zd ZddddddZeddd ZdS )
Ú_DuplicateSymbolErrorÚSymbolÚASTDeclarationN)ÚsymbolÚ declarationrW c C s |st |st || _|| _d S )N)ÚAssertionErrorr~ r )Úselfr~ r © r ú2/tmp/pip-build-gk9425m9/sphinx/sphinx/domains/c.pyÚ__init__l s z _DuplicateSymbolError.__init__)rW c C s d| j jd S )Nz%Internal C duplicate symbol error:
%sr )r~ Údump)r r r r Ú__str__r s z _DuplicateSymbolError.__str__)Ú__name__Ú
__module__Ú __qualname__r Ústrr r r r r r{ k s r{ c @ s" e Zd ZeeddddddZdS )ÚASTBaser r| N)ÚsignodeÚmodeÚenvr~ rW c C s t t| d S )N)ÚNotImplementedErrorÚrepr)r r r r r~ r r r Údescribe_signaturew s zASTBase.describe_signature)r r r r r r r r r r r v s r c @ sn e Zd ZeddddZeedddZedd d
Zedd d Z edd
dZ
e ededddddZ dS )Ú
ASTIdentifierN)Ú
identifierrW c C s& |d k s t t|dks t || _d S )Nr )r Úlenr )r r r r r r s zASTIdentifier.__init__)ÚotherrW c C s t |tko| j|jkS )N)Útyper r )r r r r r Ú__eq__
s zASTIdentifier.__eq__)rW c C s | j d dkS )Nr ú@)r )r r r r Úis_anon s zASTIdentifier.is_anonc C s | j S )N)r )r r r r r s zASTIdentifier.__str__c C s | j r dS | jS )Nz [anonymous])r r )r r r r Úget_display_string s z ASTIdentifier.get_display_stringr r| )r r r Úprefixr~ rW c
C s¸ t | | j r tjdd}ntj| j| j}|dkrt|| j }tjddd|d d d}|j |d< ||7 }||7 }n@|d krtj } | |7 } || 7 }n |d
kr¨||7 }n td | d S ) Nz [anonymous])ÚtextÚmarkTypeÚ Úcr )Z refdomainZreftypeZ reftargetÚmodnameÚ classnamez c:parent_keyÚ
lastIsNameÚ
noneIsNamez Unknown description mode: %s) r5 r r Ú
desc_sig_namer r Úget_lookup_keyÚ desc_nameÚ Exception)
r r r r r r~ ÚnodeZ
targetTextÚpnodeZnameNoder r r r s(
z ASTIdentifier.describe_signature)
r r r r r r re r r r r r r r r r r r s r c @ sj e Zd Zee eddddZed dddZe e
dd d
Z e e
d d d
Z
ee
ddddddZdS )Ú
ASTNestedNameN)ÚnamesÚrootedrW c C s t |dkst|| _|| _d S )Nr )r r r« r¬ )r r« r¬ r r r r ¯ s zASTNestedName.__init__)rW c C s | S )Nr )r r r r Úname´ s zASTNestedName.name)ÚversionrW c C s dj dd | jD S )NÚ.c s s | ]}t |V qd S )N)r )Ú.0Únr r r ú <genexpr>¹ s z'ASTNestedName.get_id.<locals>.<genexpr>)Újoinr« )r r® r r r Úget_id¸ s zASTNestedName.get_id)Ú transformrW c s0 dj fdd| jD }| jr(d| S |S d S )Nr¯ c 3 s | ]} |V qd S )Nr )r° r± )rµ r r r² ¼ s z+ASTNestedName._stringify.<locals>.<genexpr>)r³ r« r¬ )r rµ Úresr )rµ r Ú
_stringify» s zASTNestedName._stringifyr r| )r r r r~ rW c
C s. t | |dkr| jr0ds"td|tjd7 }xTtt| jD ]B}|dkrfdsXtd|tjd7 }| j| }|j|||d| q@W n |dkrÔ| j s¦tt | t| jdks¸t| jd j|d|d| nV|dkr d}d }|d
k rþ| jd d
n| j} |}
|d
krt
j }
| jrd|d7 }|d
krTt| dkrT|t
j dd7 }n|
t
j dd7 }
xltt| D ]\}| | } |s|
t
j dd7 }
|d7 }d}t | } | dkrÄ| j|
d ||| || 7 }qrW |d
kr*t| jdkr|
t
j dd7 }
||
7 }| jd j|||d| n t
d
| d S )Nr£ FzCan this happen?r¯ r r Úparamrz r r¢ ÚmarkNameTz Unknown description mode: %s)r r¢ r¹ éÿÿÿÿrº )r5 r¬ r r
ZTextÚranger r« r r r Z desc_addnameÚdesc_sig_punctuationr§ )
r r r r r~ Úir± r Úfirstr« ÚdestÚidentZ txt_identr r r r  sV
z ASTNestedName.describe_signature)r r r r r re r Úpropertyr rS r r´ r) r· r r r r r r rª ® s rª c @ s e Zd ZdS )Ú
ASTExpressionN)r r r r r r r r ÿ s r c @ s e Zd ZdS )Ú
ASTLiteralN)r r r r r r r ràs rà c @ sB e Zd ZeddddZeedddZeedd dd
d d Z dS )
ÚASTBooleanLiteralN)ÚvaluerW c C s
|| _ d S )N)rÅ )r rÅ r r r r s zASTBooleanLiteral.__init__)rµ rW c C s | j r
dS dS d S )NÚtrueÚfalse)rÅ )r rµ r r r r· s z ASTBooleanLiteral._stringifyr r| )r r r r~ rW c C s t | }|tj||7 }d S )N)r r Údesc_sig_keyword)r r r r r~ Útxtr r r r s z$ASTBooleanLiteral.describe_signature)
r r r re r r) r r· r r r r r r rÄ
s rÄ c @ sB e Zd ZeddddZeedddZeedd dd
d d ZdS )
ÚASTNumberLiteralN)ÚdatarW c C s
|| _ d S )N)rË )r rË r r r r s zASTNumberLiteral.__init__)rµ rW c C s | j S )N)rË )r rµ r r r r· s zASTNumberLiteral._stringifyr r| )r r r r~ rW c C s t | }|tj||7 }d S )N)r r Zdesc_sig_literal_number)r r r r r~ rÉ r r r r ! s z#ASTNumberLiteral.describe_signature) r r r r r r) r· r r r r r r rÊ s rÊ c @ sD e Zd ZeeddddZeedddZeedd dd
d d ZdS )
ÚASTCharLiteralN)r rË rW c C s> || _ || _|j jd}t|dkr2t|| _nt|d S )Nzunicode-escaperz )r rË ÚencodeÚdecoder ÚordrÅ r* )r r rË Údecodedr r r r ( s zASTCharLiteral.__init__)rµ rW c C s0 | j d krd| j d S | j d | j d S d S )Nú')r rË )r rµ r r r r· 1 s
zASTCharLiteral._stringifyr r| )r r r r~ rW c C s t | }|tj||7 }d S )N)r r Zdesc_sig_literal_char)r r r r r~ rÉ r r r r 7 s z!ASTCharLiteral.describe_signature) r r r r r r) r· r r r r r r rÌ ' s rÌ c @ sB e Zd ZeddddZeedddZeedd dd
d d ZdS )
ÚASTStringLiteralN)rË rW c C s
|| _ d S )N)rË )r rË r r r r > s zASTStringLiteral.__init__)rµ rW c C s | j S )N)rË )r rµ r r r r· A s zASTStringLiteral._stringifyr r| )r r r r~ rW c C s t | }|tj||7 }d S )N)r r Zdesc_sig_literal_string)r r r r r~ rÉ r r r r D s z#ASTStringLiteral.describe_signature) r r r r r r) r· r r r r r r rÒ = s rÒ c @ sP e Zd ZedddZeedddZeeddd Z e
ed
d d d
ddZ d S )ÚASTIdExpression)r c C s
|| _ d S )N)r )r r r r r r K s zASTIdExpression.__init__)rµ rW c C s
|| j S )N)r )r rµ r r r r· O s zASTIdExpression._stringify)r® rW c C s | j j|S )N)r r´ )r r® r r r r´ R s zASTIdExpression.get_idr r| N)r r r r~ rW c C s | j j|||| d S )N)r r )r r r r r~ r r r r U s z"ASTIdExpression.describe_signature) r r r rª r r) r r· rS r´ r r r r r r rÓ J s
rÓ c @ sJ e Zd Zdd ZeedddZeedddZe ed d
d d d
dZ
d S )Ú ASTParenExprc C s
|| _ d S )N)Úexpr)r rÕ r r r r [ s zASTParenExpr.__init__)rµ rW c C s d|| j d S )Nú(ú))rÕ )r rµ r r r r· ^ s zASTParenExpr._stringify)r® rW c C s | j j|S )N)rÕ r´ )r r® r r r r´ a s zASTParenExpr.get_idr r| N)r r r r~ rW c C s6 |t jdd7 }| jj|||| |t jdd7 }d S )NrÖ r× )r r¼ rÕ r )r r r r r~ r r r r d s z ASTParenExpr.describe_signature) r r r r r) r r· rS r´ r r r r r r rÔ Z s
rÔ c @ s e Zd ZdS )Ú ASTPostfixOpN)r r r r r r r rØ n s rØ c @ sF e Zd Zed ddddZeeddd Zeed
d dd d
dZ dS )ÚASTPostfixCallExprÚASTParenExprListÚASTBracedInitListN)ÚlstrW c C s
|| _ d S )N)rÜ )r rÜ r r r r s s zASTPostfixCallExpr.__init__)rµ rW c C s
|| j S )N)rÜ )r rµ r r r r· v s z ASTPostfixCallExpr._stringifyr r| )r r r r~ rW c C s | j j|||| d S )N)rÜ r )r r r r r~ r r r r y s z%ASTPostfixCallExpr.describe_signature)rÚ rÛ )
r r r r r r) r r· r r r r r r rÙ r s rÙ c @ sB e Zd ZeddddZeedddZeedd dd
d d Z dS )
ÚASTPostfixArrayN)rÕ rW c C s
|| _ d S )N)rÕ )r rÕ r r r r s zASTPostfixArray.__init__)rµ rW c C s d|| j d S )Nú[ú])rÕ )r rµ r r r r· s zASTPostfixArray._stringifyr r| )r r r r~ rW c C s6 |t jdd7 }| jj|||| |t jdd7 }d S )NrÞ rß )r r¼ rÕ r )r r r r r~ r r r r
s z"ASTPostfixArray.describe_signature)
r r r r r r) r r· r r r r r r rÝ ~ s rÝ c @ s2 e Zd ZeedddZeedddddd ZdS )
Ú
ASTPostfixInc)rµ rW c C s dS )Nz++r )r rµ r r r r· s zASTPostfixInc._stringifyr r| N)r r r r~ rW c C s |t jdd7 }d S )Nz++)r Údesc_sig_operator)r r r r r~ r r r r s z ASTPostfixInc.describe_signature)r r r r) r r· r r r r r r rà s rà c @ s2 e Zd ZeedddZeedddddd ZdS )
Ú
ASTPostfixDec)rµ rW c C s dS )Nz--r )r rµ r r r r· s zASTPostfixDec._stringifyr r| N)r r r r~ rW c C s |t jdd7 }d S )Nz--)r rá )r r r r r~ r r r r s z ASTPostfixDec.describe_signature)r r r r) r r· r r r r r r râ s râ c @ s: e Zd Zdd ZeedddZeedddd d
d ZdS ) ÚASTPostfixMemberOfPointerc C s
|| _ d S )N)r )r r r r r r s z"ASTPostfixMemberOfPointer.__init__)rµ rW c C s d|| j S )Nz->)r )r rµ r r r r· ¢ s z$ASTPostfixMemberOfPointer._stringifyr r| N)r r r r~ rW c C s& |t jdd7 }| jj|d|| d S )Nz->r£ )r rá r r )r r r r r~ r r r r ¥ s z,ASTPostfixMemberOfPointer.describe_signature) r r r r r) r r· r r r r r r rã s rã c @ sF e Zd Zeee dddZeedddZ e
eddd d
d d Z d S )
ÚASTPostfixExpr)r Ú postFixesc C s || _ || _d S )N)r rå )r r rå r r r r ¬ s zASTPostfixExpr.__init__)rµ rW c C s4 || j g}x | jD ]}|j|| qW dj|S )Nr )r rå Úappendr³ )r rµ r¶ Úpr r r r· ° s zASTPostfixExpr._stringifyr r| N)r r r r~ rW c C s6 | j j|||| x | jD ]}|j|||| qW d S )N)r r rå )r r r r r~ rç r r r r ¶ s z!ASTPostfixExpr.describe_signature) r r r r r rØ r r) r r· r r r r r r rä « s rä c @ sB e Zd ZeedddZeedddZeeddd d
d d Z d S )
ÚASTUnaryOpExpr)ÚoprÕ c C s || _ || _d S )N)ré rÕ )r ré rÕ r r r r Á s zASTUnaryOpExpr.__init__)rµ rW c C s6 | j d dkr"| j d || j S | j || j S d S )Nr Úcnú )ré rÕ )r rµ r r r r· Å s zASTUnaryOpExpr._stringifyr r| N)r r r r~ rW c C sZ | j d dkr0|tj| j | j 7 }|tj 7 }n|tj| j | j 7 }| jj|||| d S )Nr rê )ré r rÈ Údesc_sig_spacerá rÕ r )r r r r r~ r r r r Ë s
z!ASTUnaryOpExpr.describe_signature)
r r r r r r r) r· r r r r r r rè À s rè c @ s: e Zd Zdd ZeedddZeedddd d
d ZdS ) Ú
ASTSizeofTypec C s
|| _ d S )N)Útyp)r rî r r r r Ö s zASTSizeofType.__init__)rµ rW c C s d|| j d S )Nzsizeof(r× )rî )r rµ r r r r· Ù s zASTSizeofType._stringifyr r| N)r r r r~ rW c C sF |t jdd7 }|t jdd7 }| jj|||| |t jdd7 }d S )NrZ rÖ r× )r rÈ r¼ rî r )r r r r r~ r r r r Ü s z ASTSizeofType.describe_signature) r r r r r) r r· r r r r r r rí Õ s rí c @ s@ e Zd ZedddZeedddZeeddd d
d d Z d S )
Ú
ASTSizeofExpr)rÕ c C s
|| _ d S )N)rÕ )r rÕ r r r r å s zASTSizeofExpr.__init__)rµ rW c C s d|| j S )Nzsizeof )rÕ )r rµ r r r r· è s zASTSizeofExpr._stringifyr r| N)r r r r~ rW c C s2 |t jdd7 }|t j 7 }| jj|||| d S )NrZ )r rÈ rì rÕ r )r r r r r~ r r r r ë s z ASTSizeofExpr.describe_signature)
r r r r r r) r r· r r r r r r rï ä s rï c @ s@ e Zd ZddddZeedddZeedd d
d d d
Zd
S )ÚASTAlignofExprrA )rî c C s
|| _ d S )N)rî )r rî r r r r ó s zASTAlignofExpr.__init__)rµ rW c C s d|| j d S )Nzalignof(r× )rî )r rµ r r r r· ö s zASTAlignofExpr._stringifyr r| N)r r r r~ rW c C sF |t jdd7 }|t jdd7 }| jj|||| |t jdd7 }d S )Nrd rÖ r× )r rÈ r¼ rî r )r r r r r~ r r r r ù s z!ASTAlignofExpr.describe_signature) r r r r r) r r· r r r r r r rð ò s rð c @ sB e Zd ZdedddZeedddZeedd d
d d d
Z d
S )Ú ASTCastExprrA )rî rÕ c C s || _ || _d S )N)rî rÕ )r rî rÕ r r r r s zASTCastExpr.__init__)rµ rW c C s: dg}|j || j |j d |j || j dj|S )NrÖ r× r )ræ rî rÕ r³ )r rµ r¶ r r r r· s
zASTCastExpr._stringifyr r| N)r r r r~ rW c C sH |t jdd7 }| jj|||| |t jdd7 }| jj|||| d S )NrÖ r× )r r¼ rî r rÕ )r r r r r~ r r r r s z ASTCastExpr.describe_signature)
r r r r r r) r r· r r r r r r rñ s rñ c @ sJ e Zd Zee ee dddZeedddZe eddd d
d d Z
d S )
Ú ASTBinOpExpr)ÚexprsÚopsc C s8 t |dkstt |t |d ks(t|| _|| _d S )Nr rz )r r ró rô )r ró rô r r r r s zASTBinOpExpr.__init__)rµ rW c C sx g }|j || jd xTtdt| jD ]@}|j d |j | j|d |j d |j || j| q*W dj|S )Nr rz rë r )ræ ró r» r rô r³ )r rµ r¶ r½ r r r r· s
zASTBinOpExpr._stringifyr r| N)r r r r~ rW c C sº | j d j|||| xtdt| j D ]}|tj 7 }| j|d }t|d tdkrt|d tdkr|tj||7 }n|tj ||7 }|tj 7 }| j | j|||| q(W d S )Nr rz ÚaÚz)
ró r r» r r rì rô rÏ rÈ rá )r r r r r~ r½ ré r r r r ) s ( z ASTBinOpExpr.describe_signature) r r r r r r r r) r· r r r r r r rò s
rò c @ sJ e Zd Zee ee dddZeedddZe eddd d
d d Z
d S )
ÚASTAssignmentExpr)ró rô c C s8 t |dkstt |t |d ks(t|| _|| _d S )Nr rz )r r ró rô )r ró rô r r r r 8 s zASTAssignmentExpr.__init__)rµ rW c C sx g }|j || jd xTtdt| jD ]@}|j d |j | j|d |j d |j || j| q*W dj|S )Nr rz rë r )ræ ró r» r rô r³ )r rµ r¶ r½ r r r r· > s
z ASTAssignmentExpr._stringifyr r| N)r r r r~ rW c C sº | j d j|||| xtdt| j D ]}|tj 7 }| j|d }t|d tdkrt|d tdkr|tj||7 }n|tj ||7 }|tj 7 }| j | j|||| q(W d S )Nr rz rõ rö )
ró r r» r r rì rô rÏ rÈ rá )r r r r r~ r½ ré r r r r H s ( z$ASTAssignmentExpr.describe_signature) r r r r r r r r) r· r r r r r r r÷ 7 s
r÷ c @ sP e Zd ZedddZeedddZeeddd Ze ed
d d d
ddZ
d S )ÚASTFallbackExpr)rÕ c C s
|| _ d S )N)rÕ )r rÕ r r r r W s zASTFallbackExpr.__init__)rµ rW c C s | j S )N)rÕ )r rµ r r r r· Z s zASTFallbackExpr._stringify)r® rW c C s
t | jS )N)r rÕ )r r® r r r r´ ] s zASTFallbackExpr.get_idr r| N)r r r r~ rW c C s |t j| j| j7 }d S )N)r
ÚliteralrÕ )r r r r r~ r r r r ` s z"ASTFallbackExpr.describe_signature) r r r r r r) r· rS r´ r r r r r r rø V s
rø c @ s e Zd ZdS )ÚASTTrailingTypeSpecN)r r r r r r r rú i s rú c @ sF e Zd Zee ddddZeedddZeedd dd
d d Z dS )
Ú ASTTrailingTypeSpecFundamentalN)r« rW c C s t |dkst|| _d S )Nr )r r r« )r r« r r r r n s z'ASTTrailingTypeSpecFundamental.__init__)rµ rW c C s dj | jS )Nrë )r³ r« )r rµ r r r r· r s z)ASTTrailingTypeSpecFundamental._stringifyr r| )r r r r~ rW c C s> d}x4| j D ]*}|s"|tj 7 }nd}|tj||7 }q W d S )NTF)r« r rì Zdesc_sig_keyword_type)r r r r r~ r¾ r± r r r r u s z1ASTTrailingTypeSpecFundamental.describe_signature)
r r r r r r r) r· r r r r r r rû m s rû c @ sV e Zd ZeeddddZeedddZeedd d
Z e
ed d dd
ddZ dS )ÚASTTrailingTypeSpecNameN)r Ú
nestedNamerW c C s || _ || _d S )N)r rý )r r rý r r r r s z ASTTrailingTypeSpecName.__init__)rW c C s | j S )N)rý )r r r r r
s z ASTTrailingTypeSpecName.name)rµ rW c C s: g }| j r |j| j |jd |j|| j dj|S )Nrë r )r ræ rý r³ )r rµ r¶ r r r r· s
z"ASTTrailingTypeSpecName._stringifyr r| )r r r r~ rW c C s> | j r&|tj| j | j 7 }|tj 7 }| jj||||d d S )N)r~ )r r rÈ rì rý r )r r r r r~ r r r r s z*ASTTrailingTypeSpecName.describe_signature) r r r r rª r rÁ r r) r· r r r r r r rü s rü c @ sZ e Zd ZddeddddZeededd d
Zeed d d
Z e
eddddddZ dS )ÚASTFunctionParameterFrB N)ÚargÚellipsisrW c C s || _ || _d S )N)rÿ r )r rÿ r r r r r s z ASTFunctionParameter.__init__r| )r® Ú
objectTyper~ rW c C s |j jj|ddS )NF)Úprefixed)Úparentr r´ )r r® r r~ r r r r´ s zASTFunctionParameter.get_id)rµ rW c C s | j r
dS || jS d S )Nz...)r rÿ )r rµ r r r r· ¢ s z ASTFunctionParameter._stringifyr )r r r r~ rW c C s8 t | | jr |tjdd7 }n| jj||||d d S )Nz...)r~ )r5 r r r¼ rÿ r )r r r r r~ r r r r ¨ s z'ASTFunctionParameter.describe_signature)F) r r r re r rS r r´ r) r· r r r r r r rþ s
rþ c @ sb e Zd Zee ee ddddZeee dddZe e
dd d
Z e e
d d dd
ddZ
dS )Ú
ASTParametersN)ÚargsÚattrsrW c C s || _ || _d S )N)r r )r r r r r r r ² s zASTParameters.__init__)rW c C s | j S )N)r )r r r r Úfunction_params¶ s z ASTParameters.function_params)rµ rW c C s~ g }|j d d}x.| jD ]$}|s,|j d d}|j t| qW |j d x&| jD ] }|j d |j || qTW dj|S )NrÖ Tz, Fr× rë r )ræ r r r r³ )r rµ r¶ r¾ rõ Úattrr r r r· º s
zASTParameters._stringifyr r| )r r r r~ rW c
C sð t | |dkr\tj }x8| jD ].}tjdddd}|j|d||d ||7 }q W ||7 }nj|tjdd7 }d}xD| jD ]:}|s|tjdd7 }|tj 7 }d }|j|d
||d qxW |tjd d 7 }x$| jD ]} |tj 7 }| j| qÎW d S ) Nr¢ r T)Únoemphr¸ )r~ rÖ ú,Fr r× ) r5 r Údesc_parameterlistr Údesc_parameterr r¼ rì r )
r r r r r~ Ú paramlistrÿ r¸ r¾ r r r r r É s(
z ASTParameters.describe_signature)r r r r rþ r# r rÁ r r) r r· r r r r r r r ± s r c @ s` e Zd Zeeeeeeee ddddZd d dddZe edd d
Z
ee dd d d
Z dS )ÚASTDeclSpecsSimpleN)ÚstorageÚ threadLocalrR rV ra rG r rW c C s. || _ || _|| _|| _|| _|| _|| _d S )N)r r rR rV ra rG r )r r r rR rV ra rG r r r r r å s zASTDeclSpecsSimple.__init__)r rW c C sT |s| S t | jp|j| jp |j| jp(|j| jp2|j| jp<|j| jpF|j| j|j S )N)r r r rR ra rG rV r )r r r r r Ú mergeWithï s
z ASTDeclSpecsSimple.mergeWith)rµ rW c s g }|j fdd| jD | jr0|j| j | jrB|j| j | jrR|jd | jrb|jd | jrr|jd | jr|jd dj |S )Nc 3 s | ]} |V qd S )Nr )r° r )rµ r r r² ü s z0ASTDeclSpecsSimple._stringify.<locals>.<genexpr>rR rV ra rG rë )
Úextendr r ræ r rR rV ra rG r³ )r rµ r¶ r )rµ r r· ú s
z ASTDeclSpecsSimple._stringify)Ú modifiersrW c C s¸ t t td ddd}x8| jD ].}t|dkr<|jtj |j|j| q W | j rb||| j | j
rt||| j
| j r||d | j r||d | j
r¤||d | jr´||d d S ) N)r r rW c S s0 t | dkr| jtj | jtj|| d S )Nr )r ræ r rì rÈ )r r r r r Ú_add s z3ASTDeclSpecsSimple.describe_signature.<locals>._addr rR rV ra rG )r r r r r ræ r rì r r r rR rV ra rG )r r r r r r r r s"
z%ASTDeclSpecsSimple.describe_signature)
r r r r re r r r r r) r· r r r r r r r ä s
r c @ sH e Zd ZeeeeddddZeedddZe edd dd
d d Z
dS )
Ú ASTDeclSpecsN)ÚouterÚ leftSpecsÚ
rightSpecsÚtrailingrW c C s, || _ || _|| _| jj| j| _|| _d S )N)r r r r ZallSpecsÚtrailingTypeSpec)r r r r r r r r r $ s
zASTDeclSpecs.__init__)rµ rW c C s g }|| j }t|dkr$|j| | jrt|dkr@|jd |j|| j t| j}t|dkrt|dkr||jd |j| dj|S )Nr rë r )r r ræ r r r r³ )r rµ r¶ ÚlÚrr r r r· 0 s
zASTDeclSpecs._stringifyr r| )r r r r~ rW c C s¢ t | g }| jj| x|D ] }||7 }q W | jrt|dkrL|tj 7 }| jj||||d g }| jj| t|dkr|tj 7 }x|D ] }||7 }qW d S )Nr )r~ )r5 r r r r r rì r )r r r r r~ r Úmr r r r @ s
z ASTDeclSpecs.describe_signature) r r r r r rú r r) r· r r r r r r r # s r c @ sJ e Zd ZeeeeeedddZeedddZe eddd d
d d Z
d S )
ÚASTArray)r[ rG ra rV ÚvlaÚsizec C sJ || _ || _|| _|| _|| _|| _|r4|d ks4t|d k rF| sFtd S )N)r[ rG ra rV r r r )r r[ rG ra rV r r r r r r Z s zASTArray.__init__)rµ rW c C s g }| j r|jd | jr$|jd | jr4|jd | jrD|jd | jr\ddj| d S | jrr|j|| j ddj| d S ) Nr[ rV ra rG rÞ rë z*]rß )r[ ræ rV ra rG r r³ r )r rµ Úelr r r r· g s
zASTArray._stringifyr r| N)r r r r~ rW c sÆ t | |tjdd7 }d tttd fdd }| jrB||d | jrR||d | jrb||d | j rr||d | j
r|tjd
d
7 }n(| j r² r |tj 7 }| j j
|d || |tjd d 7 }d S )
NrÞ F)r r rW c s$ r| t j 7 } | t j||7 } dS )NT)r rì rÈ )r r )ÚaddSpacer r r } s z)ASTArray.describe_signature.<locals>._addr[ rV ra rG rs r rß )r5 r r¼ r r re r[ rV ra rG r r rì r )r r r r r~ r r )r" r r w s&
zASTArray.describe_signature) r r r re r r r) r r· r r r r r r r Y s
r c @ sB e Zd ZeedddZeee dddZe dddZ
dS ) Ú
ASTDeclarator)rW c C s t t| d S )N)r r )r r r r r s zASTDeclarator.namec C s t t| d S )N)r r )r r r r r s z ASTDeclarator.function_paramsc C s t t| d S )N)r r )r r r r Ú require_space_after_declSpecs s z+ASTDeclarator.require_space_after_declSpecsN) r r r rÁ rª r r rþ r re r$ r r r r r# s
r# c @ s e Zd Zeee eddddZeedddZ eee
ddd Z e dd
d Z
eed d
dZeeddddddZdS )ÚASTDeclaratorNameParamN)ÚdeclIdÚarrayOpsr¸ rW c C s || _ || _|| _d S )N)r& r' r¸ )r r& r' r¸ r r r r ¢ s z ASTDeclaratorNameParam.__init__)rW c C s | j S )N)r& )r r r r r ¨ s zASTDeclaratorNameParam.namec C s | j jS )N)r¸ r )r r r r r ¬ s z&ASTDeclaratorNameParam.function_paramsc C s
| j d k S )N)r& )r r r r r$ ² s z4ASTDeclaratorNameParam.require_space_after_declSpecs)rµ rW c C sX g }| j r|j|| j x | jD ]}|j|| q"W | jrN|j|| j dj|S )Nr )r& ræ r' r¸ r³ )r rµ r¶ ré r r r r· µ s z!ASTDeclaratorNameParam._stringifyr r| )r r r r~ rW c C s\ t | | jr | jj|||| x | jD ]}|j|||| q(W | jrX| jj|||| d S )N)r5 r& r r' r¸ )r r r r r~ ré r r r r ¿ s z)ASTDeclaratorNameParam.describe_signature)r r r rª r r r r rÁ r rþ r re r$ r) r r· r r r r r r r% ¡ s
r% c @ sb e Zd ZeedddZeedddZedddZ e
e d d
d Z e
e d d
ddddZdS )ÚASTDeclaratorNameBitField)r& r c C s || _ || _d S )N)r& r )r r& r r r r r Ë s z"ASTDeclaratorNameBitField.__init__)rW c C s | j S )N)r& )r r r r r Ï s z ASTDeclaratorNameBitField.namec C s
| j d k S )N)r& )r r r r r$ Õ s z7ASTDeclaratorNameBitField.require_space_after_declSpecs)rµ rW c C s> g }| j r|j|| j |jd |j|| j dj|S )Nz : r )r& ræ r r³ )r rµ r¶ r r r r· Ø s
z$ASTDeclaratorNameBitField._stringifyr r| N)r r r r~ rW c C s^ t | | jr | jj|||| |tj 7 }|tjdd7 }|tj 7 }| jj|||| d S )Nú:)r5 r& r r rì r¼ r )r r r r r~ r r r r à s z,ASTDeclaratorNameBitField.describe_signature)r r r rª r r rÁ r re r$ r) r r· r r r r r r r( Ê s r( c @ s e Zd ZeeeeeddddZeedddZ ee
e ddd Z edd
d Z
eed d
dZeeddddddZdS )ÚASTDeclaratorPtrN)ÚnextrV ra rG r rW c C s* |st || _|| _|| _|| _|| _d S )N)r r+ rV ra rG r )r r+ rV ra rG r r r r r ì s zASTDeclaratorPtr.__init__)rW c C s | j jS )N)r+ r )r r r r r õ s zASTDeclaratorPtr.namec C s | j jS )N)r+ r )r r r r r ù s z ASTDeclaratorPtr.function_paramsc C s* | j p(| jp(| jp(t| jdkp(| jj S )Nr )rG ra rV r r r+ r$ )r r r r r$ ý s z.ASTDeclaratorPtr.require_space_after_declSpecs)rµ rW c C sò dg}x | j D ]}|j|| qW t| j dkrN| jsD| jsD| jrN|jd | jr^|jd | jr~| jrt|jd |jd | jr¤| js| jr|jd |jd | jsÄ| jsÄ| jsÄt| j dkrØ| jj rØ|jd |j|| j dj|S )Nrs r rë rV ra rG r ) r ræ r rV ra rG r+ r$ r³ )r rµ r¶ rõ r r r r· s(
zASTDeclaratorPtr._stringifyr r| )r r r r~ rW c C s t | |tjdd7 }x| jD ]}|j| q W t| jdkr^| jsR| jsR| jr^|tj 7 }t
t d ddd}| jr||d | jr¢| jr|tj 7 }||d | jrÊ| js´| jrÀ|tj 7 }||d | jsì| jsì| jsìt| jdkr| j j
r|tj 7 }| j j|||| d S ) Nrs r )r r rW c S s | t j||7 } d S )N)r rÈ )r r r r r Ú _add_anno! s z6ASTDeclaratorPtr.describe_signature.<locals>._add_annorV ra rG )r5 r r¼ r r r rV ra rG rì r r r+ r$ )r r r r r~ rõ r, r r r r s*
" z#ASTDeclaratorPtr.describe_signature)r r r r# re r r rÁ rª r r rþ r r$ r) r r· r r r r r r r* ë s r* c @ sz e Zd ZeeddddZeedddZeee ddd Z
e dd
d Z e
ed d
dZeeddddddZdS )ÚASTDeclaratorParenN)Úinnerr+ rW c C s |st |st || _|| _d S )N)r r. r+ )r r. r+ r r r r 5 s zASTDeclaratorParen.__init__)rW c C s | j jS )N)r. r )r r r r r < s zASTDeclaratorParen.namec C s | j jS )N)r. r )r r r r r @ s z"ASTDeclaratorParen.function_paramsc C s dS )NTr )r r r r r$ D s z0ASTDeclaratorParen.require_space_after_declSpecs)rµ rW c C s: dg}|j || j |j d |j || j dj|S )NrÖ r× r )ræ r. r+ r³ )r rµ r¶ r r r r· G s
z ASTDeclaratorParen._stringifyr r| )r r r r~ rW c C sP t | |tjdd7 }| jj|||| |tjdd7 }| jj|d|| d S )NrÖ r× r£ )r5 r r¼ r. r r+ )r r r r r~ r r r r N s
z%ASTDeclaratorParen.describe_signature)r r r r# r rÁ rª r r rþ r re r$ r) r r· r r r r r r r- 4 s r- c @ sF e Zd Zee ddddZeedddZe edd dd
d d Z
dS )
rÚ N)ró rW c C s
|| _ d S )N)ró )r ró r r r r [ s zASTParenExprList.__init__)rµ rW c s" fdd| j D }ddj| S )Nc s g | ] } |qS r r )r° Úe)rµ r r ú
<listcomp>_ s z/ASTParenExprList._stringify.<locals>.<listcomp>z(%s)z, )ró r³ )r rµ ró r )rµ r r· ^ s zASTParenExprList._stringifyr r| )r r r r~ rW c C sv t | |tjdd7 }d}xD| jD ]:}|sJ|tjdd7 }|tj 7 }nd}|j|||| q$W |tjdd7 }d S )NrÖ Tr
Fr× )r5 r r¼ ró rì r )r r r r r~ r¾ r/ r r r r b s z#ASTParenExprList.describe_signature) r r r r r r r) r r· r r r r r r rÚ Z s rÚ c @ sH e Zd Zee eddddZeedddZ e
edd dd
d d Z dS )
rÛ N)ró Ú
trailingCommarW c C s || _ || _d S )N)ró r1 )r ró r1 r r r r r s zASTBracedInitList.__init__)rµ rW c s4 fdd| j D }| jr dnd}ddj||f S )Nc s g | ] } |qS r r )r° r/ )rµ r r r0 w s z0ASTBracedInitList._stringify.<locals>.<listcomp>r
r z{%s%s}z, )ró r1 r³ )r rµ ró r1 r )rµ r r· v s z ASTBracedInitList._stringifyr r| )r r r r~ rW c C s t | |tjdd7 }d}xD| jD ]:}|sJ|tjdd7 }|tj 7 }nd}|j|||| q$W | jrx|tjdd7 }|tjdd7 }d S )NÚ{Tr
FÚ})r5 r r¼ ró rì r r1 )r r r r r~ r¾ r/ r r r r { s z$ASTBracedInitList.describe_signature) r r r r r re r r) r r· r r r r r r rÛ q s rÛ c @ sN e Zd Zdeeef eddddZee dddZ
e e d d
dd d d
Z dS )ÚASTInitializerTN)rÅ Ú hasAssignrW c C s || _ || _d S )N)rÅ r5 )r rÅ r5 r r r r s zASTInitializer.__init__)rµ rW c C s || j }| jrd| S |S d S )Nz = )rÅ r5 )r rµ Úvalr r r r· s
zASTInitializer._stringifyr r| )r r r r~ rW c C sL t | | jr6|tj 7 }|tjdd7 }|tj 7 }| jj|d|| d S )Nry r )r5 r5 r rì r¼ rÅ r )r r r r r~ r r r r s z!ASTInitializer.describe_signature)T)
r r r r rÛ r re r r) r r· r r r r r r r4 s r4 c @ s e Zd ZeeddddZeedddZe e
de
d d
d Z ee e
dd d
Zee
dddZe
dddZee
ddddddZdS )rA N)Ú declSpecsÚdeclrW c C s |st |st || _|| _d S )N)r r7 r8 )r r7 r8 r r r r ¤ s zASTType.__init__)rW c C s | j jS )N)r8 r )r r r r r ª s z ASTType.namer| )r® r r~ rW c C s |j j|S )N)Úget_full_nested_namer´ )r r® r r~ r r r r´ ® s zASTType.get_idc C s | j jS )N)r8 r )r r r r r ± s zASTType.function_params)rµ rW c C sR g }|| j }|j| | jj r8t|dkr8|jd |j|| j dj|S )Nr rë r )r7 ræ r8 r$ r r³ )r rµ r¶ r7 r r r r· µ s
zASTType._stringifyc C s | j jr dS dS d S )Nr^ r )r7 r )r r r r Úget_type_declaration_prefix¾ s z#ASTType.get_type_declaration_prefixr )r r r r~ rW c C sd t | | jj|d|| | jj rBtt| jdkrB|tj 7 }|dkrNd}| jj|||| d S )Nr r r£ ) r5 r7 r r8 r$ r r r rì )r r r r r~ r r r r Ä s
zASTType.describe_signature)r r r r r# r rÁ rª r rS r r´ r rþ r r) r· r: r r r r r r rA £ s c @ sj e Zd ZeeddddZeedddZe e
de
d d
d Z e e
d d
dZ
ee
ddddddZdS )rB N)r ÚinitrW c C s || _ || _d S )N)r r; )r r r; r r r r Ó s zASTTypeWithInit.__init__)rW c C s | j jS )N)r r )r r r r r × s zASTTypeWithInit.namer| )r® r r~ rW c C s | j j|||S )N)r r´ )r r® r r~ r r r r´ Û s zASTTypeWithInit.get_id)rµ rW c C s4 g }|j || j | jr*|j || j dj|S )Nr )ræ r r; r³ )r rµ r¶ r r r r· Þ s
zASTTypeWithInit._stringifyr )r r r r~ rW c C s6 t | | jj|||| | jr2| jj|||| d S )N)r5 r r r; )r r r r r~ r r r r å s z"ASTTypeWithInit.describe_signature)r r r rA r4 r rÁ rª r rS r r´ r) r· r r r r r r rB Ò s c @ sH e Zd ZdeeeddddZeedddZe ed d
dd d d
Z
dS )ÚASTMacroParameterFN)rÿ r ÚvariadicrW c C s || _ || _|| _d S )N)rÿ r r= )r rÿ r r= r r r r î s zASTMacroParameter.__init__)rµ rW c C s, | j r
dS | jr || jd S || jS d S )Nz...)r r= rÿ )r rµ r r r r· ô s
z ASTMacroParameter._stringifyr r| )r r r r~ rW c C sX t | | jr |tjdd7 }n4| jr@t| }|tj||7 }n| jj||||d d S )Nz...)r~ ) r5 r r r¼ r= r r¤ rÿ r )r r r r r~ r r r r r ü s z$ASTMacroParameter.describe_signature)FF) r r r rª re r r) r r· r r r r r r r< í s
r< c @ sn e Zd Zeee ddddZeedddZe e
de
d d
d Z e e
d d
dZ
ee
ddddddZdS )rC N)rÀ r rW c C s || _ || _d S )N)rÀ r )r rÀ r r r r r s zASTMacro.__init__)rW c C s | j S )N)rÀ )r r r r r
s z
ASTMacro.namer| )r® r r~ rW c C s |j j|S )N)r9 r´ )r r® r r~ r r r r´ s zASTMacro.get_id)rµ rW c C sp g }|j || j | jd k rf|j d d}x.| jD ]$}|sF|j d d}|j || q4W |j d dj|S )NrÖ Tz, Fr× r )ræ rÀ r r³ )r rµ r¶ r¾ rÿ r r r r· s
zASTMacro._stringifyr )r r r r~ rW c C sv t | | jj|||| | jd kr(d S tj }x8| jD ].}tjdddd}|j|d||d ||7 }q8W ||7 }d S )Nr T)r r¸ )r~ )r5 rÀ r r r r r )r r r r r~ r
rÿ r¸ r r r r " s
zASTMacro.describe_signature)r r r rª r r< r rÁ r rS r r´ r) r· r r r r r r rC s c @ sV e Zd ZeddddZeededddZeed d
d Z e
ed ddd
ddZ dS )r= N)r rW c C s
|| _ d S )N)r )r r r r r r 1 s zASTStruct.__init__r| )r® r r~ rW c C s |j j|S )N)r9 r´ )r r® r r~ r r r r´ 4 s zASTStruct.get_id)rµ rW c C s
|| j S )N)r )r rµ r r r r· 7 s zASTStruct._stringifyr )r r r r~ rW c C s t | | jj||||d d S )N)r~ )r5 r r )r r r r r~ r r r r : s z ASTStruct.describe_signature) r r r rª r rS r r´ r) r· r r r r r r r= 0 s
c @ sV e Zd ZeddddZeededddZeed d
d Z e
ed ddd
ddZ dS )r> N)r rW c C s
|| _ d S )N)r )r r r r r r A s zASTUnion.__init__r| )r® r r~ rW c C s |j j|S )N)r9 r´ )r r® r r~ r r r r´ D s zASTUnion.get_id)rµ rW c C s
|| j S )N)r )r rµ r r r r· G s zASTUnion._stringifyr )r r r r~ rW c C s t | | jj||||d d S )N)r~ )r5 r r )r r r r r~ r r r r J s zASTUnion.describe_signature) r r r rª r rS r r´ r) r· r r r r r r r> @ s
c @ sV e Zd ZeddddZeededddZeed d
d Z e
ed ddd
ddZ dS )r? N)r rW c C s
|| _ d S )N)r )r r r r r r Q s zASTEnum.__init__r| )r® r r~ rW c C s |j j|S )N)r9 r´ )r r® r r~ r r r r´ T s zASTEnum.get_id)rµ rW c C s
|| j S )N)r )r rµ r r r r· W s zASTEnum._stringifyr )r r r r~ rW c C s t | | jj||||d d S )N)r~ )r5 r r )r r r r r~ r r r r Z s zASTEnum.describe_signature) r r r rª r rS r r´ r) r· r r r r r r r? P s
c @ sX e Zd ZeeddddZeededddZe ed d
d Z
e ed ddd
ddZ dS )r@ N)r r; rW c C s || _ || _d S )N)r r; )r r r; r r r r a s zASTEnumerator.__init__r| )r® r r~ rW c C s |j j|S )N)r9 r´ )r r® r r~ r r r r´ e s zASTEnumerator.get_id)rµ rW c C s4 g }|j || j | jr*|j || j dj|S )Nr )ræ r r; r³ )r rµ r¶ r r r r· h s
zASTEnumerator._stringifyr )r r r r~ rW c C s6 t | | jj|||| | jr2| jj|d|| d S )Nr )r5 r r r; )r r r r r~ r r r r o s z ASTEnumerator.describe_signature)
r r r rª r4 r rS r r´ r) r· r r r r r r r@ ` s
c @ sª e Zd Zdeeeeef eddddZd dddZ e
e dd d
Z e
e
e dd d ZdeeedddZedddZeedddZeededdddZdS ) r} FN)r Ú
directiveTyper Ú semicolonrW c C s( || _ || _|| _|| _d | _d | _d S )N)r r> r r? r~ ÚenumeratorScopedSymbol)r r r> r r? r r r r x s zASTDeclaration.__init__)rW c C s t | j| j| jj | jS )N)r} r r> r Úcloner? )r r r r rA s
zASTDeclaration.clonec C s t t| j}|jS )N)r ÚDeclarationTyper r )r r8 r r r r s zASTDeclaration.namec C s | j dkrd S tt| j}|jS )NÚfunction)r r rA r r )r r8 r r r r s
z ASTDeclaration.function_paramsT)r® r rW c C sL | j dkr | jr | jjj||S | jj|| j | j}|rDt| | S |S d S )NÚ
enumerator)r r@ r r´ r~ Ú
_id_prefix)r r® r Úid_r r r r´ s zASTDeclaration.get_idc C s | j tdS )NT)r´ Ú_max_id)r r r r Ú
get_newest_id s z ASTDeclaration.get_newest_id)rµ rW c C s || j }| jr|d7 }|S )Nú;)r r? )r rµ r¶ r r r r· s
zASTDeclaration._stringifyr )r r r ÚoptionsrW c C s~ t | | jstd|d< tj }d|_| jj |d< ||7 }| jdkrLn| jdkrXnö| jdkrdnê| jdkr|tjdd7 }|tj 7 }nÂ| jd kr´|tjd d 7 }|tj 7 }n| jd
krÜ|tjd
d
7 }|tj 7 }nr| jd kr|tjd d 7 }|tj 7 }nH| jd krDt
t | j }|j
}|tj||7 }|tj 7 }n
d
sNt| j j|||| j | jrz|tjdd7 }d S )NTZ is_multilineZ
declaratorZ
add_permalinkÚmemberrC Úmacror\ r_ rL rD r FrI )r5 r~ r r Zdesc_signature_lineZsphinx_line_typeÚisRedeclarationr rÈ rì r rA r r: r r? r¼ )r r r r rJ Z mainDeclNoder8 r r r r r ¦ sD
z!ASTDeclaration.describe_signature)F)T)r r r r r rB rþ re r rA rÁ rª r r r rS r´ rH r) r· r r r r r r r r} w s
r} c @ s$ e Zd Zed deddddZdS )ÚSymbolLookupResultr| N)ÚsymbolsÚ parentSymbolrÀ rW c C s || _ || _|| _d S )N)rO rP rÀ )r rO rP rÀ r r r r Ò s zSymbolLookupResult.__init__)r r r r r r r r r r rN Ñ s rN c @ s6 e Zd Zeeeef ddddZedddZdS )Ú LookupKeyN)rË rW c C s
|| _ d S )N)rË )r rË r r r r Ú s zLookupKey.__init__)rW c C s dj djdd | jD S )Nz[{}]z, c s s | ]\}}d j ||V qdS )z({}, {})N)Úformat)r° rÀ rF r r r r² Þ s z$LookupKey.__str__.<locals>.<genexpr>)rR r³ rË )r r r r r Ý s zLookupKey.__str__) r r r r r r r r r r r r r rQ Ù s rQ c s e Zd ZdZdZdZdZdd Zdd Ze e
dd d
d Z dd d
dZ e
e
dd fdd Zd eee
eddddZee
eddddZdd ddZdd ddZe
dd d d Zed d d d Zeed d d!d"Zeed d d#d$Zd%d d&d'Z e d d(d)Z ee e d d*d+d,Z ee e e ed d-d.d/Z!e e"d egd f e
e e e e#d0d1d2Z$e ee
ed d3d4d5Z%d e&e
d6dd7d8d9Z'e d d:d;d<Z(ee
ed dd=d>Z)ee e e d d-d?d@Z*d%d dAdBdCZ+e e
e e d dDdEdFZ,ee
dGdHdIZ-ee
dGdJdKZ. Z/S )Lr| r z Fc C s dst d S )NF)r )r r r r Ú__copy__è s zSymbol.__copy__c C s$ | j rds tntd d d d d S d S )NF)r r r| )r Úmemor r r Ú __deepcopy__ë s
zSymbol.__deepcopy__N)r rW c G s t tjtj dd t | d S )Nr )Úend)Úprintr| Údebug_indent_stringÚ debug_indent)r r r r Ú debug_printò s zSymbol.debug_print)rW c C s4 | j s | j st| j s0tn| jr0| js0td S )N)r r r Údocname)r r r r Ú_assert_invariants÷ s
zSymbol._assert_invariants)ÚkeyrÅ rW c s$ |dkrds t nt j||S d S )NÚchildrenF)r ÚsuperÚ __setattr__)r r] rÅ )Ú __class__r r r` s
zSymbol.__setattr__)r rÀ r r[ ÚlinerW c C sr || _ d | _d | _|| _|| _|| _|| _d| _| j g | _ g | _
| j rX| j j j | | jrf| | j_ | j
d S )NF)r Ú siblingAboveÚ siblingBelowrÀ r r[ rb rM r\ Ú _childrenZ
_anonChildrenræ r~ Ú_add_function_params)r r rÀ r r[ rb r r r r s zSymbol.__init__)r r[ rb rW c C s | j | jd kst| jd ks$t| jd ks2t|d k s>t|d k sJt|d k sVt|| _| | j_|| _|| _| j | j d S )N)r\ r r r[ rb r~ rf )r r r[ rb r r r Ú _fill_empty s zSymbol._fill_emptyc C sº t jr t jd7 _t jd | jd k r¢| jjd k r¢xl| jjD ]`}|jd krNq>|jj}|d kr`q>tdd |}|j sxt
t |j dkst
| j
||| j| j q>W t jr¶t jd8 _d S )Nrz z_add_function_params:Ú
functionParam)r| Ú debug_lookuprY rZ r r rÿ r r} r¬ r r r« Ú _add_symbolsr[ rb )r rç Únnr8 r r r rf / s
zSymbol._add_function_paramsc C s6 | j d krd S | | j jks t| j jj| d | _ d S )N)r re r Úremove)r r r r rl F s
z
Symbol.remove)r[ rW c C st xn| j D ]d}|j| |jr|j|krd |_d |_d |_|jd k rL|j|j_|jd k r`|j|j_d |_d |_qW d S )N)re Ú clear_docr r[ rb rc rd )r r[ ÚsChildr r r rm M s
zSymbol.clear_docc c s( | V x | j D ]}|j E d H qW d S )N)re Úget_all_symbols)r rn r r r ro [ s zSymbol.get_all_symbolsc c s | j E d H d S )N)re )r r r r r^ ` s zSymbol.childrenc c s2 x,| j D ]"}|V |jj s q|jE d H qW d S )N)re rÀ r Úchildren_recurse_anon)r r r r r rp d s
z Symbol.children_recurse_anonrQ c C sx g }| }x|j r"|j| |j }q
W |j g }x>|D ]6}|jd k r\|j|j|jj f q6|j|jd f q6W t|S )N)r ræ Úreverser rÀ rH rQ )r rO Úsr] r r r r¥ l s
zSymbol.get_lookup_keyc C sV g }| }x|j r"|j| |j }q
W |j g }x|D ]}|j|j q6W t|ddS )NF)r¬ )r ræ rq rÀ rª )r rO rr r« r r r r9 s
zSymbol.get_full_nested_name)rÀ Ú matchSelfÚ
recurseInAnonrW c C sD t jrt jd | j|||dd}yt|S tk
r> d S X d S )Nz_find_first_named_symbol ->F)ÚsearchInSiblings)r| ri rZ Ú_find_named_symbolsr+ Ú
StopIteration)r rÀ rs rt r¶ r r r Ú_find_first_named_symbol s
z Symbol._find_first_named_symbol)rÀ rs rt ru rW c # s< t jr~t jd7 _t jd t jd7 _t jd tjt jd dd t jd| t jd t jd t jd | td d fd d
}x| D ]~}t jrÌt jd t|jt jd dd |j|kr t jrt jd7 _t jd t jd8 _|V t jr t jd7 _q W t jr8t jd8 _d S )Nrz z_find_named_symbols:zself:r )rV zident: zmatchSelf: zrecurseInAnon: zsearchInSiblings: r| )rW c 3 s } t jr,t jd t| jt jd dd xf r8| V rJ| jE d H n | jE d H | jd krbP | j} t jr.t jd t| jt jd dd q.W d S )Nzsearching in self:rz r )rV zsearching in sibling:) r| ri rZ rW Ú to_stringrY rp re rc )rr )rs rt r r r Ú
candidates§ s
z.Symbol._find_named_symbols.<locals>.candidatesz
candidate:Úmatchesé é )r| NN)r| ri rY rZ rW ry r rÀ )r rÀ rs rt ru rz rr r )rs rt r r rv s2
zSymbol._find_named_symbols)rý ÚonMissingQualifiedSymbolÚancestorLookupTypers rt ru rW c
C sâ t jrt jd7 _t jd t jd7 _t jd t| jt jd dd t jd| t jd| t jd| t jd | t jd
| |j}| }|jr¬x|jrª|j}qW |d k râ|d } x$|jrà|j | |||d rØP |j}q¾W t jr t jd
t|jt jd dd xf|d d
D ]V}
|j
|
||d} | d krf|||
} | d krft jrbt jd8 _d S d}| }qW t jrt jd t|jt jd dd |d }
|j |
|||d } t jrÖt | } t jd8 _t
| ||
S )Nrz z_symbol_lookup:zself:r )rV znestedName: zancestorLookupType:zmatchSelf: zrecurseInAnon: zsearchInSiblings: r )rs rt ru zstarting point:)rs rt r} Fzhandle last name from:rº rº )r| ri rY rZ rW ry r« r¬ r Úfind_identifierrx rv ÚlistrN )
r rý r~ r rs rt ru r« rP Z firstNamerÀ r~ rO r r r Ú_symbol_lookupÊ sf
zSymbol._symbol_lookup)rý r r[ rb rW c s t jrVt jd7 _t jd t jd7 _t jd| t jd t jdj dtdddd }| j||d d
d
d
d d k sttj }t
|d kr*t jrút jd
t jd7 _t jdj t jd t jdj t jd8 _t j j d}t jr&t jd8 _|S t jrht jd t jd7 _t jdt
| t jd8 _ st jrt jd t jd8 _|d S g }g } g }
xD|D ]<} | j
d krÄ|j| n | jrØ|
j| n
| j| q¨W t jr t jdt
| t jdt
| t jdt
|
dd fdd } t
| d krLd }
n¦| }
ddd d fd d } jd krt
| dkst|| d |
j }t jr°t jd | x@| D ]8}|j
j }t jrØt jd!| ||kr¶|||
q¶W t
|d kr<t jr&t jd"|
d k t jd8 _|
d k r4|
S | S nRt jrbt jd#|
d k t jd8 _|
d k rt|
j |d }|j |S d S )$Nrz z
_add_symbols:z
nn: z
decl: zlocation: {}:{}r| )rP rÀ rW c S sX t jrFt jd7 _t jd t jd7 _t jd| t jd8 _t | |d d d dS )Nrz z'_add_symbols, onMissingQualifiedSymbol:zident: r} )r rÀ r r[ rb )r| ri rY rZ )rP rÀ r r r r~ s
z5Symbol._add_symbols.<locals>.onMissingQualifiedSymbolF)r rs rt ru r z _add_symbols, result, no symbol:z
ident: z
declaration: zlocation: {}:{})r rÀ r r[ rb r} z _add_symbols, result, symbols:znumber symbols:zno declarationz
#noDecl: z
#withDecl:z
#dupDecl: )rW c s: t jrt jd t jj d} t jr6t jd | S )Nz begin: creating candidate symbol)r rÀ r r[ rb z end: creating candidate symbol)r| ri rZ rP rÀ )r~ )r r[ rb Ú lookupResultr r ÚmakeCandSymbolg s
z+Symbol._add_symbols.<locals>.makeCandSymbol)r~ Ú
candSymbolrW c sN t jr:t jd7 _t jd t jd8 _t jd8 _d|_t| d S )Nrz Z
redeclarationr} T)r| ri rY rZ rM r{ )r~ r
)r r r ÚhandleDuplicateDeclarationw s
z7Symbol._add_symbols.<locals>.handleDuplicateDeclarationrC zcandId:zoldId: z,no match, no empty, candSybmol is not None?:zAno match, but fill an empty declaration, candSybmol is not None?:)r| ri rY rZ rR r r r r rO r rÀ rP r ræ rM r rH rl rg )r rý r r[ rb r~ rO r~ ZnoDeclZwithDeclZdupDeclrr r r
r ZcandIdZoldIdr )r r[ rb r r rj s°
zSymbol._add_symbolsr )r Údocnamesr rW c C s t jr t jd7 _t jd |d k s*txÌ|jD ]Â}| j|jddd}|d krl| jj| | |_ |j
q2|j ræ|j |kræ|j s|j
|j |j |j nN|j |j kræt|j }td}||j |j|j j|f }tj||j |jfd n |j||| q2W t jrt jd8 _d S )Nrz z merge_with:F)rÀ rs rt zNDuplicate C declaration, also defined at %s:%s.
Declaration is '.. c:%s:: %s'.)Úlocation)r| ri rY rZ r re rx rÀ ræ r r\ r r[ rg rb r r r> ÚloggerÚwarningÚ
merge_with)r r r r Z
otherChildZourChildr Úmsgr r r r ² s4
zSymbol.merge_with)rý rW c C sH t jr t jd7 _t jd | j|d d d d}t jrDt jd8 _|S )Nrz z add_name:)r r[ rb )r| ri rY rZ rj )r rý r¶ r r r Úadd_nameÖ s
zSymbol.add_namec C sp t jr t jd7 _t jd |d k s*t|d k s6t|d k sBt|j}| j||||}t jrlt jd8 _|S )Nrz zadd_declaration:)r| ri rY rZ r r rj )r r r[ rb rý r¶ r r r Úadd_declarationß s
zSymbol.add_declarationc C s* t jrt jd7 _t jd t jd7 _t jd| t jd| t jd| t jd| t| jt jd dd t jd 8 _| }x|d k r$t jrÖt jd 7 _t jd
t|jt jd dd t jd 8 _|rè|j|krè|S |rò|jn|j}x|D ]}|j|krþ|S qþW |s P |j }qW d S ) Nrz zfind_identifier:zident: zmatchSelf: zrecurseInAnon: zsearchInSiblings:r )rV r} ztrying:)
r| ri rY rZ rW ry rÀ rp re rc )r rÀ rs rt ru Úcurrentr^ rr r r r r í s6
zSymbol.find_identifier)r] rW c C sî t jr,t jd7 _t jd t jd7 _| }x¤|jD ]\}}d }x |jD ]}|j|krL|}P qLW |}t jr²t jd| t jd| |d k r¨t|jt jd dd n
t jd |d kr8t jrÎt jd8 _d S q8W t jrêt jd8 _|S ) Nrz zdirect_lookup:zname: zid: r )rV z not foundr} ) r| ri rY rZ rË re rÀ rW ry )r r] rr r rF r¶ Zcandr r r Ú
direct_lookup s2
zSymbol.direct_lookup)rý rî rs rt rW c C s t jr t jd7 _t jd dtdddd}| j|||||dd}t jrZt jd8 _|d krfd S t|j}t|d krd S |d S )
Nrz zfind_declaration:r| )rP rÀ rW c S s d S )Nr )rP rÀ r r r r~ / s z9Symbol.find_declaration.<locals>.onMissingQualifiedSymbolF)r rs rt ru r ) r| ri rY rZ r r r rO r )r rý rî rs rt r~ r rO r r r Úfind_declaration( s&
zSymbol.find_declaration)ÚindentrW c C s° t j| g}| js |jd nX| jr6|jt| j n|jt| j | jrv|jd | jrf|jd |jt| j | jr|jd |j| j |jd |jd dj |S )Nz::z: z!!duplicate!! z (r× Ú
r )
r| rX r ræ rÀ r r rM r[ r³ )r r r¶ r r r ry C s"
zSymbol.to_stringc C s: | j |g}x"| jD ]}|j|j|d qW dj|S )Nrz r )ry re ræ r
r³ )r r r¶ r r r r r
X s z Symbol.dump)0r r r rY rX ri Údebug_show_treerS rU Ú staticmethodr rZ r\ r r` r r} rS r rg rf rl rm r ro rÁ r^ rp r¥ rª r9 re rx rv r rN r rj r r r r r r r ry r
Ú
__classcell__r r )ra r r| â s` 0E #
r| c @ sÌ e Zd ZeedddZedd Zedd Zeddd Ze dd
d Z
e dd d
Z e dddZ
eeeeee ef dddZedddZedddZedddZe dddZe ddd Ze dd d Zee d d d!Z e dd"d#Z e dd$d%Z e dd&d'Z d_ee e g e f ee d)d*d+Z!e"dd,d-Z#e$e dd.d/Z%e&dd0d1Z'e(dd2d3Z)ee*d4d5d6Z+eee,d7d8d9Z-d`eee.d7d:d;Z/e0eef eee1d<d=d>Z2dae0eef eee1d<d?d@Z3dbeee4dBdCdDZ5dce0eef ee6dEdFdGZ7e0eef ee8dEdHdIZ9e:ddJdKZ;e<ddLdMZ=e>ddNdOZ?e@ddPdQZAeBddRdSZCeDddTdUZEeeeDdVdWdXZFe"ddYdZZGe"dd[d\ZHe0e e6f dd]d^ZIdAS )dÚDefinitionParser)rW c C s dS )NÚCr )r r r r Úlanguage` s zDefinitionParser.languagec C s | j jS )N)ÚconfigÚc_id_attributes)r r r r Ú
id_attributesd s z DefinitionParser.id_attributesc C s | j jS )N)r Úc_paren_attributes)r r r r Úparen_attributesh s z!DefinitionParser.paren_attributesc C s | j dkrd S | j}| jd7 _d}xZ| jr:| jd n6| j dkr\| r\| jd7 _P n| j dkrld}nd}| jd7 _q(W | j|| j
S )Nú"rz Fz$Unexpected end during inside string.ú\T)Ú current_charÚposÚeofÚfailÚ
definition)r ÚstartPosÚescaper r r Ú
_parse_stringl s
z DefinitionParser._parse_stringc C s4 | j | jdrtdS | jdr,tdS | j}| jtrZ| jt t| j|| j
S x<t t
t t gD ],}| j|rh| jt
t| j|| j
S qhW | j }|d k r°t|S | jtr0| jjd}| jjd}y
t||S tk
r } z| jd| W Y d d }~X n tk
r. | jd Y nX d S ) NrÆ TrÇ Frz r} z8Can not handle character literal. Internal error was: %szJCan not handle character literal resulting in multiple decoded characters.)Úskip_wsÚ skip_wordrÄ r¢ Úmatchr. r/ rÊ r¥ r, r0 r2 r4 r3 r¨ rÒ r- Z
last_matchÚgrouprÌ ÚUnicodeDecodeErrorr¤ r* )r r¢ ÚregexÚstringr rË r/ r r r Ú_parse_literal s6
z DefinitionParser._parse_literalc C sH | j dkrd S | jd7 _| j }| j | jds@| jd t|S )NrÖ rz r× z0Expected ')' in end of parenthesized expression.)r¡ r¢ Ú_parse_expressionr© Ú skip_stringr¤ rÔ )r r¶ r r r Ú_parse_paren_expression¥ s
z(DefinitionParser._parse_paren_expressionc C sL | j | j }|d k r |S | j }|d k r0|S | j }|d k rHt|S d S )N)r© r° r³ Ú_parse_nested_namerÓ )r r¶ rk r r r Ú_parse_primary_expression° s z*DefinitionParser._parse_primary_expression)r ÚopenÚcloserW c C s¶ | j | j|sdS | j|r(g dfS g }d}x|| j | j }| j |j| | j | j|rhP | jds| jd||f | j|kr2|dkr2| jd7 _d}P q2W ||fS )NFr
z"Error in %s, expected ',' or '%s'.r3 rz T)NN)r© Úskip_string_and_wsr² r± ræ r¤ r¡ r¢ )r r r¶ r· ró r1 rÕ r r r Ú_parse_initializer_listÀ s,
z(DefinitionParser._parse_initializer_listc C s& | j ddd\}}|d kr d S t|S )Nz parenthesized expression-listrÖ r× )r¹ rÚ )r ró r1 r r r Ú _parse_paren_expression_listÞ s
z-DefinitionParser._parse_paren_expression_listc C s( | j ddd\}}|d kr d S t||S )Nzbraced-init-listr2 r3 )r¹ rÛ )r ró r1 r r r Ú_parse_braced_init_listë s z(DefinitionParser._parse_braced_init_listc C sð | j }g }xØ| j | jdrT| j }| j | jdsD| jd |jt| q| jdr| jdrx| jd8 _n| j }|jt
| q| jdr¨|jt q| jdrÀ|jt q| j
}|d k rà|jt| qP qW t||S ) NrÞ rß z*Expected ']' in end of postfix expression.z->rs r| z++z--)rµ r© r¸ r± r² r¤ ræ rÝ r¢ r´ rã rà râ rº rÙ rä )r r rå rÕ r rÜ r r r Ú_parse_postfix_expressionó s:
z*DefinitionParser._parse_postfix_expressionc C sø | j xDtD ]<}|d dkr*| j|}n
| j|}|r| j }t||S qW | jdr¢| jdr| jdd}| j | jds| j d t
|S | j }t |S | jd rð| jdsÀ| j d
| jdd}| j | jdsè| j d t
|S | j S ) Nr rê rZ rÖ F)Únamedr× z Expecting ')' to end 'sizeof'.rd z Expecting '(' after 'alignof'.z Expecting ')' to end 'alignof'.)r© Ú_expression_unary_opsrª r² Ú_parse_cast_expressionrè Úskip_word_and_wsr¸ Ú _parse_typer¤ rí Ú_parse_unary_expressionrï rð r¼ )r ré r¶ rÕ rî r r r r s4
z(DefinitionParser._parse_unary_expressionc C sÚ | j }| j | jdrÎy0| jd}| jds8| jd | j }t||S tk
rÊ } zf|| _ y| j S tk
r¸ } z4g }|j |df |j |df | j
|d|W Y d d }~X nX W Y d d }~X qÖX n| j S d S )NrÖ Fr× z Expected ')' in cast expression.zIf type cast expressionzIf unary expressionzError in cast expression.) r¢ r© r² rÁ r¤ r¿ rñ r' r ræ Ú_make_multi_error)r r¢ rî rÕ ZexCastZexUnaryÚerrsr r r r¿ E s(
.z'DefinitionParser._parse_cast_expressionc s fdd | dS )Nc s d t tkr$tdfdd }ntd fdd }g }g }|j| x¶j j}d}xt D ]}|d dkrj|sqln j|sql|d kr¸jd kr¸ jd8 _P y$| }|j| |j| d
}P W ql t k
rö |_Y qlX qlW |sPP qPW t
||S ) Nrz )rW c s j S )N)r¿ r )r r r Úparserk s zYDefinitionParser._parse_logical_or_expression.<locals>._parse_bin_op_expr.<locals>.parserc s d S )Nrz r r )Ú_parse_bin_op_exprÚopIdr r r rÅ n s Fr Úabcnoxrn T) r Ú_expression_bin_opsr ræ r© r¢ rª r² r¡ r' rò ) r rÇ rÅ ró rô r¢ ÚoneMoreré rÕ )rÆ )rÇ r r rÆ i s<
zIDefinitionParser._parse_logical_or_expression.<locals>._parse_bin_op_exprr r )r r )rÆ r Ú _parse_logical_or_expression] s %z-DefinitionParser._parse_logical_or_expression)Ú
orExprHeadrW c C s d S )Nr )r rÌ r r r Ú"_parse_conditional_expression_tail s z3DefinitionParser._parse_conditional_expression_tailc C s g }g }| j }|j| xjd}| j xRtD ]J}|d dkrL| j|sXq.n | j|sXq.| j }|j| |j| d}q.W |s P q W t||S )NFr rÈ T)rË ræ r© Ú_expression_assignment_opsrª r² r÷ )r ró rô ÚorExprrÊ ré rÕ r r r Ú _parse_assignment_expression s(
z-DefinitionParser._parse_assignment_expressionc C s | j }|S )N)rË )r rÏ r r r Ú_parse_constant_expression² s z+DefinitionParser._parse_constant_expressionc C s | j S )N)rÐ )r r r r r± ¸ s z"DefinitionParser._parse_expressionT)rV rÅ ÚallowrW c
C sJ | j }y| S tk
rR } z*| s,| j r. | jd| || _ W Y d d }~X nX |d k s`t| j | j }| jtr| j}n¾dddd}g } xt| j st
| dkr²| j |kr²P | j |j krÒ| j
|| j n"t
| dkrô| j | d krô| j | j d7 _ qW t
|dkr*| j r*| jd| | j|| j
j }t|j S )
NzBParsing of expression failed. Using fallback parser. Error was:
%sr× r3 rß )rÖ r2 rÞ r rz z0Could not find end of expression starting at %d.rº )r¢ r' Z allowFallbackExpressionParsingÚwarnr r© r« Ú
_string_reÚ matched_textr£ r r¡ Úkeysræ Úpopr¤ r¥ Ústriprø )
r rV rÅ rÒ ZprevPosr/ r¦ rÅ ZbracketsrO r r r Ú_parse_expression_fallback¾ s:
z+DefinitionParser._parse_expression_fallbackc C sº g }| j d}| jdr d}x| j | jts<| jd | j}|tkrX| jd| | j| jjkrd
}| j|| jt | jjf t
|}|j | | j | jds P q W t ||S ) NFr¯ Tz#Expected identifier in nested name.z3Expected identifier in nested name, got keyword: %sz2Expected identifier, got user-defined keyword: %s.z< Remove it from c_extra_keywords to allow it as identifier.
z!Currently c_extra_keywords is %s.znExpected identifier, got user-defined keyword: %s. Remove it from c_extra_keywords to allow it as identifier.
zExpected identifier, got user-defined keyword: %s. Remove it from c_extra_keywords to allow it as identifier.
Currently c_extra_keywords is %s.)
r© r² r« r1 r¤ rÕ Ú _keywordsr Úc_extra_keywordsr r ræ rª )r r« r¬ r r rÀ r r r r´ é s.
z#DefinitionParser._parse_nested_namec C s< | j tr| jS x&dD ] }|| jjkr| j|r|S qW d S )Nre rf rg )re rf rg )r« Ú_simple_type_specifiers_rerÕ r rÛ rª )r Útr r r Ú _parse_simple_type_specifier
s
z-DefinitionParser._parse_simple_type_specifierc C sN g }| j x(| j }|d kr P |j| | j qW t|dkrFd S t|S )Nr )r© rÞ ræ r rû )r r« rÝ r r r Ú _parse_simple_type_specifiers
s
z.DefinitionParser._parse_simple_type_specifiersc C sX | j | j }|d k r |S d }| j x dD ]}| j|r.|}P q.W | j }t||S )Nr\ rL r_ )r\ rL r_ )r© rß rÀ r´ rü )r r¶ r Úkrý r r r Ú_parse_trailing_type_spec
s
z*DefinitionParser._parse_trailing_type_spec)Ú paramModerW c C s | j | jds*|dkr&| jd nd S g }| j | jdsÖx| j | jdr|jtd d | j | jds| jd P | jd dd }|jt| | j | jd
r´qBqB| jdrÂP qB| jd | j qBW g }x | j }|d krîP |j| qÜW t||S ) NrÖ rC z Expecting "(" in parameters.r× z...Tz'Expected ")" after "..." in parameters.Úsingle)r r½ r
z-Expecting "," or ")" in parameters, got "%s".) r© r² r¤ ræ rþ Ú_parse_type_with_initr¡ Ú_parse_attributer )r râ r rÿ r r r r r Ú_parse_parameters1
sB
z"DefinitionParser._parse_parameters)r ÚtypedrW c C sT d}d}d}d}d}d}g } x | j |s||dkrT| jdrDd}q | jdrTd}q |dkr|| jdrld}q | jdr|d}q |dkrª| rª| jdrd}q | jd rªd }q |dkrÈ| rÈ| jd
}|rÈq | râ|râ| jd }|râq | oê|r | jd }|r q | r |r | jd
}|r q | j }
|
r:| j|
q P q W t||||||| S )zJust parse the simple ones.NrK rD rU rC r[ rM rh rc rR rV ra rG )rK rC )r© rª rå ræ r ) r r rç r r rR rV ra rG r r r r r Ú_parse_decl_specs_simple]
sl
z)DefinitionParser._parse_decl_specs_simplec C sT |r|dkrt d| | j||}d }|rB| j }| j||}nd }t||||S )Nr rK rC z#Internal error, unknown outer "%s".)r rK rC )r§ rè rá r )r r rç r r r r r r Ú_parse_decl_specs
s z"DefinitionParser._parse_decl_specs)r½ râ rç rW c sB |dks t |dkr jtr jtkr8 jd j j jjkrfd} j| jt jjf t j}t
|gdd}qd }n|r j }nd }g }x4 j |o´ j
d rÎ j d}d} d}
d} xb|sæ jd
ræd}qÒ| sþ jd rþd} qÒ|
s jd rd}
qÒ| s. jd
r.d} qÒP qÒW |r>dn jd} | rj j
dsd jd d }
nJ j
dr|d }
n8 fdd} jdg|}
j j
ds´ jd |jt|| |
| | |
q P q W j|}|d kr4t|dkr4|r4|dkr4|r4 j j
dr4 j }
t||
dS t|||dS )NTFrã z$Expected identifier, got keyword: %sz2Expected identifier, got user-defined keyword: %s.z< Remove it from c_extra_keywords to allow it as identifier.
z!Currently c_extra_keywords is %s.)r¬ rÞ r[ rG ra rV rs rß z&Expected ']' in end of array operator.c s j S )N)r± r )r r r rÅ â
s z>DefinitionParser._parse_declarator_name_suffix.<locals>.parserr r r) )r& r )r& r' r¸ )TFrã znExpected identifier, got user-defined keyword: %s. Remove it from c_extra_keywords to allow it as identifier.
zExpected identifier, got user-defined keyword: %s. Remove it from c_extra_keywords to allow it as identifier.
Currently c_extra_keywords is %s.)r r« r1 rÕ rÚ r¤ r rÛ r r rª r´ r© r² rÀ r¸ rÙ ræ r ræ r rÑ r( r% )r r½ râ rç r r r& r' r[ rG ra rV r r rÅ r¸ r )r r Ú _parse_declarator_name_suffix¥
s
z.DefinitionParser._parse_declarator_name_suffixc * C s^ |dkrt d| g }| j |rÆ| jdrÆ| j d}d}d}g }x^|s\| jd}|r\qH|sp| jd}|rpqH|s| jd}|rqH| j } | d k r |j| qHP qHW | j|||}
t|
||||d S |oÒ| jd
krú| j } y| j
|||} | S t k
rø }
zìd }|dkr|d 7 }|j|
|f | | _ yZ| jd
ks>t | jd
| j|||}| jd
sl| j
d | jdd|d}
t||
dS t k
ræ } zB| | _ d}|dkr¶|d7 }|j||f d}| j|||W Y d d }~X nX W Y d d }
~
X nX | j } y| j
|||S t k
rX } z,| | _ |j|df d}| j|||W Y d d }~X nX d S )Nr rC z'Internal error, unknown paramMode '%s'.rs FrV ra rG )r+ rV ra rG r rÖ z If declarator-id with parametersz (e.g., 'void f(int arg)')r× z$Expected ')' in "( ptr-declarator )")r½ râ rç )r. r+ z"If parenthesis in noptr-declaratorz% (e.g., 'void (*f(int arg))(double)')zError in declaratorzIf declarator-idz!Error in declarator or parameters)r rC )r§ r© r² rÀ rå ræ Ú_parse_declaratorr* r¡ r¢ rê r' r r¤ r- rà )r r½ râ rç Ú
prevErrorsrV ra rG r r r+ r¢ r¶ Z exParamQualr r. Z exNoPtrParenÚheaderr/ r r r rë ö
s
2z"DefinitionParser._parse_declaratorN)r Ú
allowFallbackrW c s¨ j |dkr0dr0 j }|d k r0t|ddS jds>d S j }|d k rVt|S |dkrdg }n |d krvddg}n jd| fdd } j|||d
}t|S ) NrK F)r5 ry r
r× z;Internal error, initializer for outer '%s' not implemented.c s j S )N)rÐ r )r r r rÅ ^ s z3DefinitionParser._parse_initializer.<locals>.parser)rÒ )r© r» r4 r² r¤ rÙ )r r rî Z
bracedInitZ fallbackEndrÅ rÅ r )r r Ú_parse_initializerG s&
z#DefinitionParser._parse_initializer)r½ r rW c C st |r |dkrt d| |s t|dkrg }| j}y.| j|dd}| jd|dd}| jdd W n² tk
r } zd
}|j||f || _y | j|d }| jd|d }W nV tk
r } z8|| _d
}|j| |f d}
|
d7 }
| j||
| W Y dd} ~ X nX W Y dd}~X nX nR|dkr>| j|d }| jd|d }n,d} |dkrPd}| j|d }| j|| d }t ||S )z¤
named=False|'single'|True: 'single' is e.g., for function objects which
doesn't need to name the arguments, but otherwise is a single name
r rK rC z#Internal error, unknown outer "%s".F)r rç T)r½ râ rç )ZallowSemicolonzIf just a name)r )r½ râ zIf typedef-like declarationz%Type must be either just a name or a ztypedef-like declaration.N)r rK rC )
r§ r r¢ ré rë Ú
assert_endr' ræ rà rA ) r r½ r rì r¦ r7 r8 Z exUntypedÚdescZexTypedrí râ r r r rÁ d sF
4
z DefinitionParser._parse_typec C s4 |r|dkst | j||d}| j|d}t||S )Nr rK rC )r r½ )r )r rK rC )r rÁ rï rB )r r½ r r r; r r r rä s
z&DefinitionParser._parse_type_with_initc C sL | j | j }|d kr"| jd | j | jds>t|d S | jdrRt|g S g }xê| j | jdr|jtd d | j | jds| jd P | jt s¬| jd t
t | j gdd }| j | jdr|jt|dd | j | jds| jd P |jt| | jd
r$qXqX| jdr4P qX| jd qXW t||S ) Nz(Expected identifier in macro definition.rÖ r× z...Tz-Expected ")" after "..." in macro parameters.z(Expected identifier in macro parameters.F)r¬ r
z9Expected identifier, ')', or ',' in macro parameter list.)
r© r´ r¤ r¸ rC r² ræ r< r« r1 rª r rÕ )r rÀ r rk r r r Ú _parse_macro¦ sF
z DefinitionParser._parse_macroc C s | j }t|S )N)r´ r= )r r r r r Ú
_parse_structÎ s z DefinitionParser._parse_structc C s | j }t|S )N)r´ r> )r r r r r Ú _parse_unionÒ s z DefinitionParser._parse_unionc C s | j }t|S )N)r´ r? )r r r r r Ú _parse_enumÖ s z DefinitionParser._parse_enumc sV j } j d } jdrL j td fdd } jg |}t|}t||S )Nry )rW c s j S )N)rÑ r )r r r rÅ á s z2DefinitionParser._parse_enumerator.<locals>.parser)r´ r© r² r rÙ r4 r@ )r r r; rÅ ZinitValr )r r Ú_parse_enumeratorÚ s
z"DefinitionParser._parse_enumeratorc C sl | j d }| jdr$d}| j }n:| jdr<d}| j }n"| jdrTd}| j }n
| jd t|||dS )Nr\ r_ rL zTCould not parse pre-v3 type directive. Must start with 'struct', 'union', or 'enum'.F)r© rª ró rô rõ r¤ r} )r r rî r r r Ú parse_pre_v3_type_definitionè s
z-DefinitionParser.parse_pre_v3_type_definition)r r> rW c
C s |dkrt d | |dkr(t d | d }|dkrD| jd dd
}n|dkr\| jd dd
}nz|dkrn| j }nh|dkr| j }nV|dkr| j }nD|dkr¤| j }n2|dkr¶| j }n |dkrÎ| jd dd
}ndsÖt|dk rô| j | j
d}nd}t ||||S )NrC rK rL r\ r_ rL rD r z(Internal error, unknown objectType "%s".Úvarz+Internal error, unknown directiveType "%s".T)r½ r FrI )rC rK rL r\ r_ rL rD r ) rC rK rø rL r\ r_ rL rD r ) r§ rä rÁ rò ró rô rõ rö r r© r² r} )r r r> r r? r r r Úparse_declarationù s:
z"DefinitionParser.parse_declarationc C s | j S )N)r´ )r r r r Úparse_namespace_object s z'DefinitionParser.parse_namespace_objectc C s& | j }| j | jd | j |S )Nz())r´ r© r² rð )r r r r r Úparse_xref_object s
z"DefinitionParser.parse_xref_objectc C sÈ | j }d }y | j }| j | j W n tk
r } z|| _ y | jd}| j | j W nT tk
r° } z8d}g }|j|df |j|df | j|||W Y d d }~X nX W Y d d }~X nX |S )NFz%Error when parsing (type) expression.z
If expressionzIf type)r¢ r± r© rð r' rÁ ræ rà )r r¢ r¶ ZexExprZexTyperí rÄ r r r Úparse_expression& s&
2z!DefinitionParser.parse_expression)T)T)T)NT)N)Jr r r rÁ r r r r r¨ rà r° r r³ rµ r r re r¹ rÚ rº rÛ r» rä r¼ r r¿ rË r rÍ rÐ rÑ r± r rÙ rª r´ r rÞ rû rß rú rá r ræ r rè r ré r r# rê rë r4 rï rA rÁ rB rä rC rò r= ró r> rô r? rõ r@ rö r} r÷ rù rú rû rü r r r r r _ sZ &
,&3 "( ,:P P ;("r )rW c C s t tdgddS )NZPhonyNameDueToErrorF)r¬ )rª r r r r r Ú_make_phony_error_name< s rý c s e Zd ZU dZdejiZeeddddZ ee
e dddd Z e
e
d
d d Ze
e
d
d
dZe
e
dddZeedddZeedddZe eeddddZee d
fdd Ze
e ed d d Zdd
d d Zdd
d!d"Ze
e
dd#d$Z Z S )%ÚCObjectz-
Description of a C language object.
Ú noindexentryN)ÚastrW c C sÎ |j dkst|j}|s t|jd k s*t|j}|s8t|jd krFd S |j}|d krXd S |j dkrfd S |jdkrtd S |j}|j|jdddd}|d k rd S |jj }||_ t
||j|| j j | j
d d d S )NrD rL FT)rs rt ru rz )r rÀ r r[ rb )r r r~ rÀ r r r> r rA r@ r| r r[ Úget_source_info)r r r~ rP Z
parentDeclZ targetSymbolrr Z declCloner r r Ú_add_enumerator_to_parentI s2
z!CObject._add_enumerator_to_parent)r Úsigr rW c
C s& g }xRt dtd D ]@}y|j|d}|j| W q tk
rR |tk sNtY qX qW tt|}|d }|stt|jj j
j d}|| j j
jkrò|st|d j| x6|dd
D ]&}|sÄqº|| j j
jkrº|d j| qºW | j j
j| d| jkr"| j|} | jd jd| |d d f d S )
Nrz )r® r r¯ Úidsrÿ Úentriesrã r )r» rG r´ ræ r( r r Úreversedr~ r9 r ÚlstripÚstateÚdocumentr Znote_explicit_targetrJ Úget_index_textZ indexnode)
r r r r r r½ ÚidÚnewestIdr Z indexTextr r r Úadd_target_and_indexn s.
z CObject.add_target_and_index)rW c C s
t d S )N)r )r r r r Ú object_type s zCObject.object_typec C s | j S )N)r )r r r r Údisplay_object_type s zCObject.display_object_type)r rW c C s t d|| jf S )Nz %s (C %s))r r )r r r r r r
s zCObject.get_index_text)rÅ rW c C s |j | j| jS )N)rù r Úobjtype)r rÅ r r r Úparse_definition s zCObject.parse_definitionc C s |j S )N)r÷ )r rÅ r r r r÷ s z$CObject.parse_pre_v3_type_definition)r r rJ rW c C s |j |d| j| d S )Nr¢ )r r )r r r rJ r r r r s zCObject.describe_signaturec sP | j jjj}d|jkr<|jd d }||jd< |j |jd< d |jd< t j S )Nzc:parent_symbolr Ú root_symbolz c:parent_keyz
c:last_symbol)
r r Úsettingsr Ú temp_dataÚ
domaindatar¥ Ú ref_contextr_ Úrun)r r Úroot)ra r r r £ s
z CObject.run)r r rW c , C sN | j jd }t||| j jd}yÄy| j|}|j W n¨ tk
rÞ } z| j jd sV | jdkrb y| j|}|j W n tk
r |Y nX |j | _
| j jd rÎd}|j t j
||j ||}tj||d W Y d d }~X nX W nT tk
r6 } z6tj||d t } |j| }
|
| j jd< t|W Y d d }~X nX y|j|| j j| j d d
}
|
jd ksft|
jd ksvt| j jd |
_|
jd k rª|
jjd ks¢t|
|
j_|
| j jd< W nb tk
r } zD|j| j jd< td }||jj|jj | j |f }tj||d W Y d d }~X nX |j d kr2| j | t | j } | j!||| |S )
Nzc:parent_symbol)r r Úc_allow_pre_v3r Úc_warn_on_allowed_pre_v3zl{}: Pre-v3 C type directive '.. c:type:: {}' converted to '.. c:{}:: {}'.
The original parsing error was:
{})r z
c:last_symbolrz )r[ rb zNDuplicate C declaration, also defined at %s:%s.
Declaration is '.. c:%s:: %s'.rD )"r r r r r rð r' r r÷ r r rR r r r r rý r Ú
ValueErrorr r[ r rc r rd r{ r~ r rb r r ÚdictrJ r ) r r r rP rÅ r ÚeOrigr r/ r r~ rJ r r r Úhandle_signature° s`
$
zCObject.handle_signaturec C sP | j jd }|st| j jd | _| j jd | _|| j jd< |j | j jd< d S )Nz
c:last_symbolzc:parent_symbolz c:parent_key)r r r ÚoldParentSymbolr Ú oldParentKeyr¥ )r Z
lastSymbolr r r Úbefore_contentð s zCObject.before_contentc C s | j | jjd< | j| jjd< d S )Nzc:parent_symbolz c:parent_key)r r r r r )r r r r Ú
after_contentø s zCObject.after_contentc C s d| S )zªGenerate old styled node_id for C objects.
.. note:: Old Styled node_id was used until Sphinx-3.0.
This will be removed in Sphinx-5.0.
zc.r )r r r r r Ú make_old_idü s zCObject.make_old_id) r r r Ú__doc__r ÚflagÚ option_specr; r} r r r r
rÁ r r r
r r r÷ r r r r r r r! r" r# r r r )ra r rþ @ s&
%
@rþ c @ s" e Zd ZdZeedddZdS )Ú
CMemberObjectrK )rW c C s | j dkst| j S )NrK rø )rK rø )r r )r r r r r
s z!CMemberObject.display_object_typeN)r r r r rÁ r r r r r r r'
s r' Ú parameterZ
Parametersr¸ rÿ ÚargumentrÕ r )Úlabelr« Z typerolenameZ typenamesÚretvalz
Return valuesÚretvalsT)r* r« Z can_collapseZ returnvalueZReturnsFÚreturns)r* Úhas_argr« Z
returntypez Return typeÚrtypec @ s e Zd ZdZej ZdS )ÚCFunctionObjectrC N)r r r r Ú_function_doc_field_typesÚcopyÚdoc_field_typesr r r r r0
s r0 c @ s e Zd ZdZej ZdS )Ú CMacroObjectrL N)r r r r r1 r2 r3 r r r r r4 #
s r4 c @ s e Zd ZdZdS )Ú
CStructObjectr\ N)r r r r r r r r r5 )
s r5 c @ s e Zd ZdZdS )Ú CUnionObjectr_ N)r r r r r r r r r6 -
s r6 c @ s e Zd ZdZdS )Ú CEnumObjectrL N)r r r r r r r r r7 1
s r7 c @ s e Zd ZdZdS )ÚCEnumeratorObjectrD N)r r r r r r r r r8 5
s r8 c @ s e Zd ZdZdS )Ú CTypeObjectr N)r r r r r r r r r9 9
s r9 c @ s< e Zd ZU dZdZdZdZdZi Ze e
e dddZ d S )
ÚCNamespaceObjectzb
This directive is just to tell Sphinx that we're documenting stuff in
namespace foo.
Frz r T)rW c C sÔ | j jd d }| jd j d kr,|}g }n|t| jd | j | j jd}y|j }|j W n: t k
r } z t
j || j d t }W Y d d }~X nX |j
|}|g}|| j jd < || j jd
< |j | j jd < g S )
Nr r r ÚNULLÚ0Únullptr)r r )r zc:parent_symbolzc:namespace_stackz c:parent_key)r; r< r= )r r Ú argumentsrØ r Ú get_locationr rú rð r' r r rý r r r¥ r )r Ú
rootSymbolr~ ÚstackrÅ r r/ r r r r I
s&
zCNamespaceObject.runN)
r r r r$ Ú has_contentÚrequired_argumentsÚoptional_argumentsÚfinal_argument_whitespacer& r; r r r r r r r r: =
s
r: c @ s8 e Zd ZU dZdZdZdZi Zee e
dddZ dS ) ÚCNamespacePushObjectFrz r T)rW c C sö | j d j d krg S t| j d | j | jjd}y|j }|j W n: tk
r } z t j
|| j d t }W Y d d }~X nX | jj j
dd }|s¦| jjd d }|j|}| jj j
d
g }|j| || jj d< || jj d
< |j | jjd < g S )
Nr r; r< r= )r r )r zc:parent_symbolr r zc:namespace_stackz c:parent_key)r; r< r= )r> rØ r r? r r rú rð r' r r rý r Úgetr r ræ r¥ r )r rÅ r r/ Z oldParentr~ rA r r r r g
s*
zCNamespacePushObject.runN) r r r rB rC rD rE r& r; r r r r r r r rF `
s
rF c @ s8 e Zd ZU dZdZdZdZi Zee e
dddZ dS )ÚCNamespacePopObjectFr T)rW c C s | j jjdd }| s"t|dkr:tjd| j d g }n|j t|dkrX|d
}n| j jd d }|| j jd< || j jd< |j | j j
d < g S ) Nzc:namespace_stackr z;C namespace pop on empty stack. Defaulting to global scope.)r rz r r zc:parent_symbolz
cp:parent_keyrº ) r r rG r r r r? r× r r¥ r )r rA r~ r r r r
s
zCNamespacePopObject.runN) r r r rB rC rD rE r& r; r r r r r r r rH
s
rH c s< e Zd Zd eeededd fdd
Zd dddZ Z S )
Ú AliasNodeNr )r Ú aliasOptionsr r Ú parentKeyrW c sx t j || _|| _|| _|d k rbd|jkrT|jd d }||jd< |j |jd< |jd | _ n|d k snt
|| _ d S )Nzc:parent_symbolr r z c:parent_key) r_ r r rJ r r r r¥ r rK r )r r rJ r r rK r )ra r r r
s
zAliasNode.__init__)rW c C s | j | j| j| jd | jdS )N)r rK )ra r rJ r rK )r r r r r2 ª
s zAliasNode.copy)NN)
r r r r r r rQ r r2 r r r )ra r rI
s rI c @ sD e Zd Zejd Zeeeeee e
e dddZ e ddddZ
dS ) ÚAliasTransformrz )rr ÚmaxdepthÚskipThisrJ Ú
renderOptionsr rW c C s |dkrd}n|dkr d}n |d8 }d}g }|sZt jdd} |j| |jj| d| j| |r
|rj|}
nDt j } t j } | j| || _d| d< d | d
< | d < d| d < | }
x:|j D ]0}
|
jd krÆq¶| j
|
|d|||d
}|
j | q¶W | oüt | j dkr
|j| |S )Nr Trz Fr r¹ r ÚdomainÚaliasr ÚdesctypeÚnoindex)rM rN rJ rO r )
r Údesc_signatureræ r r r Z desc_contentrñ r r^ Ú_render_symbolr r )r rr rM rN rJ rO r Zrecurser
r ZchildContainerÚcontentrñ rn Ú
childNodesr r r rU ²
sB
z AliasTransform._render_symbolN)ÚkwargsrW c
K s x| j jtD ]ò}tt|}|j}|j}y t||| jjd}|j }W n4 t
k
r~ } zt j ||d d }W Y d d }~X nX |d kr¸t
j|d}|j |t
j||7 }|j| q| jjd jd } | j|}
|
sútd| td| t| jd |
st|
j|d d
d
d } | d krlt
j|d}|j| |j |t
j||7 }t j d | |d |j| q|jd
rÒ| jd krÒt
j|d}|j| |j |t
j||7 }t j d| |d |j| q| j | |jd |jd
|jt |j d} |j| qW d S )N)r r )r r r r zTarget: z ParentKey: rz ÚanyT)rs rt z,Could not find C declaration for alias '%s'.ÚnorootzACan not render C declaration for alias '%s'. No such declaration.rM )rM rN rJ rO r ) r ÚfindallrI r r rK r r r rû r' r r r rT Úclearr¦ Z replace_selfÚdomainsrË r rW r
r r ræ rJ r rU r )
r rX r¨ r rK rÅ r r/ r r@ rP rr r
r r r ÚapplyÞ
sf
zAliasTransform.apply)r r r r! Zdefault_priorityr| rS re r r r r rU r^ r r r r rL ¯
s
*rL c @ s2 e Zd ZU ejejdZeee dddZ
dS )Ú CAliasObject)rM rZ )rW c C sâ d| j kr"| j jdd\| _| _nd| j | _| _tj }| jj|_| j|d< | j |d< |d< d|d< g | _| j j
d dd
| j kd }|d
r®|d dkr®t j d | j
d
x,| j D ] }|jt||| jj| jd q¸W |gS )zú
On purpose this doesn't call the ObjectDescription version, but is based on it.
Each alias signature may expand into multiple real signatures if 'noroot'.
The code is therefore based on the ObjectDescription version.
r) rz r rP r rR TrS rM rZ )rM rZ zError in C alias declaration. Requested 'noroot' but 'maxdepth' 1. When skipping the root declaration, need 'maxdepth' 0 for infinite or at least 2.)r )r )r ÚsplitrP r r rñ r r r« rJ rG r r r? Zget_signaturesræ rI r )r r¨ rJ r r r r r $ s"
zCAliasObject.runN) r r r r Znonnegative_intr% r& r; r r r r r r r r_ s
r_ c sR e Zd Zeeeeeeeef dddZee e
e e f d fdd Z Z
S )Ú CXRefRole)r ÚrefnodeÚhas_explicit_titleÚtitleÚtargetrW c C sv |j j|j |s"tjdt|}|sn|jd}|dd
dkrn|dd
}|jd}|dkrn||d d
}||fS )Nz [anonymous]rx r rz r¯ rº )Ú
attributesÚupdater r+ Úsubr r Úrfind)r r rb rc rd re Údotr r r Ú process_linkG s
zCXRefRole.process_link)rW c s6 | j jd st j S | jjdd}t|| j | j jd}y|j t j S t k
r0 } zÆd|_
y |j }W n t k
r t j S X dddg}| j j j
d d }|d krÀ| j jd d
}tj|d }|j|d | j | | j jd
r d}|d7 }|jtj|||}tj|| j d |gg fS d }~X nX d S )Nr r rë )r r r Zxrefr zc-texprzcpp:parent_symbolr )Úclassesr r zB{}: Pre-v3 C type role ':c:type:`{}`' converted to ':c:expr:`{}`'.z#
The original parsing error was:
{})r )r r r_ r r Úreplacer r? rû r' r¢ rü r rG r r
rR r rR r r r r ) r r rÅ r r rl rP r r )ra r r r [ s4
z
CXRefRole.run)r r r r r re r r rk r r r r r r r )ra r ra F s ra c sB e Zd Zedd fdd Zeee ee f dddZ Z
S )Ú CExprRoleN)ÚasCoderW c s t j |rd| _nd| _d S )Nzc-exprzc-texpr)r_ r Ú
class_type)r ro )ra r r r ~ s
zCExprRole.__init__)rW c C sÖ | j jdd}t|| j | jjd}y |j }W nN tk
r~ } z2tj d||| j d t
j d||| j gdgg fS d }~X nX | jj
jdd }|d kr¨| jjd d }t
j d| j gd}|j|d
| j| |gg fS ) Nr rë )r r z Unparseable C expression: %r
%s)r r )rl zc:parent_symbolr r )r rm r r? r r rü r' r r r Z desc_inlinerp r rG r r )r r rÅ r ÚexrP r r r r r s
(z
CExprRole.run) r r r re r r r r r r r r r )ra r rn } s rn c @ s> e Zd ZU dZdZdZeedddddeedddddeed d
dd eed d deed
d
dd eedddd eedddd eedddeed dd eedddddd
Ze e e
e e e
eeeeeeed
Ze e e edde e e e e e eddeddd Zedddddi dZee e eee e e e e f f f f e ddd d Z e e e!j"dd d d Z#e$dd!d"d#Z%e&e edd$d%d&Z'e e e(e e e$e)e e*e) e*e f d'd(d)Z+e e e(e e e$e)e*e) d'd*d+Z,e e e(e e$e)e&e e e)f d,d-d.Z-e.e e e e e e e/f d/d0d1Z0dS )2ÚCDomainzC language domain.r r rK rø rË r ÚvariablerC Úfuncr rL r\ r_ rL rD zfunction parameter)
rK rø rC rL r\ r_ rL rD r rh )
rK rø rC rL r\ r_ rL rD r Ú namespaceznamespace-pushz
namespace-poprQ T)Z
fix_parens)ro F) rK rË rø rt rL r\ r_ rL rD r rÕ ZtexprN)r Úobjects)r[ rW c C s t jr4td| td t| jd jd td | jd }|j| t jr|td t| jd jd td td| d S ) Nz
clear_doc:z before:r rz z before endz after:z
after endzclear_doc end:)r| r rW rË r
rm )r r[ r@ r r r rm Ô s
zCDomain.clear_doc)r r[ r rW c C s2 t jr.td| t| jd jd td| d S )Nz process_doc:r r zprocess_doc end:)r| r rW rË r
)r r r[ r r r r Ú process_docä s
zCDomain.process_doc)r© rW c C s |j j| jj d S )N)rf rg r r )r r© r r r Úprocess_field_xrefë s zCDomain.process_field_xref)r Ú otherdatarW c C s t jr\td td t| jd jd td td t|d jd td td | jd j|d || j | jd }x<|d j D ],\}\}}}||kr||kr|||f||< qW d S )
Nzmerge_domaindata:z self:r rz z self endz other:z
other endzmerge_domaindata endrv )r| r rW rË r
r r Úitems)r r ry Z
ourObjectsÚfullnameÚfnrF r r r r Úmerge_domaindataî s
zCDomain.merge_domaindata)r Ú fromdocnameÚbuilderrî re r¨ ÚcontnoderW c C s t |||jd}y |j } W n2 tk
rN }
ztjd||
|d d S d }
~
X nX |jdd } | jd } | r¤| j| }
|
st d| t d| t | j
d |
s¨t n| }
|
j | |d d d
}|d ksÌ|j
d krÐd S |j
}| j }|j}|sìt t||||j |||jfS )
N)r r z$Unparseable C cross-reference: %r
%s)r z c:parent_keyr zTarget: z ParentKey: rz T)rs rt )NN)NN)r r rû r' r r rG rË r rW r
r r r r r[ r: rH r )r r r~ r rî re r¨ r rÅ r r/ rK r@ rP rr r Z displayNamer[ r r r Ú_resolve_xref_inner s8
zCDomain._resolve_xref_innerc C s | j |||||||d S )Nr )r )r r r~ r rî re r¨ r r r r Ú resolve_xref' s zCDomain.resolve_xref)r r~ r re r¨ r rW c C sJ t j | j|||d|||\}}W d Q R X |rFd| j| |fgS g S )NrY zc:)r" Zsuppress_loggingr Zrole_for_objtype) r r r~ r re r¨ r Zretnoder r r r Úresolve_any_xref- s
zCDomain.resolve_any_xref)rW c c s | j d }xt|j D ]h}|jd kr$q|js.t|j }t|jd}|j jd}|jj }|j}|jj
}|||||dfV qW d S )Nr r¯ rz ) rË ro r r[ r r9 r r r r rH ) r r@ r~ ZfullNestedNamer Zdispnamer r[ r r r r Ú get_objects7 s
zCDomain.get_objects)1r r r r$ r r* r r Z object_typesr' r0 r4 r5 r6 r7 r8 r9 r: rF rH r_ r ra rn Zrolesr| Z initial_datar r r r rm r r
r rw r rx r r} r r r r r r r rS r r r r r rr sn
. #rr )ÚapprW c C sh | j t | jdg d | jdg d | jdtd | jt | jddd | jddd d d
ddd S ) Nr r r rÛ r Fr TÚbuiltinr} )r® Z env_versionZparallel_read_safeZparallel_write_safe)Z
add_domainrr Zadd_config_valueÚ_macroKeywordsZadd_post_transformrL )r
r r r ÚsetupF s
r )r= r> r? r@ rA rB rC )r¸ r( rÿ r) )r )r, r+ )r- rW )r/ )±r$ ÚreÚtypingr r r r r r r r r
r r Zdocutilsr
Zdocutils.nodesr r r r Zdocutils.parsers.rstr Zsphinxr Zsphinx.addnodesr Zsphinx.applicationr Zsphinx.buildersr Zsphinx.deprecationr Zsphinx.directivesr Zsphinx.domainsr r Zsphinx.environmentr Z
sphinx.localer r Z sphinx.rolesr r Zsphinx.transformsr Z!sphinx.transforms.post_transformsr! Z sphinx.utilr" Zsphinx.util.cfamilyr# r$ r% r& r' r( r) r* r+ r, r- r. r/ r0 r1 r2 r3 r4 r5 Zsphinx.util.docfieldsr6 r7 r8 Zsphinx.util.docutilsr9 Zsphinx.util.nodesr: Zsphinx.util.typingr; Ú getLoggerr r r< rB rÚ r rÉ r¾ rÎ rG rE ÚcompileÚSrÔ rÜ r§ r{ r r rª r rà rÄ rÊ rÌ rÒ rÓ rÔ rØ rÙ rÝ rà râ rã rä rè rí rï rð rñ rò r÷ rø rú rû rü rþ r r r r r# r% r( r* r- rÚ rÛ r4 rA rB r< rC r= r> r? r@ r} rN rQ r| r rý rþ r' r1 r0 r4 r5 r6 r7 r8 r9 r: rF rH rI rL r_ ra rn rr r r r r r r Ú<module> s: 4 T
/Q
3?6;
)!I&/(Z d F
# o(7 *