7 fX_RdZddlmZddlZddlZddlZddlmZmZm Z ddl m Z ddl m Z ddlmZddlmZer2dd lmZdd lmZmZdd lmZdd lmZdd lmZddlmZddlm Z ddl!m"Z"ej#e$Z%ej&dej'Z(e(Z)GddZ*ddZ+dddZ,ddZ-e j.e j/e j0e j1fZ2dd!Z3e j/e j0e j4e j5fZ6e j7fZ8dd$Z9dd%Z:dd&Z;ddd*Z ddd3Z?dd4Z@dd7ZAgd8ZBdd<ZCddHZDddJZEej&dKZFej&dLZGidMdNdOdPdQdRdSdTdUdVdWdXdYdZd[dZd\d]d^dPd_d`dadbdcdVdddedfdgdhdXdidXidjdkdldmdndodpdmdqdVdrdedsdXdtdudvd]dwdxdydmdzd{d|dud}d~ddddkZHddddddZI dddZJddZK dddZLddZMddZNddZOe jPe jQe jRe j7e j5e jSe jTfZUddZVddZWddZXddZYeYe j_ZddZ[e[e j_\dS)z3Docutils node-related utility functions for Sphinx.) annotationsN) TYPE_CHECKINGAnyCallable)nodes)addnodes)__)logging)Iterable)ElementNode) Directive)Inliner) StringList)Builder)BuildEnvironment)Tagsz^(.+?)\s*(?$c*eZdZdZddZdd Zdd ZdS) NodeMatcheraTA 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') doctree.findall(matcher) # => [, , ...] A special value ``typing.Any`` matches any kind of node-attributes. For example, following example searches ``reference`` node having ``refdomain`` attributes:: from __future__ import annotations from typing import TYPE_CHECKING, Any matcher = NodeMatcher(nodes.reference, refdomain=Any) doctree.findall(matcher) # => [, , ...] node_classes type[Node]attrsrreturnNonec"||_||_dSN)classesr)selfrrs G/var/www/equiseq/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 isinstancerrr itemsrget Exception)rr"keyvalues rmatchzNodeMatcher.match?s | JtT\$B$B uz %!$ 66! 5"&*"2"2"4"4%%JC$$uu# #%//$uu04   55 s(B!B#B($BB BBc,||Sr)r+)rr"s r__call__zNodeMatcher.__call__Uszz$r!N)rrrrrrr"r rr#)__name__ __module__ __qualname____doc__r r+r-r!rrr$sZ,,      r!rr"r rstrc.|jd|jjS)z Return full module dotted path like: 'docutils.nodes.paragraph' :param nodes.Node node: target node :return: full module dotted path .)r0 __class__r/r"s rget_full_module_namer9Yso 9 9 7 9 99r!Plengthintc |}n#t$rt|}YnwxYw|r t ||kr |d|dz}|S)a return DOM XML representation of the specified node like: 'New 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...)asdomtoxmlr(r4len)r"r;texts r repr_domxmlrBcs{zz||!!## 4yy %#d))f$$GVG}u$ Ks&)AAr rct|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 tj tjfrltdt |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 rawsourceloggerdebugr9rBparentsourcelineastextimagetitletermreversedlistfindallresubescapetopic literal_block contextlibsuppress ValueErrorget_node_sourcerubric field_name)r"definition_list_itemrFs rapply_source_workaroundr`ws $()) )$. ) N)$//T1B1B D D D#{*1 (-1  D%* + +)DK)k( $ $$F)< @)$//T1B1B D D D!%!3T[5E TY$ $$F)< :)$//T1B1B D D D!%!3T[5E TY$ ##8 =)$//T1B1B D D D#4 (;(;E' {t~ 4 L J K        C)$//T1B1B D D D )$//DKK   DKKK    s$M''M+.M+P**P>=P>r#ct|tjrdSt|tjr,|ds|drdSt|tjrd|vrdSt|tjrC|js8t dt|t|dSt|tr*B*Bdhhuoot$ %%.*D*Du$)**{  LLD-d33[5F5F H H H5 dM * * ~T/I/I LL;-d33[5F5F H H H5xx--  LLN-d33[5F5F H H H5 dE, - - $-2Bh2N2N LLA-d33[5F5F H H H5t$ ##t 5r!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.rcrb original_uriuriz .. image:: rEcontent  N)rSrjr%rrbextract_original_messagesLITERAL_TYPE_NODESrGrMrrNr'rireplacestrip)rkr"msg image_uris rextract_messagesryss00 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_parentrKr[r"pnoderws rr\r\sG &&   < <    !C S//r!cht|D]}|jr |jcSd}t|)Nznode line not found)r{rLr[r|s r get_node_linersG && : :     C S//r!clsrIterable[Element]c#PK|r!|t||r|V|j}|dSdSr)r%rJ)r"rs rr{r{#sO  ;*T3//;JJJ{ r! Node | Nonecf|j|}|dkr|j|dz SdS)NrrD)rJindex)r"poss r get_prev_noder*s6 +  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)rrrrS)rkmatcherr"rs rtraverse_translatable_indexr2st(.777G(( D =)GG9oGGm r!staterprcontent_offsetc|jj}|jj}g|j_d|j_ ||||d||j_||j_S#||j_||j_wxYw)zVersion 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. rrD) match_titles)memo title_styles section_level nested_parse)rrpr"rsurrounding_title_stylessurrounding_section_levels rnested_parse_with_titlesr?s %z6 % 8 EJ EJ=!!'>4a!PP": #<   #; #<  <<<E  4FFstringc|t}|t}tjd|ddd}tdd | }td|}t|S)aConvert `string` into an identifier and return it. This function is a modified version of ``docutils.nodes.make_id()`` of docutils-0.16. Changes: * Allow to use capital alphabet characters * Allow to use dots (".") and underscores ("_") for an identifier without a leading character. # Author: David Goodger # Maintainer: docutils-develop@lists.sourceforge.net # Copyright: This module has been placed in the public domain. NFKDasciiignore-rrrE) translate_non_id_translate_digraphs_non_id_translate unicodedata normalizeencodedecode _non_id_charsrUjoinr_non_id_at_endsr4)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)iSi8i9rErrdocumentprefixrP str | Nonecd}|r|dz}n|jjpddz}|r|rt||z}||krd}n|rt|}|dkrd}| ||jvr#|||z}|||jv#|S)z>Generate an appropriate node_id for given *prefix* and *term*.Nz-%srz%srE)settings id_prefixrids new_serialno)rr r rPnode_ididformats rmake_idrsG @E>%/744?$8d?++ f  G 4.. b==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.rN)r%rpending_xref_conditionr')r"rsubnodes rfind_pending_xref_conditionrsN w ? @ @  K((I55NNN 4r! fromdocname todocnamechildNode | list[Node]rOnodes.referencectjddd}||kr|r||d<n;|r |||dz|z|d<n||||d<|r||d<||z }|S)z$Shortcut to create a reference node.rET)internalrefid#refurireftitle)r referenceget_relative_uri)rrrrr rOr"s r make_refnoder+$s ?2rD 1 1 1DiH W  N%66{INN!"$,-DNN%55k9MMDN ! ZEMD Kr! directiverc^|j|j\|_|_dSr) state_machineget_source_and_linelinenorKrL)r,r"s rset_source_infor17s*33I4DEEDKr!inlinerrr0cN|jj}||\|_|_dSr)reporterr/rKrL)r2r0r"gsals rset_role_source_infor6<s'   /D!T&\\DKr!srcdstctjt5t||_t ||_ddddS#1swxYwYdSr)rYrZr[r\rKrrL)r7r8s rcopy_source_infor:As  Z ( (&&$S))  %%&&&&&&&&&&&&&&&&&&s)AAAct|jD]5}t|trdS|dddurdS6t |dddurdSdS)z0Check whether the node is smart-quotable or not.Fsupport_smartquotesNT)r{rJr%NON_SMARTQUOTABLE_PARENT_NODESr'getattr)r"r}s ris_smartquotabler?Rs -- e; < < 55 99*D 1 1U : :55 ;t*D11U::u 4r!tagsrc|tjD]f}t||r.||jpt j@|t jgdS)z0Filter ``only`` nodes which do not match *tags*.N)rSronly_only_node_keep_children replace_selfrhrcomment)r r@r"s rprocess_only_nodesrF`s  //// #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: %srNT)eval_conditionr(rHrr )r"r@errs rrCrCmsz""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. xref: https://github.com/sphinx-doc/sphinx/issues/11116#issuecomment-1376767086 c6i|]\}}||dvr|n |ddS)>rnamesrbackrefsdupnamesNr3).0rvs r z*_copy_except__document..sL===#a!"*]!]!] a#$QQQ4===r!) object__new__r7rhrGtagname attributesr&rLrK)rLnewnodes r_copy_except__documentrZys| nnR\**GG GjGO==')m&9&9&;&;===G7GLYGN Nr!c|}d|jD|_|jD]L}||_|jr<|j|_|j|jj|_|j|jj|_M|S)z4Monkey-patch ```nodes.Element.deepcopy``` for speed.c6g|]}|Sr3)r)rRr s r z_deepcopy..s"BBBU((BBBr!)copyrhrJr rKcurrent_sourcerL current_line)rLrYr s r _deepcopyrasggiiGBBbkBBBG!66 ; 6[EN|#!{9 z![5 Nr!)r"r rr4)r:)r"r r;r<rr4)r"r rrr.)rkr rrl)r"r rr4)r"r rr<r)r"r rrrr)r"r rr)rkr rr)r) rrrprr"r rr<rr4)rAr4rr)rr4rr4rr)rrrrrr4rrrrrrrr)rr4rr4)rEN) rrr rr r4rPrrr4)r"rrr4rr)rrrr4rr4rrr r!rOrrr")r,rr"r rr)r2rr0r<r"r rr)r7r r8r rr)r r r@rrr)r"rGr@rrr#)rLr rr )]r2 __future__rrYrTrtypingrrrdocutilsrsphinxr sphinx.localer sphinx.utilr collections.abcr docutils.nodesr r docutils.parsers.rstrdocutils.parsers.rst.statesrdocutils.statemachinersphinx.buildersrsphinx.environmentrsphinx.util.tagsr getLoggerr/rHcompileDOTALLrcaption_ref_rerr9rBr` InvisiblerX doctest_blockversionmodifiedrgrj math_blockrrtrNIMAGE_TYPE_NODESryr\rr{rrrrrrrrrrrrrrrr+r1r6r:FixedTextElementliteralmath problematicnot_smartquotabler=r?rFrCrZr^rarr3r!rr~s{99"""""" ////////// &((((((,,,,,,,,......333333000000''''''333333%%%%%%  8 $ $BJ?KK"2 2 2 2 2 2 2 2 j::::(????F O     &&&&T    I  K :    45=====( ((((VD6 ,-- "*-.." 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      264@D&FFFF **** &&&&  M J K I  "     / / / /    *,     # r!