RigdZddlmZddlZddlZddlZddlmZddlm Z m Z m Z ddl m Z ddlmZddlmZdd lmZdd lmZdd lmZe r6dd lmZmZmZdd lmZddlmZddlm Z m!Z!ddl"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)ejTe+Z,ejZdej\Z/e/Z0dZ1dpdZ2dqdrdZ3dsdZ4e jje jle jnejpfZ9dtdZ:e jle jne jve jxfZ=e j|fZ?dudZ@dvdZAdwdZBdxdZCdydzdZDd{dZE d|d ZF d} d~d!ZGdwd"ZHdd#ZIgd$ZJ dd%ZK d dd&ZLdd'ZMejZd(ZNejZd)ZOid*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d7d9d:d;d-dd?d@d3dAdBdCdDdEd5dFd5idGdHdIdJdKdLdMdJdNd3dOdBdPd5dQdRdSd:dTdUdVdJdWdXdYdRdZd[d\d]d^dHZPd_d`dadbdcddZQ d ddeZR ddfZS dy ddgZTddhZUddiZVddjZWe je je je j|e jxe jejfZ]dtdkZ^ddlZ_ddmZ`ddnZaeae j8_bddoZcece j8_dy)z3Docutils node-related utility functions for Sphinx.) annotationsN)StringIO) TYPE_CHECKINGAnycast)nodesNode)addnodes)__)logging)_fresh_title_style_context)CallableIterableIterator)Element) Directive)InlinerRSTState) StringList)Builder)BuildEnvironment)Tagsz^(.+?)\s*(?$c4ddx}fGfdd }|S)NctSNr I/home/agent/.friday_env/lib/python3.12/site-packages/sphinx/util/nodes.pyrr'sT'rc8eZdZWZdZddZddZddZd dZy) 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) # => [, , ...] c ||_||_yr)classesattrs)self node_classesr%s r __init__zNodeMatcher.__init__<s#  rcF |jrt||jsy|jrbt|tjsy|jj D]*\}}||vry|t ur|j||k7s*yy#t$rYywxYw)NFT) r$ isinstancer%rritemsrget Exception)r&nodekeyvalues r matchzNodeMatcher.match@s ||JtT\\$Bzz!$ 6 "&**"2"2"4%JC$$# #%/$ %  s."B&B %B2BBB B B c$|j|Sr)r1)r&r.s r __call__zNodeMatcher.__call__Vszz$rc3TK|j|D]}td|yw)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 r5zNodeMatcher.findallYs- \\$' #EsE" " #s&(N)r'ztype[N]r%rreturnNoner.r r7bool)r.r r7z Iterator[N]) __name__ __module__ __qualname____type_params____doc__r(r1r3r5) .type_paramssr r"r"'s(, #rr"r)r .generic_baser@s @r #rB's'9#9#9#rcL|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_namerGcs% oo a 7 78 99rc |jj}|rt ||kDr|d|dz}|S#t$rt|}Y0wxYw)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...)asdomtoxmlr-strlen)r.lengthtexts r repr_domxmlrOlsZzz|!!##d)f$GV}u$ K 4ys:AAct|tjr||jsptj dt |t||j}|j|_ |jdz |_ |j|_nAt|tjr'|js|jj|_ t|tjrl|j`tj dt |t||jj|jjc|_ |_ t|tjrl|j`tj dt |t||jj|jjc|_ |_ t|tjrtj dt |t|tt!|jj#tjD]L}t%j&dt%j(|jzd|j|_Nt|tj*rl|j`tj dt |t||jj|jjc|_ |_ t|tj,r>|j2t/j0t25t5||_ ddd|js|j|_|jr |jryt|tj6tjtjtj8frBtj dt |t| t5||_ d |_ yy#1swYxYw#t2$rd|_ Yd |_ ywxYw) 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 rawsourceloggerdebugrGrOparentsourcelineastextimagetitletermreversedlistr5resubescapetopic literal_block contextlibsuppress ValueErrorget_node_sourcerubric field_name)r.definition_list_itemrSs r apply_source_workaroundrlsC $(()$.. E  &   ${{*11 (--1  D%** +DKKkk(( $ $)< 7  &   "&!3!3T[[5E5E TY$ $)< 1  &   "&!3!3T[[5E5E TY$ # 4  &   #4 (;(;E>DN $ $)< 7  &   "&!3!3T[[5E5E TY$++,1D   , 0)$/DK 0 >> {{t~~  LL JJ KK       :  &    )$/DK /  0 0> DK  s6Q;Q Q Q:9Q:cht|tjryt|tjr#|j ds|j dryt|tj rd|vryt|tjr|js*tjdt|t|yt|tr.d|vr*tjdt|t|y|j dds*tjdt|t|yt|tjr<|jdd k(r*tjd t|t|yyt|tj S) NT translatablealtFz)[i18n] SKIP %r because no node.source: %szO[i18n] SKIP %r because node is in IGNORED_NODES and no node['translatable']: %sz3[i18n] SKIP %r because not node['translatable']: %srorphanz&[i18n] SKIP %r because orphan node: %s)r*r rnrr[r,Inline TextElementrXrUrVrGrO IGNORED_NODESrjchildrenmetarFs r is_translatablervsS$--.$ $$((>*Bdhhuo$ %.*D$))*{{ LL;$T*D!   dM *~T/I LL2$T*D!   xx- LLE$T*D!   dE,, -4==3Cx3O LL8$T*D!   dEJJ ''rc2d|vrt}|jdD]}|jdd}t|dk(r|\}}t j d|rA|j |jd|j |jd|s!|j |jd|j ||j ||j}|jd d jS) z5Remove trailing backslashes from each line of *text*.\T)keependsrQ)maxsplitz ^[ \t]*\s$z   ) r splitlinesrsplitrLr`r1writerstriplstripgetvaluereplacestrip)rNbufferrYsplitprefixsuffixs r _clean_extracted_messager"s t|OOTO2 #DKKqK1E5zQ!&88M62LLu!56LLu!56LLu!56LL& T"# #$  <<c " ( ( **rc#VK|jtD] }t|tjr|j D]}||f :t|t r|j}|s|j}nt|tjrI|jdr ||df|jdr|jd|d}d|}n:d}n7t|tjr|d}n|j}t|}|s||fyw) z3Extract translatable messages from a document tree.rorn original_uriuriz .. image:: rRcontentN)r5rvr*r rnextract_original_messagesLITERAL_TYPE_NODESrTrZrr[r,rur)doctreer.msg image_urirNs r extract_messagesr?s0 dH11 2557 Ci  d. /..Ckkm ekk *xxDK''xx' HH^T%[A #I;/ ejj )y/C>>D*40C )O3s DD) D)cpt|D]}|js|jcSd}t|)Nznode source not found)traverse_parentrXrgr.pnoders r rhrh]s8 &  <<<<   "C S/rcpt|D]}|js|jcSd}t|)Nznode line not found)rrYrgrs r get_node_lineres8 & ::::  C S/rc#TK|r"| t||r||j}|r!yywr)r*rW)r.clss r rrms*  ;*T3/J{{ s#((ch|jj|}|dkDr|j|dz Sy)NrrQ)rWindex)r.poss r get_prev_noderts3 ++  D !C Qw{{37##rc#Kttjd}|j|D]}d|vr|d}n|d}||fyw)z6Traverse translatable index node from a document tree.F)inline raw_entriesentriesN)r"r rr5)rmatcherr.rs r traverse_translatable_indexr|sU(..7G( D =)G9oGGm sAA crt|5|j|||d}ddd|S#1swYSxYw)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)staterr.content_offsetrets r nested_parse_with_titlesrsB $E *S  .$T RS JS Js,6c$|j}|jtjD]}d|d< t |jtj D]}|j j||jS)z&Like node.astext(), but ignore images.rRro) deepcopyr5rr[r_rawrWremoverZ)r.imgrs r clean_astextrsq ==?D||EKK(E DLL+, # ;;=rctj|}|r#d|jd|jdfSd||fS)z3Split role content into title and target, if given.TrQr{F)explicit_title_rer1group)rNr1s r split_explicit_titlers?  # #D )E U[[^U[[^33 $ r)singlepairdoubletripleseeseealsocg}|j}|}d}|jdrd}|ddj}dD]c}|j|ds|t|dzdj}|dk(rd|}n|d |}t d |||fz}t |t D]U}|j|ds|t|dzdj}|d k(rd }|j||||df|S|jd D]S}|j}d}|jdrd}|ddj}|s>|jd|||dfU|S)NrR!mainrQ)modulekeywordoperatorobject exception statementbuiltin:rzbuilt-in function; z; zT%r is no longer supported for index entries (from entry %r). Use 'pair: %s' instead.rr,r) r startswithrrLr rg indextypesappendr)entrytargetid indexentriesoentryr index_typer0rs r process_index_entryrsACL KKME F D ab   ""    zl!, -#j/A-/0668EY&-eW5%,b0*UE*+CS/ !'"*!I   zl!, -#j/A-/0668EX%#   UHdD I J  %I\\#& IEKKMED$ab ((*   5(D$ G H I rc |j}t|jtjD]}g}t t |d} |dz }| D]} | |vs |j| tj||| zt||| |jj| |||} |j| tj| } | j| _| jt j"D] } d| vs| | d<|j| |j*j-|||S#t$$r'tj't)d| |ddY+wxYw) zwInline all toctrees in the *tree*. Record all docnames in *docnameset*, and output docnames with *colorfunc*. includefilesr})docnamerz+toctree contains ref to nonexisting file %rtoc not_readable)locationtypesubtype)rr_r5r toctreemaprKrrUinfoinline_all_toctreesenv get_doctreeadd start_of_filertrsectionr-warningr rWr)builder docnamesetrtree colorfunc traversedindent toctreenodenewnodesr includefilesubtreesof sectionnodes r rrs ==?DDLL)9)9:;": 3 N ;< # ' )K)+)$$[1KK;)? ?@1"# // <!!GNN;/#00EC#*#3#3CL'*{{5=='AA $K75@K 2AOOC(; )< "";9E":F K!!NNHI#!(" . #s"A*E,FFch|jt}|jt}tjd|j ddj d}tjddj|j}tjd|}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-r}rR) translate_non_id_translate_digraphs_non_id_translate unicodedata normalizeencodedecode _non_id_charsrajoinr_non_id_at_endsrK)stringids r _make_idrs   4 5B ' (B   vr * 1 1'8 D K KG TB   3 4 5B   R $B r7Nrz[^a-zA-Z0-9._]+z^[-0-9._]+|-+$oidi'hi1iiBligtibiiciifikiinipiiiyizigi%i4i5i6i7ji<i?si@iGeiIiKqiMriOszaeoedbqp)iSi8i9cd}|r|dz}n|jjxsddz}|r|rt||z}||k(rd}n|rt|}|sd}|||jvr&||j |z}|||jvr&|S)z>Generate an appropriate node_id for given *prefix* and *term*.Nz-%srz%s)settings id_prefixrids new_serialno)rdocumentrr]node_ididformats r make_idr'bsG E>%%//744?$8d?+ f G 4.G /W 4S--f55 /W 4 Nrcx|D]5}t|tjs|jd|k(s3|cSy)zBPick matched pending_xref_condition node up from the pending_xref. conditionN)r*r pending_xref_conditionr,)r.r)subnodes r find_pending_xref_conditionr,s> w ? ? @ K(I5N  rctjddd}||k(r|r||d<n3|r|j||dz|z|d<n|j|||d<|r||d<||z }|S)z$Shortcut to create a reference node.rRT)internalrefid#refurireftitle)r referenceget_relative_uri)r fromdocname todocnamerchildr\r.s r make_refnoder8s ??2rD 1DiH W ((i@3FQ N%55k9MDN  ZEMD Krch|jj|j\|_|_yr) state_machineget_source_and_linelinenorXrY) directiver.s r set_source_infor>s*&44HHDKrcb|jj}||\}}||_||_yr)reporterr;rXrY)inlinerr<r.gsalrXrYs r set_role_source_inforCs.    / /Du}} ?   emmo ./rc |j|dS#t$r+}tjt d||Yd}~yd}~wwxYw)z%Keep children if tags match or error.exprz8exception while evaluating only directive expression: %s)rNT)eval_conditionr-rUrr )r.rRerrs r rOrOsQ""4<00  I J    s A !AA c^tj|j}g|_|j|_|j |_|j jDcic]\}}||dvr|n|ddc}}|_|j|_|j|_ |Scc}}w)zMonkey-patch ```nodes.Element.copy``` to not copy the ``_document`` attribute. See: https://github.com/sphinx-doc/sphinx/issues/11116#issuecomment-1376767086 >r"namesr$backrefsdupnamesN) r__new__rErtrTtagname attributesr+rYrX)elnewnoder vs r _copy_except__documentrbs nnR\\*GG GjjGOMM'') Aq MMASTUVSWWG77GLYYGN N s&B)c|j}|jDcgc]}|jc}|_|jD]v}||_|js|j|_|j |jj |_|j\|jj|_x|Scc}w)z4Monkey-patch ```nodes.Element.deepcopy``` for speed.) copyrtrrWr$rXcurrent_sourcerY current_line)r_r`r7s r _deepcopyrgsggiG68kkBU(BG!!6 ;;[[EN||#!{{99 zz![[55 6 NCsC)r.r r7rK)P)r.r rMintr7rK)r.rr7r8r9)rNrKr7rK)rrr7zIterable[tuple[Element, str]])r.rr7rK)r.rr7rir)r.rrrr7zIterable[Element])r.r r7z Node | None)rrr7zEIterable[tuple[Element, list[tuple[str, str, str, str, str | None]]]])r) rrrrr.rrrir7ri)rNrKr7ztuple[bool, str, str])rrKrrKr7z+list[tuple[str, str, str, str, str | None]])rR)rrrzset[str]rrKrnodes.documentrzCallable[[str], str]rz list[str]rrKr7rj)rrKr7rK)rRN) rrr$rjrrKr] str | Noner7rK)r.zaddnodes.pending_xrefr)rKr7zElement | None)rrr5rKr6rKrrkr7zNode | list[Node]r\rkr7znodes.reference)r=rr.r r7r8)rArr<rir.r r7r8)rErrFrr7r8)r$r rRrr7r8)r.z addnodes.onlyrRrr7r:)r_rr7r)er? __future__rrer`riortypingrrrdocutilsrdocutils.nodesr sphinxr sphinx.localer sphinx.utilr sphinx.util.parsingrcollections.abcrrrrdocutils.parsers.rstrdocutils.parsers.rst.statesrrdocutils.statemachinersphinx.buildersrsphinx.environmentrsphinx.util.tagsr getLoggerr;rUcompileDOTALLrcaption_ref_rer"rGrOrl Invisiblerd doctest_blockversionmodifiedrsrv math_blockrrr[IMAGE_TYPE_NODESrrrhrrrrrrrrrrrrrrrr'r,r8r>rCrGFixedTextElementliteralmath problematicnot_smartquotablerJrLrSrOrbrdrgrrrr rs9" ++:<<&.=0'3%   8 $BJJ?K"9#x:&Z| OO     /(f    II  KK +:<   J PQ (07IL"F 3 3313z1 111  1 $ 1  1 11h6 ,- "**-." 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 &  MM JJ KK II  "C / *,  # r