-PhdZddlmZddlZddlZddlmZddlmZmZddl m Z ddl m Z ddl mZdd lmZdd lmZdd lmZdd lmZmZdd lmZmZddlmZmZddlmZm Z m!Z!ddl"m#Z#ddl$m%Z%m&Z&m'Z'ddl(m)Z)erLddl*m+Z+m,Z,m-Z-m.Z.m/Z/ddlm0Z0m1Z1m2Z2ddl3m4Z4m5Z5m6Z6ddl m7Z7ddlm8Z8ddl9m:Z:ddl;mZ>ddl?m@Z@mAZAmBZBmCZCe jDeEZFejGdZHejGdZIeZJGddeeKZLGd d!eLZMGd"d#eZNGd$d%eeKZOGd&d'e#ZPGd(d)eeKZQGd*d+e#ZRGd,d-eZSejGd.ZTdXd3ZUdYdAZVGdBdCe#ZWdZd[dGZXGdHdIe#ZYGdJdKeZZGdLdMeZ[d\dUZ\d]dWZ]dS)^zThe standard domain.) annotationsN)copy) TYPE_CHECKINGcast)nodes) directives) StringList)addnodes) pending_xref)ObjectDescription)DomainObjType)___)EmphasizedLiteralXRefRole) docname_joinloggingws_re)SphinxDirective) clean_astextmake_id make_refnode)nested_parse_to_nodes)CallableIterableIteratorMutableSequenceSet)AnyClassVarFinal)ElementNodesystem_message) Directive)desc_signature)Sphinx)Builder)BuildEnvironment)ExtensionMetadata OptionSpec RoleFunction TitleGetterz ((?:/|--|-|\+)?[^\s=]+)(=?\s*.*)z`((~?[\w-]*:)?\w+)`c@eZdZUdZdZded<dZded<dd ZddZdS) GenericObjectzCA generic x-ref directive registered with Sphinx.add_object_type().str indextemplateNz=Callable[[BuildEnvironment, str, desc_signature], str] | None parse_nodesigsignoder'returnc|jr||j||}nA||tj||z }t jd|}|S)N )r4envclearr desc_namersub)selfr5r6names [/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/domains/std/__init__.pyhandle_signaturezGenericObject.handle_signature;s_ ? '??48S'::DD MMOOO x)#s33 3G9S#&&D r?Nonecjt|j|jj|j|}|d||jj||jr|jd}|dkrJ|jd| }|j|dzd |fz}n d}|j|fz}|j d|||ddf|jj j }| |j|||dS) Nids:singleentriesr1location)rr:statedocumentobjtypeappendnote_explicit_targetr3findstrip indexnodedomainsstandard_domain note_object) r>r?r5r6node_idcolon indextype indexentrystds r@add_target_and_indexz"GenericObject.add_target_and_indexEs-$(DJ$7tLLg&&& 00999   Y&++C00E{{ .vv6<<>> !/ <BBDDwN $ !/4'9 N9 % , ,iWbRV-W X X Xh.  dGgFFFFFrBr5r2r6r'r7r2r?r2r5r2r6r'r7rC) __name__ __module__ __qualname____doc__r3__annotations__r4rAr]rBr@r0r05slMMMPTJTTTTGGGGGGrBr0c$eZdZedZdS)EnvVarenvironment variable; %sN)r`rarbrr3rerBr@rgrgZsA011MMMrBrgceZdZdZdd Zd S)EnvVarXRefRolezGCross-referencing role for environment variables (adds an index entry).rNnodes.documentr:r*noder#is_refboolr7'tuple[list[Node], list[system_message]]c |s|ggfS|d}d|dz}tj}d||ddfdtd|z|ddfg|d<t jdd|g}|||||ggfS) N reftargetzindex-%sindexrIr1rhrJrE) new_serialnor rrrrtargetrQ) r>rNr:rlrmvarnametgtidrT targetnodes r@ result_nodeszEnvVarXRefRole.result_nodesas 62: {#S--g666N$$ wr4 0 q344w>r4 P )\"bug666 %%j111:t,b00rBN) rNrkr:r*rlr#rmrnr7ro)r`rarbrcryrerBr@rjrj^s.QQ111111rBrjceZdZUedZded<ejejejejejejdZ ded<dd Z dd Z ddZ ddZ d dZd!dZd"dZdS)#ConfigurationValuez%s; configuration valuer2index_template)zno-indexzno-index-entryzno-contents-entryzno-typesettingtypedefaultClassVar[OptionSpec] option_specr5sig_noder'r7c||tj||z }tjd|}||d<|S)Nr9fullname)r;r r<rr=)r>r5rr?s r@rAz#ConfigurationValue.handle_signaturesIH&sC000yc""# rBtuple[str, ...]c|dfS)Nrre)r>rs r@_object_hierarchy_partsz*ConfigurationValue._object_hierarchy_partss$&&rBcH|dsdS|d\}|S)N _toc_partsr1)get)r>rr?s r@_toc_entry_namez"ConfigurationValue._toc_entry_names,||L)) 2<( rBr?r6rCct|j|jj|j|}|d||jj||j|z}|jdd||ddf|jj j }| |j|||dS)NrErJpairr1rK) rr:rMrNrOrPrQr|rTrUrVrW)r>r?r5r6rX index_entrydomains r@r]z'ConfigurationValue.add_target_and_indexs$(DJ$7tLLg&&& 00999)D0  y!((&+wD)QRRR!14<wIIIIIrB content_nodeaddnodes.desc_contentctj}d|jvr=||jd\}}||||z }d|jvr=||jd\}}||||z }t |jdkr|d|dSdS)z,Insert *type* and *default* as a field list.r}r~rN) r field_listoptions format_typerPformat_defaultlenchildreninsert)r>rrfieldmsgss r@transform_contentz$ConfigurationValue.transform_contents%'' T\ ! !**4<+?@@KE4   e $ $ $ $ J  $ $--dl9.EFFKE4   e $ $ $ $ J z" # #a ' '   : . . . . . ( 'rBtype_(tuple[nodes.field, list[system_message]]c |||j\}}tjdtjdt dtjdg|R}||fS)zFormats the ``:type:`` option.linenor1Type parse_inlinerrr field_namer field_body)r>rparsedrrs r@rzConfigurationValue.format_typesl((t{(CC    R6 + +  R )& ) ) )   d{rBr~c |||j\}}tjdtjdt dtjdg|R}||fS)z!Formats the ``:default:`` option.rr1Defaultr)r>r~rrrs r@rz!ConfigurationValue.format_defaultsl(((EE    R9 . .  R )& ) ) )   d{rBN)r5r2rr'r7r2)rr'r7r)rr'r7r2r_)rrr7rC)rr2r7r)r~r2r7r)r`rarbrr|rdrflagunchanged_requiredrrArrr]rrrrerBr@r{r{vs!566N6666O$/'_$/-0 ))K'''' J J J J / / / /rBr{c>eZdZUdZdZdZdZdZdZiZ de d<d d Z d S)Targetz6Generic target for user-defined cross-reference types.r1FrHrTrrr7 list[Node]c:tjd|jd}t |j|jj|j|}tj dd|g}| ||jj ||g}|j r|j |fz}d}|d}|dkr;|d|}||dzd}tj|||ddfg }|d||j} d|jvr|jdd\} } |jjj} | | ||| |S) Nr9rr1rsrIrFrGrH)rJrK)rr= argumentsrSrr:rMrNr?rruset_source_inforQr3rRr rrrsplitrUrVrW) r>rrXrlretr[rZrYinoder?rr\s r@runz Target.runs9S$."3"9"9";";<<$(DJ$7HMM|B 222 T""" 00666&   !+xk9J IOOC((E{{&vv.4466 ' 4::<< NY GRQU,V+WXXXE JJq% y $)  iooc1--GAth. h$??? rBNr7r) r`rarbrcr3 has_contentrequired_argumentsoptional_argumentsfinal_argument_whitespacerrdrrerBr@rrs]@@MK $(*K****rBrc"eZdZdZd dZd d Zd S) Cmdoptionz1Description of a command-line option (.. option).r5r2r6r'r7cPd}d}|dD]}|}t|}|s+tt d||^|\}}|ddkr|ddkr|d d}d|z}|rS|jj r/|tj d d z }|tj z }n|tj ddz }|tj||z }|jj r(d } |r|ddkr1|ddkr%d } |tj ddz }|d d}ne|ddkr+|tj z }|}n.|ddkr"|tj ddz }|d d }t|D]K} t#| t$jr*|t%j| z }F|| z }L| r|tj ddz }n|tj ||z }|s |}|g|d<n|d||d z }|st,|S)z/Transform an option description into RST nodes.rr1z, znMalformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"rKrG[]N,FTrHr9=allnames)rrSoption_desc_rematchloggerwarningrgroupsconfigoption_emphasise_placeholdersr desc_sig_punctuationdesc_sig_space desc_addnamer< samp_roleparse isinstancerTextastextrP ValueError) r>r5r6count firstnamepotential_optionmoptnameargsadd_end_bracketparts r@rAzCmdoption.handle_signatures # $6 6  /5577 $$%566A 5 %$HHJJMGTr{c!!d2h#oo!#2#,Tz A;<Axrr5r6 currprogramrprefixesprefixrXrdescroptionentrys r@r]zCmdoption.add_target_and_index'sh*..}== {{:r22 + +G#}H - ,,,%%j11 '&&&XXh''Fdh (;VWMMG EN ! !' * * * * 00999!1{{:r22  G  % %Wdh&6q8I      -.//+=EE+,,Ekk*b11  F((((E N9 % , ,q! .      rBNr^)rr2r5r2r6r'r7rC)r`rarbrcrAr]rerBr@rrsC;;====~######rBrc:eZdZUdZdZdZdZdZiZde d<d d Z d S) Programz?Directive to name the program for which options are documented.FrHrTrrr7rctjd|jd}|dkr!|jjddn||jjd<gS)NrrrCr)rr=rrSr:rpop)r>programs r@rz Program.runVsc)C!2!8!8!:!:;; f   H $ $]D 9 9 9 929DH  / rBNr) r`rarbrcrrrrrrdrrerBr@rrMsXIIK $(*K****rBrceZdZdd Zd S)OptionXRefRoler:r*refnoder#has_explicit_titlerntitler2rur7tuple[str, str]cD|jd|d<||fS)Nr)rr)r>r:rrrrus r@ process_linkzOptionXRefRole.process_link`s("%!4!4]!C!C f}rBN r:r*rr#rrnrr2rur2r7rr`rarbrrerBr@rr_s(      rBrz +: +liner2r7tuple[str, str | None]ct|}|d}t|dkr|dnd}||fS)NrrH)_term_classifiers_rerr)rpartstermfirst_classifiers r@split_term_classifiersrosF & &t , ,E 8D#&u::??uQxx ! !!rBr:r* textnodesIterable[Node] index_key str | NonesourcerintrXrNrk nodes.termc tjddg|R}||_||_|}|r|d|nBt ||d|}|d||||jj |||tj } d||d|fg| d<|j|jc| _| _|| |S)Nr1rErrKrImainrJ) rrrrrrPrrQrUrV _note_termr rr) r:rrrrrXrNrtermtextrTs r@make_glossary_termrws  :b" )y ) ) )DDKDI{{}}H, U 7#####x:: U 7###%%d+++K**8Wt*LLL  I%x&)LMIi'+{DI$IinKK  KrBcHeZdZUdZdZdZdZdZdej iZ de d<d d Z d S) GlossaryzVDirective to create a glossary with cross-reference targets for :term: roles. TrFsortedrrr7rc tj}|jj|_d|jv|d<g}d}d}d}g}t |j|jjdD]6\}\}} |s*|r%|r#|ddd|| d}5|rT|d s9| d rd}kd}|ro|sB||jj td || |||| fgtfd}nV|rB||jj td || |r%|dd||| fn||jj td || n|rn|s3d}t|t|z } |r,|dd|| d|| nB||jj td || d}8g} |D]$\} } g}g}| D]\}}} t#|\}}||| \}}t'|j|||| d|jj}||_||||||| r,| jdd}t/|j| |d}ng}|t1jdg|R| t1jdg|R&t1jdg| R}|dd||z }g||S)NrTF)strictrGrHr1rz.. z,glossary term must be preceded by empty line)rrz3glossary terms must not be separated by empty linesz4glossary seems to be misformatted, check indentationr)rXrN)offsetallow_section_headingsclassesglossary)r rrMrNrzipcontentitemsrPisspacerreporterrrr rlstriprrrr: rawsourceextendrr definitiondefinition_list_itemdefinition_list)r>rlrJ in_definition in_comment was_emptymessagesrrr indent_lenrtermsr  termnodessystem_messagesterm_rrsysmsgrrdefinition_nodesdlists r@rz Glossary.runs "" + !T\1XHJ   !&) L$,,T' ' ' F F  "D"66  >W>BKN))"ff=== ; DGOO--; ??5))!%J" !"$  J/77 !"P Q Q'-%+8NNdFF%;$t|dkr|dz }g}d}t|D]"}||krC|||}|t j||d}d|vrM|ddkr#|d\}}|dd} n%|ddkr |dd}|} n |}|} n|}||z} t|dd| } | t j ||dg z } || | }$|t|kr/|t j||d|S) NrrFrH~tokenr\)reftype refdomainrqxrefr) rtoken_refinditerstartrPrrgrouprr literalend) r/r0retnodesposrtxtr3rrrurs r@ token_xrefsrA-s !!CH C   t $ $ 7799s??sQWWYY'C OOEJsOO , , ,  %<<Qx3 ;;s++5qrrqSabb E%-F 7ev    5=x@@@@   eegg SYY 4:../// OrBceZdZUdZdZdZdZdZiZde d<e j dZ d e d <e jdZd%d Zed&dZed'dZd(dZd)d!Zed*d#Zd$S)+ProductionListz&Directive to list grammar productions.FrHrTrrz\\\nr" _nl_escape_rer7rc j}jdjd}|jt|}tttt|| fd|D}tjdg|R}||gS)Nr1r)linesrc Ng|]!\}}}|||"S))rr?tokensr0max_lenrL)make_production).0ruler?rH max_name_len node_locationr0r>s r@ z&ProductionList.run..isX    #dF  !1$& !      rB) _name_getterrDr=r splitlinesr0rlistproduction_definitionsmaxmapr get_locationr productionlistr) r> name_getterrFproduction_lines productionsrlrMrNr0s ` @@@r@rzProductionList.run^s' "&&r4>!+<==HHJJ 00udl0SS ; ;E B BCC3sC 5E$F$FGGHH ))++         '7    &r8K888 T"""v rBrFMutableSequence[str]rdict[str, Any]r2ct|r d|dvrdS|d}|dd|dd<|S)NrFrr1rH)rS)rFrr0s r@r0zProductionList.production_groupxsL uQx2 8>>++9aaarB Iterable[str]Iterator[tuple[str, str, str]]c#K|D]M}d|vrdS|d\}}}|||fVNdS)z6Yield triples of rawsource, name, definition (tokens).rFN) partitionrS)rFrr?rrHs r@rSz%ProductionList.production_definitionssn  5 5D$"nnS11OD!V fllnn4 4 4 4 4  5 5rBrr?rHr0rIrrLaddnodes.productionc6tj||}|r|||||z }|||||t ||z }|t jd|S)N) tokenname)r?r0rLr?rI)r/r0 )r productionmake_name_targetrPseparator_noderArr)r>rr?rHr0rIrLproduction_nodes r@rJzProductionList.make_productions#-i4HHH   t44,r?r0rL name_noderrXobj_namer\s r@rhzProductionList.make_name_targets+D$77 4"244$(DJ$7FF%((( 00IFFF3CM&/////h. 7XFFFrB nodes.Textc|r:tjd|t|z dzStjd|dzzS)z-Return seperator between 'name' and 'tokens'.z ::= r9)rrrjustrres r@rizProductionList.separator_nodesR  F:gmmGc$ii,?!,CDDEE Ez#1-...rBNr)rFr[rr\r7r2)rFr^r7r_)rr2r?r2rHr2r0r2rIrrLr2r7rb)r?r2r0r2rLr2r7rk)r?r2rIrr7rq)r`rarbrcrrrrrrdrecompilerDoperator itemgetterrPr staticmethodr0rSrJrhrirerBr@rCrCOs00K $(*K****&2:g..M....'8&q))L4    \  555\5($///\///rBrCceZdZdd Zd S) TokenXRefRoler:r*rr#rrnrr2rur7rc|d}|js3|ddkr'd|vr|d\}}n |dd}||fS)Nr2rrFrH)rrr)r>r:rrrrurs r@rzTokenXRefRole.process_linkscs##& "58s??e|| ;;s++55abb f}rBNrrrerBr@r{r{s(rBr{c eZdZUdZdZdZeedddeedd deed d d ded deeddeeddeeddddZde d<e e e e e eedZde d<ededeeeejdedejdeddededej d! Zd"e d#<iid$d%ed&fd'd%ed(fd)d%ed*fd+d,d-d.d+d/Zd0e d1<d$ed&fd'ed(fd)ed*fd+Zd2e d3<d4d5d6d7d8d9Zejd:ejd;ejd<dfdC Z dddIZ e!ddKZ" dddQZ#e!ddRZ$dddSZ%e!ddUZ&e!ddWZ'e!ddXZ(ddYZ)dd^Z*dd`Z+ddcZ,ej-ddddnZ.ddvZ/ddwZ0ddyZ1ddzZ2dd{Z3dd|Z4dd}Z5dd~Z6ddZ7ddZ8dddZ9ddZ:ddZ;ddZxZ?S)StandardDomainznDomain for all objects that don't fit into another domain or are added via the application interface. r\rz glossary termrrG) searchprioz grammar tokenr3zreference labelrefkeywordzconfiguration valueconfvalzenvironment variableenvvarzprogram optionrrNdoc)rr3labelrrrrzdict[str, ObjType] object_types)rrrrrrrWzdict[str, type[Directive]]rT) warn_dangling)innernodeclassr) lowercaserr)rr)rr) rrrr3rrnumrefrrz"dict[str, RoleFunction | XRefRole]rolesgenindexr1Index py-modindexz Module Indexsearchz Search Page)rmodindexr)rr1)rr1)rr1) progoptionsobjectslabels anonlabelsr" initial_datadict[str, tuple[str, str]]_virtual_doc_namesz term not in glossary: %(target)rzundefined label: %(target)rzunknown keyword: %(target)rzunknown document: %(target)rzunknown option: %(target)r)rrrrr)figureN)tableN) code-blockNz0dict[type[Node], tuple[str, TitleGetter | None]]enumerable_nodesr:r*r7rCct|t|j|_|jjD]\}}||j|<dSN)super__init__rr _registryr)r>r:rlsettings __class__s r@rzStandardDomain.__init__$su !%  !! ! "m<BBDD 3 3ND(*2D !$ ' ' 3 3rBr?r2rrXrc||jvre|j|||fkrRttd||j|j|d||f|j|<|r|||f|j|<dSdS)aUAdd a hyperlink target for cross reference. .. warning:: This is only for internal use. Please don't use this from your extension. ``document.note_explicit_target()`` or ``note_implicit_target()`` are recommended to add a hyperlink target to the document. This only adds a hyperlink target to the StandardDomain. And this does not add a node_id to node. Therefore, it is very fragile to calling this without understanding hyperlink target framework in both docutils and Sphinx. .. versionadded:: 3.0 (duplicate label %s, other instance in %srN)rrrrr:doc2pathr)r>r?rrXrs r@note_hyperlink_targetz$StandardDomain.note_hyperlink_target.s" 4? " "tt'<'@R'R'R NN=>>!!$/$"7":;;    ")' 2  :!('5 9DK    : :rB&dict[tuple[str, str], tuple[str, str]]c8|jdiS)Nrdata setdefaultr>s r@rzStandardDomain.objectsJsy##Ir222rBNrOlabelidrLr c||f|jvrA|j||fd}ttd|||||jj|f|j||f<dS)zRNote a generic object for cross reference. .. versionadded:: 3.0 rz4duplicate %s description of %s, other instance in %srKN)rrrrr:r)r>rOr?rrLrs r@rWzStandardDomain.note_objectOs T?dl * *l7D=1!4G NNIJJ!    (,x'7&A Wd]###rBc8|jdiS)z2.. note:: Will be removed soon. internal use only.r(rrs r@_termszStandardDomain._termsasy##GR000rBc|d||||jj|f|j|<dS)zeNote a term for cross reference. .. note:: Will be removed soon. internal use only. rN)rWr:rrlower)r>rrrLs r@r zStandardDomain._note_termfsB w999%)X%5w$? DJJLL!!!rB-dict[tuple[str | None, str], tuple[str, str]]c8|jdiS)Nrrrs r@rzStandardDomain.progoptionsos!y## 2   rBdict[str, tuple[str, str, str]]c8|jdiS)Nrrrs r@rzStandardDomain.labelsus!y## b   rBc8|jdiS)Nrrrs r@rzStandardDomain.anonlabels{sy##L"555rBcfd|jD}|D] }|j|= fd|jD}|D] }|j|= fd|jD}|D] }|j|= fd|jD}|D] }|j|= fd|jD}|D] }|j|= dS)Nc,g|]\}\}}|k|SrererKkeyfn_lrs r@rOz,StandardDomain.clear_doc..s-   !C"bwCrBc,g|]\}\}}|k|Srerers r@rOz,StandardDomain.clear_doc..s&UUUmc8BrW}}c}}}rBc,g|]\}\}}|k|Srerers r@rOz,StandardDomain.clear_doc..s&TTTmc8BbGmmcmmmrBc.g|]\}\}}}|k|Srerers r@rOz,StandardDomain.clear_doc..s*XXX/c.s'XXXmc8B"PW--c---rB)rrrrrr)r>r to_remove1key1 to_remove2key2 to_remove3key3s ` r@ clear_doczStandardDomain.clear_docso    %)%5%;%;%=%=    ' 'D &&UUUUt|/A/A/C/CUUU  # #D T""TTTTt{/@/@/B/BTTT  " "D D!!XXXX4;3D3D3F3FXXX  " "D D!!XXXXt/D/D/F/FXXX  & &D%% & &rBdocnamesSet[str] otherdatar\c|dD]\}}|d|vr ||j|<|dD]\}}|d|vr ||j|<|dD]\}}|d|vr ||j|<|dD]\}}|d|vr ||j|<|dD]\}}|d|vr ||j|<dS)Nrrrr(rr)rrrrrr)r>rrrrs r@merge_domaindatazStandardDomain.merge_domaindatasM"=17799 - -ICAw(""(, %"9-3355 ) )ICAw(""$( S!"7+1133 ( (ICAw(""#' C "8,2244 ( (ICAw(""#' C "<06688 , ,ICAw(""'+$ , ,rBrkc x|jD]\}}|s |j|}||j|}t |t jr2d|vr.|j|d}|dd}|jdksd|vs|j dr||j vrOt td|||j |d|||f|j|<|jd kr't!d |d}t#|} n_|jd krt#|} nC||r||pd } | s~nt |t jt jzr"|jrt!d |jd}t |t jt jzrt!d |jd}t |t jt jzrt#|} nOt7|t:jd} | r| dr | d} n||| f|j |<dS)Nrefidnamesrfootnoterefuridesc_rrKsectionz nodes.titlerubricr1z nodes.Elementcaption) nametypesrnameidsrErrrurtagnamerrrrrrrrris_enumerable_nodeget_numfig_titler"rrrr!rrnextfindallr toctree) r>r:rrNr?explicitrrlrsectnamers r@ process_doczStandardDomain.process_docs'066885 ;5 ;ND( &t,G<(D$ -- +'T//|''W 66w-* **t##<**733$ t{""ABBLLT!21!566!  %,W$4DOD !|y((]DG44'..))'--((.. !0066<"tU%:U=M%MNNC C q1ABBDdEK%2L$LMMCq1ABBDdEJ1A$ABB!+D11HH"4<<0@#A#A4HHG!7;;y#9#9!#*9#5! '( :DK  k5 ;5 ;rBrrc<||f|jvr||f|j||f<dSdSr)r)r>rr?rrs r@rz!StandardDomain.add_program_options: T?$"2 2 2/6.@D Wd] + + + 3 2rB) node_class fromdocnamebuilderr)rrolenamertype[nodes.reference]rnodes.referencec |d ddi|} tj||} | d9| dd| dd|z||kr|| d<nGt d} || d<|| d <|||| d <|r| d xxd |zz cc<| | | S) Nr1internalTrr\zstd-r refdocname refsectnamer#r1r1)rinlinerrPr get_relative_uri) r>rrrrrrrrnewnode innernodecontnodes r@build_reference_nodez#StandardDomain.build_reference_nodes *>>d>g>>L844 == # # / i ' ' . . . i ' '(9 : : : k ! !&GG   $B''H%,H\ "&.H] # ' 8 8g N NGH  3!!!S7]2!!!y!!!rBtyprurlr rr#nodes.reference | Nonec |dkr|j}nM|dkr|j}n?|dkr|j}n1|dkr|j}n#|dkr|j}n|dkr|j}n|j}||||||||S)Nrrrrrr)_resolve_ref_xref_resolve_numref_xref_resolve_keyword_xref_resolve_doc_xref_resolve_option_xref_resolve_term_xref_resolve_obj_xref) r>r:rrrrurlrresolvers r@ resolve_xrefzStandardDomain.resolve_xref s %<<-HH H__0HH I  1HH E\\-HH H__0HH F]].HH-Hx['3hOOOrBc|dr3|j|d\}} |} n|j|d\}} } |sdS||||| | dS)N refexplicitrr1r1r1r)rrrrr) r>r:rrrrurlrrrrs r@rz StandardDomain._resolve_ref_xref$s   O $2268DD GW{{}}HH*.)N)N &GWh 4(( '7He   rB nodes.reference | Element | Nonec V||jvr |j|d\}} } n |j|d\}} d} |sdS||j| } | J|| } | dS| dkr9|jjdur+t td||S | ||| || } | |Sn<#t$r/t td| ||cYSwxYw |dr| }n |jj| d }| 0d |vr,t td |||Sd t!t"| }d |vsd |vr1| r|| |}n||}n||z}n{#t&$r7}t td||||cYd}~Sd}~wt($r/t td|||cYSwxYw||||| |dt,j|S)NrrrFz(numfig is disabled. :numref: is ignored.rKzBFailed to create a cross reference. Any number is not assigned: %srr1z{name}zthe link has no caption: %s.number)r?r)rzinvalid numfig_format: %s (%r)zinvalid numfig_format: %sr)rr)rrr get_doctreerEget_enumerable_node_typernumfigrrr get_fignumberrr numfig_formatrrUr2formatKeyError TypeErrorrr number_reference)r>r:rrrrurlrrrfigname target_nodefigtype fignumberrfignumnewtitleexcs r@rz#StandardDomain._resolve_numref_xref>s2 T[ (,  (M(M %GWgg#2268DD GWG 4oog..266w?? &&&// << ?4 i  CJ$5$>$> NN=>>    O **3';WWI !    NNX    OOO  M" B )) 044WbAA8u#4#4r"?@@%RVWWW#c9"5"566u$$E(9(9?#(<#> %v~H    NN344eS4    OOOOOO    NN29::EDN Q Q QOOO ((      0)   s>C666D/.D/3A.H "A&H J,I?J9JJcn|j|d\}} } |sdSt|||| |S)Nr)rrr) r>r:rrrrurlrrrrs r@rz$StandardDomain._resolve_keyword_xrefsC#kooflCC! 4G['7HMMMrBc4|d|}t||d} | |jvrdS|dr|} nt |j| } t j| | dg} t||| d| S)Nrefdocrqrrr7) rrall_docsrrtitlesrrr) r>r:rrrrurlrrrrrs r@rz StandardDomain._resolve_doc_xrefs(K00vtK'899 #, & &4M" <++--&sz'':;; WgwGGGIgtYOO OrBcp|d}|}|j||fd\} } | sFdD]C} | |vr=|| \} } } |j|| fd\} } | rnD| sg}t j|ryt j|d\}}||d|}|j||fd\} } | rnt j|ydSt||| | |S)Nrr)rz[=r9rHr) rrSrrarrrrPrr)r>r:rrrrurlrprognamerrneedlestemrcommands subcommands r@rz#StandardDomain._resolve_option_xrefsg88M**+//60BHMM  +  V##!'!1!1&!9!9JD!Q'+'7';';Xtr:rrrrurlrresultrrs r@rz!StandardDomain._resolve_term_xrefs'' gsFD(    M||~~,,#';v||~~#> #G['7HUUUtrBc||pg}|D]!} | |f|jvr|j| |f\} } n"d\} } | sdSt||| | |S)Nr)objtypes_for_rolerr) r>r:rrrrurlrobjtypesrOrrs r@rz StandardDomain._resolve_obj_xrefs))#..4" & &G DL00#'<#@ 1 & GW 4G['7HMMMrB!list[tuple[str, nodes.reference]]c g}|}dD]A} ||||| | dkr|n|||} | r|d| z| fB|jD]i} | |f} | dkr| |f} | |jvrP|j| \} }d|| z} || t ||| ||fj|S)N)rrrzstd:r)rrrPrrrole_for_objtyper)r>r:rrrurlrresultsltargetroleresrOrrrs r@resolve_any_xrefzStandardDomain.resolve_any_xrefs!68,,..% 5 5D##5==fC 5 s3444(  GF#C&  (dl""#'<#4  5 5g > >> +wRR rB-Iterator[tuple[str, str, str, str, str, int]]c#K|jjD])}|t|jj|d|ddfV*|jD]>\\}}}|r|d|}||d|d|ddfV(||d|d|ddfV?|jD]4\\}}}||||d|d|j|jdfV5|j D]\}\}} } || d || dfVt|j } |j D]\}\}} || vr ||d || dfVdS) Nrr1rGrrrrHrr) r:rrrrrrrattrsrsetr) r>rprogrinforr}r?rr sectionnamenon_anon_labelss r@ get_objectszStandardDomain.get_objects3s8$ N NC|DHOC$8995#r2M M M M M$($4$:$:$<$< G G NT6D G"--V--+tAwQJJJJJfk47DGQFFFFF"&,"4"4"6"6   LT4$QQ!$'-l;     6:[5F5F5H5H C C 1D17G[ WgwB B B B Bdk**(,(=(=(?(? @ @ $D$7G?**D'7GR???? @ @rBFr}rprimaryrnc|jSr)lname)r>r}r9s r@ get_type_namezStandardDomain.get_type_nameNs zrBr$c|j|jvSr)rr)r>rls r@rz!StandardDomain.is_enumerable_nodeRs~!666rBc*||r}td|}|j|jd\}}|r ||S|D]:}t |t jt jzrt|cS;dS)z?Get the title of enumerable nodes to refer them using its titler#NNN) rrrrrrrrrr)r>rlelemr title_gettersubnodes r@rzStandardDomain.get_numfig_titleUs  " "4 ( ( 5 4((D"377 UUOA| 5#|D)))#55G!'5=5;+FGG5+G444445trBcd d}t|tjrdSt|tjrd |vr||tjrd S|j|jd \}}|S)zGet type of enumerable nodes.rlr#clsr}r7rnc:tfd|DS)Nc38K|]}t|VdSr)r)rKchildrDs r@ zMStandardDomain.get_enumerable_node_type..has_child..gs-@@%z%--@@@@@@rB)any)rlrDs `r@ has_childz:StandardDomain.get_enumerable_node_type..has_childfs&@@@@4@@@@@ @rBr literal_blockrr?N)rlr#rDr}r7rn)rrr containerrKrrr)r>rlrJrrs r@r z'StandardDomain.get_enumerable_node_typecs A A A A dEM * * 9 tU_ - - 4'' $ 344( <.224><PPJGQNrBrrtuple[int, ...] | Nonec|dkr}|jdkrdS||jvrtd|ddz}||j|vr |j|dS|j||S |dd}|j|||S#t t f$r }t|d}~wwxYw)NrlatexrerrErr1)r?toc_secnumbersrrtoc_fignumbersr IndexError) r>r:rrrr anchorname figure_idrs r@r zStandardDomain.get_fignumbervs i  |w&&r 222   ;u#5a#88 S%7%@@@-g6::2>>>-g6:::FFF *'.q1 )'27;IFFj) * * *!c) *s&B,,C =CC cH|ddkr|d}tj|d}|r|d||}|rd|}|d|SdSdS)Nr4rrrqrrr)rrrrrr)r>rlrcommandr command_strs r@get_full_qualified_namez&StandardDomain.get_full_qualified_names 88I  ( * *xx ..Hk$((;"7"788G ,q(+++[[]]F !hhw// %00000t4rB)r:r*r7rCr1) r?r2rr2rXr2rr2r7rC)r7rr) rOr2r?r2rr2rLr r7rC)r7r)rr2rr2rLr r7rC)r7r)r7r)rr2r7rC)rrrr\r7rC)r:r*rr2rNrkr7rC) rrr?r2rr2rr2r7rC)rr2rr)rr2rr2rr2rr2rrrr r7r)r:r*rr2rr)rr2rur2rlr rr#r7r)r:r*rr2rr)rr2rur2rlr rr#r7r)r:r*rr2rr)rur2rlr rr#r7r()r7r0)F)r}rr9rnr7r2)rlr$r7rn)rlr$r7r) r:r*rr)rr2rr2rr#r7rM)rlr#r7r)@r`rarbrcr?rrrrrdrrr{rgrrCrrrrjr{rrrrrdangling_warningsrrrLrrrpropertyrrWrr rrrrrrr referencerrrrrrrrrr/r8r<rrr r rX __classcell__)rs@r@r~r~s8 D E/**FrBBB?++WDDD,--uiBOOO70)<<'!!233X>>WQQ/00(;;wqq}}e;;;((L%(..J!.t4448$/// ."" DIIIx5>>8$///xd5<HHH#11E*#R74&AAn,=,=>QQ}%5%56  )+$    L    " 7,"AAn$5$56QQ}--.663/0-.   & _ -J 333333CE:::::8333X3 FJBBBBB$111X1@@@@@   X    X 666X6&&&&.,,,,$8;8;8;8;tAAAA -2O@PPPP6    4S S S S jNNNN PPPP0%N%N%N%NN.NNNN*####J@@@@67777    &****:        rBr~appr(rr rlr bool | Nonec|r |jdks |ddkrdS|d}||jvrtd}ntd}t|||d|ddS) Nr\r4rrqzundefined label: %rzDFailed to create a cross reference. A title or caption not found: %r)rLr}subtypeT)r?rrrr)r^rrlrumsgs r@warn_missing_referencercs  6;%''DOu,D,Dtk" * * **++CCVC sFTtIWWWtrBr+cz|t|dtdddddS)Nzwarn-missing-referencebuiltinrT)version env_versionparallel_read_safeparallel_write_safe) add_domainr~connectrc)r^s r@setuprlsGNN>"""KK(*@AAA"#   rB)rr2r7r)r:r*rrrrrr2rrrXrrNrkr7r rY)r/r2r0r2r7r)r^r(rr rlr r7r_)r^r(r7r+)^rc __future__rrwrurtypingrrdocutilsrdocutils.parsers.rstrdocutils.statemachiner sphinxr sphinx.addnodesr sphinx.directivesr sphinx.domainsr r sphinx.localerr sphinx.rolesrr sphinx.utilrrrsphinx.util.docutilsrsphinx.util.nodesrrrsphinx.util.parsingrcollections.abcrrrrrr r!r"docutils.nodesr#r$r%r&r'sphinx.applicationr(sphinx.buildersr)sphinx.environmentr*sphinx.util.typingr+r,r-r. getLoggerr`rrvrr8rr2r0rgrjr{rrrrrrrrrArCr{r~rcrlrerBr@rs"""""" &&&&&&&&++++++,,,,,,((((((//////********444444444444444444000000AAAAAAAAAA555555RRRRRRRRRRRRRR++++++++++<<<<<<<<<<............))))))''''''333333  8 $ $?@@ 2:, - -     "G"G"G"G"G%c*"G"G"GJ22222]22211111X1110FFFFF*3/FFFR#####_###Leeeee!#&eeePo$     X   "rz'**""""    FP!P!P!P!P!P!P!P!fDl/l/l/l/l/_l/l/l/^H$P P P P P VP P P f(      rB