}c[dZddlZddlZddlmZmZmZmZmZm Z m Z m Z m Z m Z mZddlmZddlmZmZddlmZddlmZddlmZdd lmZdd lmZdd lmZerdd l m!Z!dd l"m#Z#ddl$m%Z%ddl&m'Z'ej(e)Z*ej+dej,Z-e-Z.GddZ/dede0fdZ1ddede2de0fdZ3deddfdZ4ej5ej6ej7ej8fZ9dede:fdZ;dede:fdZfZ?ej@fZAejBfZCdedee ee0ffdZDdede e0fdZEdede e2fdZFdded edeefd!ZGdede efd"ZHdedee eed#ffd$ZId%ed&edede0fd'ZJdede0fd(ZKd)e0de e:e0e0ffd*ZLgd+ZMd,e0d-e0dee e0e0e0e0e e0ffd.ZNd/d0d1e e0d2e0d3ejOd4ed5ee0dejOfd6ZPd7e0de0fd8ZQej+d9ZRej+d:ZSid;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdHdJdKdLd>dMdNdOdPdQdDdRdSdTdUdVdFdWdFidXdYdZd[d\d]d^d[d_dDd`dSdadFdbdcdddKdedfdgd[dhdidjdcdkdldmdndodYZTdpdqdrdsdtduZU ddwdxdyejOdze0d{e0de0f d|ZVdejWd}e0de efd~ZX dd/d0de0de0d-e0de eeefde0dejYfdZZdededdfdZ[dede2deddfdZ\dededdfdZ]ej^ej_ej`ej@ej>ejaejbfZcdede:fdZddyeddddfdZededefdZfefej_gdS)z3Docutils node-related utility functions for Sphinx.N) TYPE_CHECKINGAnyCallableIterableListOptionalSetTupleTypeUnioncast)nodes)ElementNode) Directive)Inliner) StringList)addnodes)__)logging)Builder) IndexEntry)BuildEnvironment)Tagsz^(.+?)\s*(?$cReZdZdZdeededdfdZdedefdZ dedefd Z dS) NodeMatchera"A 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 typing import Any matcher = NodeMatcher(nodes.reference, refdomain=Any) doctree.findall(matcher) # => [, , ...] node_classesattrsreturnNc"||_||_dSN)classesr)selfrrs 1lib/python3.11/site-packages/sphinx/util/nodes.py__init__zNodeMatcher.__init__6s#  nodecD |jrt||jsdS|jrht|tjsdS|jD]2\}}||vrdS|t ur|||krdS3dS#t$rYdSwxYw)NFT) r" isinstancerrritemsrget Exception)r#r'keyvalues r$matchzNodeMatcher.match:s | JtT\$B$B uz %!$ 66! 5"&*"2"2"4"4%%JC$%$uu#% #%/%$uu%4   55 s(B!B#B($BB BBc,||Sr!)r/)r#r's r$__call__zNodeMatcher.__call__Pszz$r&) __name__ __module__ __qualname____doc__r rrr%boolr/r1r&r$rr s*d4j34$4, T d      r&rr'rcLd|j|jjS)z Return full module dotted path like: 'docutils.nodes.paragraph' :param nodes.Node node: target node :return: full module dotted path z{}.{})formatr3 __class__r2r's r$get_full_module_namer<Ts >>$/4>+B C CCr&Plengthc |}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,strlen)r'r>texts r$ repr_domxmlrE^s}zz||!!## 4yy %#d))f$%GVG}u$ Ks&)AAct|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|tjr|j t/||_ |js| |_|j r |jrdSt|tjtj tj tjfrUtdt |t|t/|pd|_ d |_ 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 rawsourceloggerdebugr<rEparentsourcelineastextimagetitletermreversedlistfindallresubescapetopic literal_blockget_node_sourcerubric field_name)r'definition_list_itemrIs r$apply_source_workaroundr`rs $()) )$. ) N)$//T1B1B D D D#{*1 (-1  D%* + +)DK)k( $ $$FF @)$//T1B1B D D D!%!3T[5E TY$ $$FF :)$//T1B1B D D D!%!3T[5E TY$ ##8 =)$//T1B1B D D D#4 (;(;E' {t~ 4 L J K        C)$//T1B1B D D D%d++1r    r&ct|tjr*B*Bdhhuoot$ %%.*Du$)**{  LLD-d33[5F5F H H H5 dM * * ~T/I  LL;-d33[5F5F H H H5xx--  LLN-d33[5F5F H H H5 dE, - - $-2Bh2N  LLA-d33[5F5F H H H5tt 4 ? ?t D(0 1 1t 5r&doctreec#LK|tD]}t|tjr|D]}||fV ;t|t r|j}|s|}nt|tj rE| dr ||dfV| dr d|dz}nd}nt|tr|j }nt|tjr(t|r|jddj }nPt|tjr |d}n-|jd d }|r||fVd S) z3Extract translatable messages from a document tree.rhrgz .. image:: %surirHrrcontent  N)rVror)rrgextract_original_messagesLITERAL_TYPE_NODESrJrPrrQr+META_TYPE_NODES rawcontentrbrercrnreplacestrip)rpr'msgs r$extract_messagesr}s00 dH1 2 2 5577  Ci  d. / / <.C $kkmm ek * * <xx (DK''''xx'' %U 3 o . . </CC em , , <1F1F <,w'*5CC h4 5 5 <y/CC.((s3399;;C  )OOO=r&cJt|D]}|jr |jcSdSr!)traverse_parentrNr'pnodes r$r\r\s; &&   < <    4r&cJt|D]}|jr |jcSdSr!)rrOrs r$ get_node_liner&s; && : :     4r&clsc#PK|r!|t||r|V|j}|dSdSr!)r)rM)r'rs r$rr-sU   *T3// JJJ{ r&cf|j|}|dkr|j|dz SdS)NrrG)rMindex)r'poss r$ get_prev_noder4s9 +  D ! !C Qw{37##tr&rc#Kttjd}||D]}d|vr |d}n|d}||fVdS)z6Traverse translatable index node from a document tree.F)inline raw_entriesentriesN)rrrrV)rpmatcherr'rs r$traverse_translatable_indexr<st(.777G(( D  &=)GG9oGGm r&statersc|jj}|jj}g|j_d|j_ ||d|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. rrG) match_titles)memo title_styles section_level nested_parse)rrsr'surrounding_title_stylessurrounding_section_levels r$nested_parse_with_titlesrGs %z6 % 8 EJ EJ=!!'1d!CC": #<   #; #<  <<<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-rurH) translate_non_id_translate_digraphs_non_id_translate unicodedata normalizeencodedecode _non_id_charsrXjoinr_non_id_at_endsrB)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)iSi8i9rHrrrprefixrScd}|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%srH)settings id_prefixrids new_serialno)rrrrSnode_ididformats r$make_idrsG @E>%/744?$8d?++ f  G 4.. b= G 6W 46S--f555 6W 46 Nr& conditionc~|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 r$find_pending_xref_conditionrsP w ? @ @  K((I5 NNNtr& fromdocname todocnamechildrRctjddd}||kr|r||d<n;|r |||dz|z|d<n||||d<|r||d<||z }|S)z$Shortcut to create a reference node.rHT)internalrefid#refurireftitle)r referenceget_relative_uri)rrrrrrRr's r$ make_refnoder (s ?2rD 1 1 1DiNHN W  N%66{INN!"$,-DNN%55k9MMDN ! ZEMD Kr& directivec^|j|j\|_|_dSr!) state_machineget_source_and_linelinenorNrO)r!r's r$set_source_infor&:s*33I4DEEDKr&inlinerr%cT|j|\|_|_dSr!)reporterr$rNrO)r'r%r's r$set_role_source_infor*?s%$-AA&IIDKr&srcdstcVt||_t||_dSr!)r\rNrrO)r+r,s r$copy_source_infor.Cs$ %%CJS!!CHHHr&ct|jD]5}t|trdS|dddurdS6t |dddurdSdS)z0Check whether the node is smart-quotable or not.Fsupport_smartquotesNT)rrMr)NON_SMARTQUOTABLE_PARENT_NODESr+getattrrs r$is_smartquotabler3Ss -- e; < < 55 YY,d 3 3u < 55 t*D11U:u 4r&tagsrc |tjD]} ||d}|r.||jpt jN|t ju#t$ra}t td||||jpt jYd}~d}~wwxYwdS)z0Filter ``only`` nodes which do not match *tags*.exprz8exception while evaluating only directive expression: %srN) rVronlyeval_condition replace_selfrmrcommentr,rKrr)rr4r'reterrs r$process_only_nodesr=as  //33 3%%d6l33C  3!!$-"B5=??CCCC !!%-//2222 @ @ @ NN2XYY[^$(  * * *   dm>u} ? ? ? ? ? ? ? ? @33sB DAC;;Dr#c|j|jfi|j}t|tjr|j|_|j|_|S)zmonkey-patch Element.copy to copy the rawsource and line for docutils-0.16 or older versions. refs: https://sourceforge.net/p/docutils/patches/165/ )r:rJ attributesr)rrrNrO)r#newnodes r$ _new_copyrAusL dnT^??t??G$ &&!y Nr&)r=r!)rHN)hr5rWrtypingrrrrrrr r r r r docutilsrdocutils.nodesrrdocutils.parsers.rstrdocutils.parsers.rst.statesrdocutils.statemachinersphinxr sphinx.localer sphinx.utilrsphinx.buildersr sphinx.domainrsphinx.environmentrsphinx.util.tagsr getLoggerr2rKcompileDOTALLrcaption_ref_rerrBr<intrEr` Invisibler[ doctest_blockversionmodifiedrlr6rero math_blockrrwrQIMAGE_TYPE_NODESrdrxr}r\rrrrrrrrrrrrrrrrr pending_xrefrrr r&r*r.FixedTextElementliteralmath problematicnot_smartquotabler1r3r=rAcopyr7r&r$r`sY 99 !!!!!!!!!!!!!!!!!!!!!!!!!!((((((((******//////,,,,,,&''''''((((((333333%%%%%%  8 $ $BJ?KK"1 1 1 1 1 1 1 1 hDtDDDDDdC(;';d;;;;~ O     $4*$*4****\    I  K M g (5#3F*G    F'hsmHSM'x7H$XeGTR^M_D_>`5a=C=*=D=S====&w3suT3^'< $s$c$!%S#sHSM(I"JK$$$$NC3#n9ANRSVi"^DSS6 ,-- "*-.." 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      +/#u~$'364h&;%-g%6?C)##QTdDJ./8;GL$FyFFFFFF J'J3JdJtJJJJ"'""D""""   M J K I  " 4 D    33V33333( G      r&