-PhbdZddlmZddlZddlZddlZddlmZmZm Z m Z m Z ddl m Z ddlmZddlmZddlmZdd lmZdd lmZer6dd lmZmZmZdd lmZdd lmZddlm Z m!Z!ddl"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)ej*e+Z,ej-dej.Z/e/Z0e deZ1Gdde e1Z2ddZ3ddd Z4dd#Z5e j6e j7e j8ej9fZ:dd%Z;e j7e j8e j<e j=fZ>e j?fZ@dd(ZAdd)ZBdd*ZCddd.ZDdd0ZEdd2ZF ddd8ZGdd9ZHdd<ZIgd=ZJddAZK dddOZLddQZMej-dRZNej-dSZOidTdUdVdWdXdYdZd[d\d]d^d_d`dadbdadcdddedWdfdgdhdidjd]dkdldmdndod_dpd_idqdrdsdtdudvdwdtdxd]dydldzd_d{d|d}ddd~dddtdddd|ddddddrZPddddddZQ dddZRddZS dddZTddZUddZVddZWe jXe jYe jZe j?e j=e j[ej\fZ]ddZ^ddZ_ddZ`ddZaeae j_bddZcece j_ddS)z3Docutils node-related utility functions for Sphinx.) annotationsN) TYPE_CHECKINGAnyGenericTypeVarcast)nodes)Node)addnodes)__)logging)_fresh_title_style_context)CallableIterableIterator)Element) Directive)InlinerRSTState) StringList)Builder)BuildEnvironment)Tagsz^(.+?)\s*(?$N)boundc2eZdZdZddZdd Zdd ZddZdS) NodeMatcheraA helper class for Node.findall(). It checks that the given node is an instance of the specified node-classes and has the specified node-attributes. For example, following example searches ``reference`` node having ``refdomain`` and ``reftype`` attributes:: matcher = NodeMatcher(nodes.reference, refdomain='std', reftype='citation') matcher.findall(doctree) # => [, , ...] A special value ``typing.Any`` matches any kind of node-attributes. For example, following example searches ``reference`` node having ``refdomain`` attributes:: matcher = NodeMatcher(nodes.reference, refdomain=Any) matcher.findall(doctree) # => [, , ...] node_classestype[N]attrsrreturnNonec"||_||_dSN)classesr )selfrr s Q/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/util/nodes.py__init__zNodeMatcher.__init__>s#  noder boolcD |jrt||jsdS|jrht|tjsdS|jD]2\}}||vrdS|t ur|||krdS3dS#t$rYdSwxYw)NFT) r% isinstancer r ritemsrget Exception)r&r*keyvalues r'matchzNodeMatcher.matchBs | JtT\$B$B uz %!$ 66! 5"&*"2"2"4"4%%JC$$uu# #%//$uu04   55 s(B!B#B($BB BBc,||Sr$)r3)r&r*s r'__call__zNodeMatcher.__call__Xszz$r) Iterator[N]c#^K||D]}td|VdS)zAn alternative to `Node.findall` with improved type safety. While the `NodeMatcher` object can be used as an argument to `Node.findall`, doing so confounds type checkers' ability to determine the return type of the iterator. rN)findallr)r&r*founds r'r8zNodeMatcher.findall[sF \\$'' # #EsE"" " " " " # #r)N)rrr rr!r"r*r r!r+)r*r r!r6)__name__ __module__ __qualname____doc__r(r3r5r8r)r'rr)sn(,    ######r)rr*r r!strc.|jd|jjS)zReturn full module dotted path like: 'docutils.nodes.paragraph' :param nodes.Node node: target node :return: full module dotted path .)r< __class__r;r*s r'get_full_module_namerEes o 9 9 7 9 99r)Plengthintc |}n#t$rt|}YnwxYw|r t ||kr |d|dz}|S)aReturn DOM XML representation of the specified node like: 'Added in version...' :param nodes.Node node: target node :param int length: length of return value to be striped. if false-value is specified, repr_domxml returns full of DOM XML representation. :return: DOM XML representation Nz...)asdomtoxmlr0r@len)r*rGtexts r' repr_domxmlrNns{zz||!!## 4yy %#d))f$$GVG}u$ Ks&)AArr"ct|tjry|jsrtdt |t||j}|j |_ |j dz |_ | |_n2t|tjr|j s|jj |_ t|tj r`|j Ytdt |t||jj |jj c|_ |_ t|tj r`|j Ytdt |t||jj |jj c|_ |_ t|tjrtdt |t|tt!|jtjD]I}t%jdt%j| zd|j|_Jt|tjr`|j Ytdt |t||jj |jj c|_ |_ t|tjrL|j Et/jt25t5||_ dddn #1swxYwY|js| |_|j r |jrdSt|tjtj ztj ztjzrltdt |t| t5||_ n#t2$r d|_ YnwxYwd |_ dSdS) Nz7[i18n] PATCH: %r to have source, line and rawsource: %sz)[i18n] PATCH: %r to have source, line: %sz#[i18n] PATCH: %r to have source: %sz&[i18n] PATCH: %r to have rawsource: %sz \s*:\s*%sz,[i18n] PATCH: %r to have source and line: %sr)r-r classifier rawsourceloggerdebugrErNparentsourcelineastextimagetitletermreversedlistr8resubescapetopic literal_block contextlibsuppress ValueErrorget_node_sourcerubric field_name)r*definition_list_itemrRs r'apply_source_workaroundrks  $()) )$. ) E  & &      ${*1 (-1  D%* + +)DK)k( $ $$F)< 7  & &      "&!3T[5E TY$ $$F)< 1  & &      "&!3T[5E TY$ ##  4  & &      #4 (;(;EDNN$ $$F)< 7  & &      "&!3T[5E TY$+,,01D   , , 0 0)$//DK 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 >' {t~  Lj k         :  & &       )$//DKK   DKKK  /s$M''M+.M+P//QQr+ct|tjrdSt|tjr,|ds|drdSt|tjrd|vrdSt|tjrC|js8t dt|t|dSt|tr*B*Bdhhuoot$ %%.*D*Du$)**!{  LL;$T**D!!    5 dM * * ~T/I/I LL2$T**D!!     5xx--  LLE$T**D!!    5 dE, - - 4=3Cx3O3O LL8$T**D!!    5t dEJ ' ''r)doctreeIterable[tuple[Element, str]]c#K|tD];}t|tjr|D]}||fV ;t|t r|j}|s|}nt|tj r[| dr ||dfV| dr"| d|d}d|}nSd}nPt|tj r |d}n-|j dd }|r||fV=d S) z3Extract translatable messages from a document tree.rnrm original_uriuriz .. image:: rQcontent  N)r8rur-r rmextract_original_messagesLITERAL_TYPE_NODESrSrYr rZr/rtreplacestrip)rvr*msg image_uris r'extract_messagesr$ss00 dH1 2 2 5577  Ci  d. / / <.C $kkmm ek * * <xx (DK''''xx''  HH^T%[AA /I// ej ) ) <y/CC.((s3399;;C  )OOO1r)cht|D]}|jr |jcSd}t|)Nznode source not found)traverse_parentrWrfr*pnoders r'rgrgAsG &&   < <    !C S//r)cht|D]}|jr |jcSd}t|)Nznode line not found)rrXrfrs r' get_node_linerIsG && : :     C S//r)clsrIterable[Element]c#PK|r!|t||r|V|j}|dSdSr$)r-rV)r*rs r'rrQsO  ;*T3//;JJJ{ r) Node | Nonecf|j|}|dkr|j|dz SdS)NrrP)rVindex)r*poss r' get_prev_noderXs6 +  D ! !C Qww{37##tr)EIterable[tuple[Element, list[tuple[str, str, str, str, str | None]]]]c#Kttjd}||D]}d|vr |d}n|d}||fVdS)z6Traverse translatable index node from a document tree.F)inline raw_entriesentriesN)rr rr8)rvmatcherr*rs r'traverse_translatable_indexr`st(.777G(( D =)GG9oGGm r)staterr{rcontent_offsetct|5||||d}dddn #1swxYwY|S)axVersion of state.nested_parse() that allows titles and does not require titles to have the same decoration as the calling document. This is useful when the parsed content comes from a completely different context, such as docstrings. This function is retained for compatibility and will be deprecated in Sphinx 8. Prefer ``nested_parse_to_nodes()``. T) match_titlesN)r nested_parse)rr{r*rrets r'nested_parse_with_titlesrms $E * *SS  .$T RRSSSSSSSSSSSSSSS Js 6::c2|}|tjD]}d|d<t |tjD]}|j||S)z&Like node.astext(), but ignore images.rQrn) deepcopyr8r rZr^rawrVremoverY)r*imgrs r' clean_astextr~s ==??D||EK((E DLL++,, # ;;==r)rMtuple[bool, str, str]ct|}|r+d|d|dfSd||fS)z3Split role content into title and target, if given.TrPF)explicit_title_rer3group)rMr3s r'split_explicit_titlersK  # #D ) )E 4U[[^^U[[^^33 $ r))singlepairdoubletripleseeseealsoentrytargetid+list[tuple[str, str, str, str, str | None]]cddlm}g}|}|}d}|drd}|dd}|D]}||dr|t |dzd}||d|}t td |||d | d |||dfntD]j}||drP|t |dzd}|d krd }| ||||dfnk| dD]h}|}d}|drd}|dd}|sN| d|||dfi|S)Nr)pairindextypesrQ!mainrP:z; zK%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead.r)typerr,r) sphinx.domains.pythonrr startswithlstriprLrTwarningr append indextypessplit)rrr indexentriesoentryr index_typer2s r'process_index_entryrse544444@BL KKMME F D #abb   ""$#M#M   z,,, - - #j//A-//06688E%j1< # Maintainer: docutils-develop@lists.sourceforge.net # Copyright: This module has been placed in the public domain. NFKDasciiignore-r}rQ) translate_non_id_translate_digraphs_non_id_translate unicodedata normalizeencodedecode _non_id_charsr`joinr_non_id_at_endsr@)rids r'_make_idrs   4 5 5B ' ( (B  vr * * 1 1'8 D D K KG T TB   3 4 4 5 5B   R $ $B r77Nr)z[^a-zA-Z0-9._]+z^[-0-9._]+|-+$oidi'hi1iiBligtibiiciifikiinipiiiyizigi%i4i5i6i7ji<i?si@iGeiIiKqiMriOszaeoedbqp)iSi8i9rrdocumentprefixr\ str | Nonecd}|r|dz}n|jjpddz}|r|rt||z}||krd}n|rt|}|sd}| ||jvr#|||z}|||jv#|S)z>Generate an appropriate node_id for given *prefix* and *term*.Nz-%srz%s)settings id_prefixrids new_serialno)rrrr\node_ididformats r'make_idr DsG @E>%/744?$8d?++ f  G 4.. G /W 44S--f555 /W 44 Nr)addnodes.pending_xref conditionElement | Nonec~|D]9}t|tjr|d|kr|cS:dS)zBPick matched pending_xref_condition node up from the pending_xref.r"N)r-r pending_xref_conditionr/)r*r"subnodes r'find_pending_xref_conditionr'bsN w ? @ @  K((I55NNN 4r) fromdocname todocnamechildNode | list[Node]r[nodes.referencectjddd}||kr|r||d<n;|r |||dz|z|d<n||||d<|r||d<||z }|S)z$Shortcut to create a reference node.rQT)internalrefid#refurireftitle)r referenceget_relative_uri)rr(r)rr*r[r*s r' make_refnoder5os ?2rD 1 1 1DiH W  N((i@@3FQ NN%55k9MMDN ! ZEMD Kr) directiverc^|j|j\|_|_dSr$) state_machineget_source_and_linelinenorWrX)r6r*s r'set_source_infor;s-&4HHDKr)inlinerrr:cN|jj}||\|_|_dSr$)reporterr9rWrX)r<r:r*gsals r'set_role_source_infor@s'   /D!T&\\DKr)srcdstctjt5t||_t ||_ddddS#1swxYwYdSr$)rdrerfrgrWrrX)rArBs r'copy_source_inforDs  Z ( (&&$S))  %%&&&&&&&&&&&&&&&&&&s)AAAct|jD]5}t|trdS|dddurdS6t |ddduS)z0Check whether the node is smart-quotable or not.Fsupport_smartquotesN)rrVr-NON_SMARTQUOTABLE_PARENT_NODESr/getattr)r*rs r'is_smartquotablerIsu -- e; < < 55 99*D 1 1U : :55 ; 4. 5 5U BBr)tagsrc|tjD]f}t||r.||jpt j@|t jgdS)z0Filter ``only`` nodes which do not match *tags*.N)r8r only_only_node_keep_children replace_selfrsr comment)rrJr*s r'process_only_nodesrPs  //// #D$ / / /   dm>u} ? ? ? ?   emoo . . . .//r) addnodes.onlyc ||dS#t$r5}tt d||Yd}~dSd}~wwxYw)z%Keep children if tags match or error.exprz8exception while evaluating only directive expression: %s)rNT)eval_conditionr0rTrr )r*rJerrs r'rMrMsz""4<000  I J J     ttttt s A*AAelct|j}g|_|j|_|j|_d|jD|_|j|_|j |_ |S)zMonkey-patch ```nodes.Element.copy``` to not copy the ``_document`` attribute. See: https://github.com/sphinx-doc/sphinx/issues/11116#issuecomment-1376767086 c6i|]\}}||dvr|n |ddS)>rnamesr%backrefsdupnamesNr?).0rvs r' z*_copy_except__document..sJ Aq MMMAASTUVUVUVSWr)) object__new__rCrsrStagname attributesr.rXrW)rVnewnodes r'_copy_except__documentrdsz nnR\**GG GjGOM''))G7GLYGN Nr)c|}d|jD|_|jD]L}||_|jr<|j|_|j|jj|_|j|jj|_M|S)z4Monkey-patch ```nodes.Element.deepcopy``` for speed.c6g|]}|Sr?)r)r\r*s r' z_deepcopy..s"BBBU((BBBr))copyrsrVrrWcurrent_sourcerX current_line)rVrcr*s r' _deepcopyrksggiiGBBbkBBBG!66 ; 6[EN|#!{9 z![5 Nr))r*r r!r@)rF)r*r rGrHr!r@)r*rr!r"r:)rvrr!rw)r*rr!r@)r*rr!rHr$)r*rrrr!r)r*r r!r)rvrr!r)r) rrr{rr*r rrHr!r@)rMr@r!r)rr@rr@r!r)rQ)rrrrrr@rrrrrrrr@r!r)rr@r!r@)rQN) rrrrrr@r\rr!r@)r*r!r"r@r!r#)rrr(r@r)r@rrr*r+r[rr!r,)r6rr*r r!r")r<rr:rHr*r r!r")rArrBrr!r")rr rJrr!r")r*rQrJrr!r+)rVrr!r)er> __future__rrdr_rtypingrrrrrdocutilsr docutils.nodesr sphinxr sphinx.localer sphinx.utilr sphinx.util.parsingrcollections.abcrrrrdocutils.parsers.rstrdocutils.parsers.rst.statesrrdocutils.statemachinersphinx.buildersrsphinx.environmentrsphinx.util.tagsr getLoggerr;rTcompileDOTALLrcaption_ref_rerrrErNrk Invisiblerc doctest_blockversionmodifiedrrru math_blockrrrZIMAGE_TYPE_NODESrrgrrrrrrrrrrrrrrrr r'r5r;r@rDFixedTextElementliteralmath problematicnot_smartquotablerGrIrPrMrdrhrkrr?r)r'rs99"""""" ==============:::::: &<<<<<<<<<<&&&&&&......========000000''''''333333%%%%%%  8 $ $BJ?KK" GCt9#9#9#9#9#'!*9#9#9#x::::&ZZZZ| O     /(/(/(/(f    I  K :    MN"F E E 1111v11111h6 ,-- "*-.." C" C" C" C "  C "  C " C" C" C" C" C" C" C" C" C"  C!"" C#""$ C%"& C'"( C)"* C+", C-". C/"0 C1"2 C3"4 C5"6 C7"8 C9": C;"< C="> C?"@ CA"B CC""H       <    & 2 **** &&&&  M J K I  "CCCC / / / /    *,     # r)