-Ph' dZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZmZdd lmZmZmZdd lmZmZdd lmZdd lmZmZddlmZm Z ddl!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*m+Z+m,Z,ddl-m.Z.m/Z/m0Z0ddl1m2Z2m3Z3ddl4m5Z5erBddl6m7Z7m8Z8ddlm9Z9m:Z:ddl;mZ>m?Z?ddl@mAZAddlBmCZCddlDmEZEddlmFZFddlGmHZHddlImJZJmKZKdd lmLZLmMZMmNZNmOZOmPZPmQZQmRZRmSZSmTZTmUZUmVZVmWZWmXZXmYZYmZZZm[Z[m\Z\m]Z]m^Z^m_Z_m`Z`maZambZbmcZcmdZdmeZemfZfmgZgmhZhmiZimjZjmkZkmlZlmmZmmnZnmoZompZpmqZqmrZrmsZsmtZtmuZumvZvmwZwmxZxmyZymzZzm{Z{e(j|e}Z~d`d#ZGd$d%eeZGd&d'eZe0d(ed)d*d+d,-e/d.ed/d0d12e.d3ed4d5d67e.d8ed9d5d:7gZGd;deZGd?d@eZGdAdBeZGdCdDeZGdEdFeZGdGdHeZGdIdJe2ZGdKdLe2ZGdMdNe2ZGdOdPej<ZGdQdRe$ZGdSdTeeZGdUdVe"ZGdWdXe3ZGdYdZeZdad^Zd_S)bzThe C language domain.) annotations)NoneType) TYPE_CHECKING)nodes) directives)addnodes)ObjectDescription)DomainObjType)ASTDeclaration ASTIdentifier ASTNestedName)_macro_keywords_max_id)DefinitionParser)Symbol_DuplicateSymbolError)___)XRefRole)SphinxTransform)ReferencesResolver)logging)DefinitionError NoOldIdErroranon_identifier_re)Field GroupedField TypedField)SphinxDirective SphinxRole) make_refnode)IteratorSet)AnyClassVar)ElementNode TextElementsystem_message) pending_xref)Sphinx)Builder) LookupKey)BuildEnvironment)ExtensionMetadata OptionSpec)0ASTAlignofExprASTArrayASTAssignmentExprASTBase ASTBinOpExprASTBooleanLiteralASTBracedInitList ASTCastExprASTCharLiteral ASTDeclaratorASTDeclaratorNameBitFieldASTDeclaratorNameParamASTDeclaratorParenASTDeclaratorPtr ASTDeclSpecsASTDeclSpecsSimpleASTEnum ASTEnumerator ASTExpressionASTFallbackExprASTFunctionParameterASTIdExpressionASTInitializer ASTLiteralASTMacroASTMacroParameterASTNumberLiteral ASTParameters ASTParenExprASTParenExprListASTPostfixArrayASTPostfixCallExpr ASTPostfixDecASTPostfixExpr ASTPostfixIncASTPostfixMemberOfPointer ASTPostfixOp ASTSizeofExpr ASTSizeofTypeASTStringLiteral ASTStructASTTrailingTypeSpecASTTrailingTypeSpecFundamentalASTTrailingTypeSpecNameASTTypeASTTypeWithInitASTUnaryOpExprASTUnionreturnrc@ttdgdS)NPhonyNameDueToErrorF)rooted)rr Y/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/domains/c/__init__.py_make_phony_error_nameriis! -(=>>? N N NNrgceZdZUdZejejejejejejdZded<dd ZddZ e d dZ e d dZ d!dZ d"dZd#dZd$fd Zd%dZd&dZd&dZxZS)'CObjectz#Description of a C language object.)no-index-entryzno-contents-entryzno-typesetting noindexentrynocontentsentrysingle-line-parameter-listClassVar[OptionSpec] option_specastr rbNonec|jdksJ|j}|sJ|jJ|j}|sJ|jdS|j}|dS|jdkrdS|jdkrdS|j}||jddd}|dS|j}||_t||j||j j | ddS)N enumeratorenumFT) matchSelf recurseInAnonsearchInSiblings)parentident declarationdocnameline) objectTypesymbolr|r{r} directiveTypefind_identifiercloneenumeratorScopedSymbolrenvr~get_source_info)selfrrr parent_symbol parent_decl target_symbols decl_clones rh_add_enumerator_to_parentz!CObject._add_enumerator_to_parentys3~---- |'''    ' F#/   F  !V + + F  $ . . F%,  ) ) LEPU *   = F'--// ,2 ) ,"H$%%''*       rgsigstrsignoder)c6g}tdtdzD]K} ||}||/#t$r|tksJYHwxYw||d}|sJ|j d}||j j j vr||sJ|d||ddD]3}|s||j j j vr|d|4|j j |d|jvr<||} |jdd| |d dfdSdS) Nrz)versionr.idsrlentriessingle)rangerget_idappendrreverserget_full_nested_nameget_display_stringlstripstatedocumentrnote_explicit_targetoptionsget_index_text indexnode) rrrrrriid newest_idname index_texts rhadd_target_and_indexzCObject.add_target_and_indexsq'A+&& # #A #ZZZ** 2 # # #7{{{{{{ # F z..00CCEELLSQQ DJ/3 3 3    EN ! !) , , ,!""g . .TZ0444EN))"--- J  4 4W = = = 4< / /,,T22J N9 % , , .      0 /s+A  A$#A$ctN)NotImplementedErrorrs rh object_typezCObject.object_types!!rgc|jSr)rrs rhdisplay_object_typezCObject.display_object_types rgrc4td||jfzS)Nz %s (C %s))rr)rrs rhrzCObject.get_index_texts~~t'? @@@rgparserrcB||j|jSr)parse_declarationrobjtype)rrs rhparse_definitionzCObject.parse_definitions''(8$,GGGrgrdict[str, Any]c@||d|j|dS)N lastIsName)describe_signaturer)rrrrrs rhrzCObject.describe_signatures& w dhHHHHHrg list[Node]c|j}|jj;|jdd}||j_||jd<d|j_tSNc root_symbol c:parent_key) rcurrent_documentc_parent_symbol domaindataget_lookup_key ref_context c_last_symbolsuperrun)rrroot __class__s rhrz CObject.runsih   / 7>#&}5D37C 0.2.A.A.C.CCON + .2*ww{{}}rgc |jjj}|jjp |jjpd}d|jvot||cxkodknc|d<t|||j} | |}| nj#t$r]}t ||t}||} | |jj_t"|d}~wwxYw |||jj|d} | jJ| jJ|jjj| _| j| jjJ| | j_| |jj_nw#t.$rj}|j|jj_t3d} t | |jj|jj|j||d d Yd}~nd}~wwxYw|jd kr||t=|j} |||| |S) Nrromulti_line_parameter_listlocationconfigrrz)r~rzNDuplicate C declaration, also defined at %s:%s. Declaration is '.. c:%s:: %s'.duplicate_declarationr)rtypesubtyperu) rrrrc_maximum_signature_line_lengthmaximum_signature_line_lengthrlenrr assert_endrloggerwarningriadd_namer ValueErroradd_declarationr~r siblingAbove siblingBelowrrrrrrrdictr) rrrrmax_lenrrrerrmsgrs rhhandle_signaturezCObject.handle_signatures $ 9 I  K 7 {8   ) < )SG''''a'''' +, "# LLL $''//C        $ $ $ NN1wN / / /*++D"++D11F6\ ) )  * *3 / / /t|$$ g666 s3-)B C>!AC99C>BF H !A HH c|jjj}|sJ|jjj|_|jjd|_||jj_||jjd<dSNr)rrrroldParentSymbolr oldParentKeyr)r last_symbols rhbefore_contentzCObject.before_content,sk"h7E #x8H'+x';N'K4?!1/:/I/I/K/K^,,,rgcZ|j|jj_|j|jjd<dSr)rrrrrrrs rh after_contentzCObject.after_content4s*484H!1/3/@^,,,rg)rrr rbrs)rrr rrrr)rbrsrbr)rrrbr)rrrbr )rr)rrr rrrbrsrbr)rrrr)rbr )rbrs)__name__ __module__ __qualname____doc__rflagrq__annotations__rrpropertyrrrrrrrrr __classcell__rs@rhrkrkms--%/'_$/"%?&0o ))K( ( ( ( T%%%%N"""X"   X AAAAHHHHIIII      @@@@DLLLLAAAAAAAArgrkc*eZdZdZeddZdS) CMemberObjectmemberrbrc&|jdvsJ|jS)N>varr)rrs rhrz!CMemberObject.display_object_type<s |00000|rgNr)rrrrrrrfrgrhrr9s7K Xrgr parameter Parameters)paramrargargumentexpr)r)labelnames typerolename typenamesretvalz Return values)retvalsrT)rr can_collapse returnvalueReturnsF)returnsrb)rhas_argr returntypez Return type)rtypec:eZdZdZeZdS)CFunctionObjectfunctionNrrrr_function_doc_field_typescopydoc_field_typesrfrgrhrr`s$K/4466OOOrgrc:eZdZdZeZdS) CMacroObjectmacroNrrfrgrhrrfs$K/4466OOOrgrceZdZdZdS) CStructObjectstructNrrrrrfrgrhrrlsKKKrgrceZdZdZdS) CUnionObjectunionNrrfrgrhr r psKKKrgr ceZdZdZdS) CEnumObjectrvNrrfrgrhr#r#tKKKrgr#ceZdZdZdS)CEnumeratorObjectruNrrfrgrhr&r&xsKKKrgr&ceZdZdZdS) CTypeObjectrNrrfrgrhr(r(|r$rgr(c:eZdZUdZdZdZdZdZiZde d<d d Z d S) CNamespaceObjectz]This directive is just to tell Sphinx that we're documenting stuff in namespace foo. FrzrTrprqrbrc|jjdd}|jddvr|}g}nt |jd||j} |}|nS#t$rF}t ||t}Yd}~nd}~wwxYw| |}|g}||jj_||jj_||jjd<gS)Nrrr0NULLnullptrrrr)rr argumentsstripr get_locationrparse_namespace_objectrrrrrirrrc_namespace_stackrr)rrrstackrrrs rhrzCNamespaceObject.runsHh)#.}= >!  " " $ $(@ @ @ F"$EE%q!D,=,=,?,? F 04466!!####" 0 0 0q4+<+<+>+>???-// 0!))$//FHE4:!16;!3/5/D/D/F/F^, s4(B C-'!  " " $ $(@ @ @I! N1 (9(9(;(;DK    ,0022D        , , , NN1t'8'8':':N ; ; ;)++DDDDDD ,X.>  A,S1-@J$$T** !3::6BBB4:!1/5/D/D/F/F^, s(B C >2YFFX(-mrfrgrhr@r@sRK $(*K****rgr@c.eZdZ ddfd ZddZxZS) AliasNodeNrr aliasOptionsdict[str, bool]rr%rBuildEnvironment | None parentKeyLookupKey | NonerbrscBt||_||_||_|[|jj;|jdd}||j_||j d<|j d|_ dS|J||_ dSr) r__init__rrFrrrrrrrI)rrrFrrrIrrs rhrLzAliasNode.__init__s (  ?#3;~c*=97;$4262E2E2G2G/ _^C"/11}t$$$ ( !$X5<<Y$z"2#'Z "&: 4 4&."11%#"/#1% 2  &&{3333 &T]!3!3q!8!8 W%%% rgkwargsrsc :|jtD]}|j}|j} t |||j}|}n5#t$r(}t ||d}Yd}~nd}~wwxYw|Wtj |d}| |tj||z }|||jjjjd} | |} | sctd|td|t| d| sJ| |dd d } | tj |d}||| |tj||z }t d |||| |jd s| jtj |d}||| |tj||z }t d |||||| |jd|jd |ji|j} || dS)Nrrrr Target: %s ParentKey: %srzanyTrwrxz,Could not find C declaration for alias '%s'.norootzACan not render C declaration for alias '%s'. No such declaration.rQr])rfindallrErrIrrparse_xref_objectrrrrr^clear desc_name replace_selfrdomainsc_domaindata direct_lookupdebugdumpfind_declarationrrFr}rb) rrinoder parent_keyrrrrrrrrs rhapplyzAliasTransform.apply4s.M)))44A %A %D(CJ )#T[QQQ//11"   q4000 |"1#r:: 8-c3777!!'***"&("2";"@"OK+6+D+DZ+P+PM  2 \3/// _j999 [--a00111 ..et4/Ay"1#r:: G$$$ 8-c3777BDSW!!'***$X. 1=3H"1#r:: G$$$ 8-c3777W! !!'***''*:6+H5"/! (E   e $ $ $ $CA %A %s+A B(B  BN)rrrQrRrSrTrUrGrVrGrr%rbr)rir%rbrs)rrrrdefault_priorityrbr~rfrgrhrPrPsQ):Q>6666pB%B%B%B%B%B%rgrPc@eZdZUejejdZded<ddZdS) CAliasObjectrQrorprqrbrc d|jvr)|jdd\|_|_nd|jc|_|_t j}|jj|_|j|d<|jx|d<|d<d|d<g|_|j d dd |j vd }|d r:|d dkr.t d | |D]7}|t!|||jj|j8|gS)zOn 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. :rzrrYrr[Tr\rQrorzError 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)rsplitrYrrr`rrrrgetrrr2get_signaturesrrEr)rr|rUrs rhrzCAliasObject.runsb $)  (, Q(?(? %DK(*DI %DK} + X-1\9Y$z*Z "  ((Q77$,.    " }Z'@A'E'E NNA**,,    &&((  C KK#}dj.AtxPPP    v rgNr) rrrrnonnegative_intrrqrrrfrgrhrrysU./))K """"""rgrceZdZdd Zd S) CXRefRolerr/refnoder'has_explicit_titlerTtitlertargetrbtuple[str, str]c>|j|j|s"tjdt |}|sU|d}|dddkr2|dd}|d}|dkr ||dzd}||fS)Nz [anonymous]~rrzrrB) attributesupdaterrsubrrrfind)rrrrrrdots rh process_linkzCXRefRole.process_links !!#/222! F'*=#e**EEE! -]]3''FQqSzS  abb kk#&&"99!#')),Ef}rgN) rr/rr'rrTrrrrrbr)rrrrrfrgrhrrs(rgrc(eZdZdfd Zd dZxZS) CExprRoleasCoderTrbrsclt|r d|_dSd|_dS)Nzc-exprzc-texpr)rrL class_type)rrrs rhrLzCExprRole.__init__s9   (&DOOO(DOOOrg'tuple[list[Node], list[system_message]]c\|jdd}t|||j} |}nj#t $r]}td|||tj d|||j g}|ggfcYd}~Sd}~wwxYw|j j j}||j jdd}tj d|j g}||d |j ||ggfS) N  rzUnparseable C expression: %r %srr)classesrmarkType)textreplacerr2rparse_expressionrrrr desc_inlinerrrrrr)rrrrrexr|rrs rhrz CExprRole.runsTy  s++! 4,,..t{    ))++CC    NN2**,,    'T4$/ARSSSD62:       1A   H/4]CM&sT_4EFFF w DHmLLLy"}sA C%AB=7C=C)rrTrbrs)rbr)rrrrLrrrs@rhrrsQ((((((rgrcReZdZUdZdZdZeedddddeedddddeed d dd eed d deed d dd eedddd eedddd eedddeed dd eedddddd Ze e e e e e eeeeeeed Zeeeedeeeeeeededd ZedddddidZded<d?d!Zd@d&ZdAd)ZdBd.ZdCd8Z dDd:Z!dEd<Z"dFd>Z#dS)GCDomainzC language domain.rCrrrw identifiervariablerfuncrrrr!rvruzfunction parameter) rrrrrr!rvrur functionParam) rrrrrr!rvrur namespaceznamespace-pushz namespace-poprZT) fix_parens)rF) rrwrrrrr!rvrurrtexprN)robjectsz3dict[str, Symbol | dict[str, tuple[str, str, str]]] initial_datar~rrbrsctjrtd|tdt|jddtd|jd}||tjrtdt|jddtdtd|dSdS) Nz clear_doc: %sz before:rrzz before endz after:z after endzclear_doc end: %s)rdebug_show_treerryrwrz clear_doc)rr~rs rhrzCDomain.clear_doc s  ! ) LL' 2 2 2 LL % % % LL=166q99 : : : LL ( ( (i . g&&&  ! 7 LL $ $ $ LL=166q99 : : : LL ' ' ' LL,g 6 6 6 6 6  7 7rgrr/rnodes.documentctjrptd|t|jddtd|dSdS)Nzprocess_doc: %srrzprocess_doc end: %s)rrrryrwrz)rrr~rs rh process_doczCDomain.process_doc0sp  ! 9 LL*G 4 4 4 LL=166q99 : : : LL. 8 8 8 8 8 9 9rgpnoder+cN|j|jjdSr)rrrr)rrs rhprocess_field_xrefzCDomain.process_field_xref8s$  455555rgdocnamesSet[str] otherdatarc tjrtdtdt|jddtdtdt|ddtdtd|jd|d||j|jd }|d D]\}\}}}||vr ||vr|||f||<dS) Nzmerge_domaindata:z self:rrzz self endz other:z other endzmerge_domaindata endr) rrrryrwrz merge_withritems)rrr our_objectsfullnamefnid_rs rhmerge_domaindatazCDomain.merge_domaindata;s^  ! 1 LL, - - - LL # # # LL=166q99 : : : LL & & & LL $ $ $ LL=166q99 : : : LL ' ' ' LL/ 0 0 0 - ++ m $h   i * ,5i,@,F,F,H,H ? ? (H(r3X~~;..-/g,>K) ? ?rg fromdocnamebuilderr-typrr|contnoder'/tuple[nodes.reference, str] | tuple[None, None]ct|||j} |} n6#t$r)} td|| |Yd} ~ dSd} ~ wwxYw|dd} |jd} | r| | } | sct d|t d| t | d | sJn| } | | |d d }||j dS|j }| }|j}|sJt|||||||jfS) Nrz$Unparseable C cross-reference: %r %srrNrrrkrlrzTrn)rrrqrrrrrwrxryrzr{r}rr~r" get_newest_idr)rrrrrrr|rrrrr}rrrr} display_namer~s rh_resolve_xref_innerzCDomain._resolve_xref_innerPs"&4 KKK ++--DD    NN7T    :::::   (,xx'E'E i .  ($/$=$=j$I$IM  2 \6222 _j999 [--a00111 'M  * * #T +   9 -:m ..00 )     % % ' '       !" "s. A!AA!nodes.reference | Nonec D||||||||dS)Nr)r)rrrrrrr|rs rh resolve_xrefzCDomain.resolve_xrefs3'' gsFD(    rg!list[tuple[str, nodes.reference]]c tj5||||d|||\}}dddn #1swxYwY|rd||z|fgSgS)Nrmzc:)rsuppress_loggingrrole_for_objtype) rrrrrr|rretnoders rhresolve_any_xrefzCDomain.resolve_any_xrefs % ' '  #77['5&$   GW                 FD11':::GDE E s?AA-Iterator[tuple[str, str, str, str, str, int]]c#K|jd}|D]}|j |jsJ|}t |d}|d}|jj}|j}|j }|||||dfVdS)Nrrrz) rwget_all_symbolsr}r~rrrrrr) rrrfull_nested_namerdispnamerr~rs rh get_objectszCDomain.get_objectssi . !1133 E EF!)> ! ! !%::<< '((//44D'::<<CCCHHH ,7KnG*88::I+w 1D D D D D E Erg)r~rrbrs)rr/r~rrrrbrs)rr+rbrs)rrrrrbrs)rr/rrrr-rrrrr|r+rr'rbr)rr/rrrr-rrrrr|r+rr'rbr)rr/rrrr-rrr|r+rr'rbr)rbr)$rrrrrrr r object_typesrrrrr r#r&r(r*r;r@rrrrrolesrrrrrrrrrrrrfrgrhrrs D E'!!H++uh MMwqq}}eXv|LLGAAjMM6<HH7Wl;;'!!H++xvFF7WlFCC& 6<@@gaa oo|\JJ& <88  A" # #\5(F  L$ #'%.,J$)++ y{{ T***)++ ikk  &&&%(((  EvdD$d;;IIL 7777 99996666????*1"1"1"1"f     " E E E E E Ergrappr,r0c *|t|dgdttt h|dgdttt h|dt dttttt h|dddttth| tddd d d S) Nc_id_attributesr)typesc_paren_attributesc_extra_keywordsrbuiltinT)r env_versionparallel_read_safeparallel_write_safe) add_domainradd_config_value frozensetlisttuplersetrRradd_post_transformrP)rs rhsetuprsNN7*BYe}=U=UVVVb%y$/G/G D#u566  )  h((  >***"#   rgN)rbr)rr,rbr0)r __future__rrrtypingrdocutilsrdocutils.parsers.rstrsphinxrsphinx.directivesr sphinx.domainsr r sphinx.domains.c._astr r rsphinx.domains.c._idsrrsphinx.domains.c._parserrsphinx.domains.c._symbolrr sphinx.localerr sphinx.rolesrsphinx.transformsr!sphinx.transforms.post_transformsr sphinx.utilrsphinx.util.cfamilyrrrsphinx.util.docfieldsrrrsphinx.util.docutilsr r!sphinx.util.nodesr"collections.abcr#r$r%r&docutils.nodesr'r(r)r*sphinx.addnodesr+sphinx.applicationr,sphinx.buildersr-r.sphinx.environmentr/sphinx.util.typingr0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r\r]r^r_r`ra getLoggerrrrirkrrrrrr r#r&r(r*r;r@rErPrrrrrrrfrgrhrs"""""" ++++++//////******** ;:::::::555555BBBBBBBB!!!!!!------@@@@@@ BAAAAAAAAA<<<<<<<<****** A--------$$$$$$$$IIIIIIIIIIII,,,,,,))))))''''''222222333333@@@@@@@@1111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111f  8 $ $OOOOIAIAIAIAIA/IAIAIAXGJa oo7 La  #   Ea ll#   Ea  ):77777g777 777777777 G7''D?:/2         B}%}%}%}%}%_}%}%}%@((((($S)(((V8##### ###LHEHEHEHEHEfHEHEHEVrg