P&i[dZddlZddlZddlmZmZmZmZmZm Z m Z m Z m Z m Z ddlmZddlmZmZddlmZddlmZddlmZdd lmZdd lmZdd lmZerdd lm Z dd l!m"Z"ddl#m$Z$ddl%m&Z&ej'e(Z)ej*dej+Z,e,Z-GddZ.dede/fdZ0ddede1de/fdZ2deddfdZ3ej4ej5ej6ej7fZ8dede9fdZ:dede9fdZ;ej5ej6ej<ej=fZ>ej?fZ@ejAfZBdedee ee/ffdZCdede e/fdZDdede e1fdZEdded edeefd!ZFdede efd"ZGdedee eed#ffd$ZHd%ed&edede/fd'ZIdede/fd(ZJd)e/de e9e/e/ffd*ZKgd+ZLd,e/d-e/dee e/e/e/e/e e/ffd.ZMd/d0d1e e/d2e/d3ejNd4ed5ee/dejNfd6ZOd7e/de/fd8ZPej*d9ZQej*d:ZRid;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdHdJdKdLd>dMdNdOdPdQdDdRdSdTdUdVdFdWdFidXdYdZd[d\d]d^d[d_dDd`dSdadFdbdcdddKdedfdgd[dhdidjdcdkdldmdndodYZSdpdqdrdsdtduZT ddwdxdyejNdze/d{e e/de/f d|ZUdejVd}e/de efd~ZW dd/d0de/de/d-e/de eeefde e/dejXfdZYdededdfdZZdede1deddfdZ[dededdfdZ\ej]ej^ej_ej?ej=ej`ejafZbdede9fdZcdyeddddfdZddedefdZeeeej_fdS)z3Docutils node-related utility functions for Sphinx.N) TYPE_CHECKINGAnyCallableIterableListOptionalSetTupleTypeUnion)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 ^/home/geonatureadmin/si_en_reseau/tutos/venv/lib/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! isinstancerr ritemsrget Exception)r"r&keyvalues r#matchzNodeMatcher.match:s | JtT\$B$B uz %!$ 66! 5"&*"2"2"4"4%%JC$$uu# #%//$uu04   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.r0r%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{}.{})formatr2 __class__r1r&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_domxmlrD^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;rDparentsourcelineastextimagetitletermreversedlistfindallresubescapetopic literal_blockget_node_sourcerubric field_name)r&definition_list_itemrHs r#apply_source_workaroundr_rs $()) )$. ) 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%d++1r    r%ct|tjr*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 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.rgrfz .. image:: %surirGr rcontent  N)rUrnr(rrfextract_original_messagesLITERAL_TYPE_NODESrIrOr rPr*META_TYPE_NODES rawcontentrardrbrmreplacestrip)ror&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_parentrMr&pnodes r#r[r[s; &&   < <    4r%cJt|D]}|jr |jcSdSr )r~rNrs r# get_node_liner&s; && : :     4r%clsc#PK|r!|t||r|V|j}|dSdSr )r(rL)r&rs r#r~r~-sO  ;*T3//;JJJ{ r%cf|j|}|dkr|j|dz SdS)NrrF)rLindex)r&poss r# get_prev_noder4s6 +  D ! !C Qww{37##tr%rc#Kttjd}||D]}d|vr |d}n|d}||fVdS)z6Traverse translatable index node from a document tree.F)inline raw_entriesentriesN)rrrrU)romatcherr&rs r#traverse_translatable_indexr<sr(.777G(( D =)GG9oGGm r%staterrc|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. rrF) match_titles)memo title_styles section_level nested_parse)rrrr&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-rtrG) translate_non_id_translate_digraphs_non_id_translate unicodedata normalizeencodedecode _non_id_charsrWjoinr_non_id_at_endsrA)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)iSi8i9rGrrdocumentprefixrRcd}|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%srG)settings id_prefixrids new_serialno)rrrrRnode_ididformats r#make_idrsG @E>%/744?$8d?++ f  G 4.. b==G /W 44S--f555 /W 44 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_conditionrsN w ? @ @  K((I55NNNtr% fromdocname todocnamechildrQctjddd}||kr|r||d<n;|r |||dz|z|d<n||||d<|r||d<||z }|S)z$Shortcut to create a reference node.rGT)internalrefid#refurireftitle)r referenceget_relative_uri)rrrrrrQr&s r# make_refnoder(s ?2rD 1 1 1DiH W  N%66{INN!"$,-DNN%55k9MMDN ! ZEMD Kr% directivec^|j|j\|_|_dSr ) state_machineget_source_and_linelinenorMrN)r r&s r#set_source_infor%;s*33I4DEEDKr%inlinerr$cT|j|\|_|_dSr )reporterr#rMrN)r&r$r&s r#set_role_source_infor)@s%$-AA&IIDKr%srcdstcVt||_t||_dSr )r[rMrrN)r*r+s r#copy_source_infor-Ds$ %%CJS!!CHHHr%ct|jD]5}t|trdS|dddurdS6t |dddurdSdS)z0Check whether the node is smart-quotable or not.Fsupport_smartquotesNT)r~rLr(NON_SMARTQUOTABLE_PARENT_NODESr*getattrrs r#is_smartquotabler2Ts -- 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) rUronlyeval_condition replace_selfrlr commentr+rJrr)rr3r&reterrs r#process_only_nodesr<bs  //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/ )r9rI attributesr(r rrMrN)r"newnodes r# _new_copyr@vsL dnT^??t??G$ &&!y Nr%)r<r )rGN)gr4rVrtypingrrrrrrr r r r docutilsr docutils.nodesrrdocutils.parsers.rstrdocutils.parsers.rst.statesrdocutils.statemachinersphinxr sphinx.localer sphinx.utilrsphinx.buildersr sphinx.domainrsphinx.environmentrsphinx.util.tagsr getLoggerr1rJcompileDOTALLrcaption_ref_rerrAr;intrDr_ InvisiblerZ doctest_blockversionmodifiedrkr5rdrn math_blockrrvrPIMAGE_TYPE_NODESrcrwr|r[rr~rrrrrrrrrrrrrrr pending_xrefrrrr%r)r-FixedTextElementliteralmath problematicnot_smartquotabler0r2r<r@copyr6r%r#r_sX 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      59#u~$,SM=@4h&;%-g%6IM)##QTdDJ./8@ o&FyFFFFFF J'J3JdJtJJJJ"'""D""""   M J K I  " 4 D    33V33333( G      r%