o NiV@sdZddlmZddlZddlmZddlmZmZmZm Z m Z ddl m Z ddl mZmZmZddlmZmZdd lmZdd lmZdd lmZmZdd lmZdd lmZmZddl m!Z!m"Z"ddl#m$Z$m%Z%ddl&m'Z'm(Z(m)Z)ddl*m+Z+ddl,m-Z-m.Z.m/Z/ddl0m1Z1erddl2m3Z3m4Z4m5Z5m6Z6ddl7m8Z8ddl9m:Z:ddl;mZ>m?Z?m@Z@mAZAe(BeCZDeEdZFeEdZGe$ZHGdddeeIZJGdddeJZKGdd d e%ZLGd!d"d"eeIZMGd#d$d$e+ZNGd%d&d&eeIZOGd'd(d(e+ZPGd)d*d*e%ZQeEd+ZRd[d0d1ZSd\d?d@ZTGdAdBdBe+ZUd]d^dGdHZVGdIdJdJe+ZWGdKdLdLe%ZXGdMdNdNeZYd_dVdWZZd`dYdZZ[dS)azThe standard domain.) annotationsN)copy) TYPE_CHECKINGAnyClassVarFinalcast)nodes)ElementNodesystem_message) Directive directives) StringList)addnodes)desc_signature pending_xref)ObjectDescription)DomainObjType)___)EmphasizedLiteralXRefRole) docname_joinloggingws_re)SphinxDirective) clean_astextmake_id make_refnode)nested_parse_to_nodes)CallableIterableIteratorSet)Sphinx)Builder)BuildEnvironment)ExtensionMetadata OptionSpec RoleFunction TitleGetterz ((?:/|--|-|\+)?[^\s=]+)(=?\s*.*)z`((~?[\w-]*:)?\w+)`c@s>eZdZUdZdZded<dZded<dd d ZdddZdS) GenericObjectzM A generic x-ref directive registered with Sphinx.add_object_type(). str indextemplateNz=Callable[[BuildEnvironment, str, desc_signature], str] | None parse_nodesigsignoderreturncCsB|jr ||j||}|S||t||7}td|}|S)N )r1envclearr desc_namersub)selfr2r3namer<O/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/domains/std/__init__.pyhandle_signature8s zGenericObject.handle_signaturer;Nonec Cst|j|jj|j|}|d||jj||jrS|jd}|dkr>|jd| }|j|dd |f}nd}|j|f}|j d|||ddf|jj j }|j |j|||ddS) Nids:singleentriesr.location)rr6statedocumentobjtypeappendnote_explicit_targetr0findstrip indexnodedomainsstandard_domain note_object) r:r;r2r3node_idcolon indextype indexentrystdr<r<r=add_target_and_indexBs   z"GenericObject.add_target_and_indexr2r/r3rr4r/r;r/r2r/r3rr4r?) __name__ __module__ __qualname____doc__r0__annotations__r1r>rXr<r<r<r=r-0s     r-c@seZdZedZdS)EnvVarenvironment variable; %sN)r[r\r]rr0r<r<r<r=r`Us r`c@seZdZdZdd d ZdS)EnvVarXRefRolezQ Cross-referencing role for environment variables (adds an index entry). rInodes.documentr6r(noder is_refboolr4'tuple[list[Node], list[system_message]]c Cs~|s|ggfS|d}d|d}t}d||ddfdtd||ddfg|d<tjdd|gd}|||||ggfS) N reftargetzindex-%sindexrDr.rarEr@) new_serialnorrirr targetrL) r:rIr6rdrevarnametgtidrO targetnoder<r<r= result_nodes^s   zEnvVarXRefRole.result_nodesN) rIrcr6r(rdr rerfr4rg)r[r\r]r^rpr<r<r<r=rbYsrbc@seZdZUedZded<ejejejejejejdZ ded<d#d d Z d$ddZ d%ddZ d&ddZ d'ddZd(ddZd)d d!Zd"S)*ConfigurationValuez%s; configuration valuer/index_template)zno-indexzno-index-entryzno-contents-entryzno-typesettingtypedefaultClassVar[OptionSpec] option_specr2sig_noderr4cCs0||t||7}td|}||d<|S)Nr5fullname)r7rr8rr9)r:r2rwr;r<r<r=r>ys  z#ConfigurationValue.handle_signaturetuple[str, ...]cCs |dfS)Nrxr<)r:rwr<r<r=_object_hierarchy_partss z*ConfigurationValue._object_hierarchy_partscCs|dsdS|d\}|S)N _toc_partsr.)get)r:rwr;r<r<r=_toc_entry_names  z"ConfigurationValue._toc_entry_namer;r3r?cCsxt|j|jj|j|}|d||jj||j|}|jdd||ddf|jj j }|j |j|||ddS)Nr@rEpairr.rF) rr6rHrIrJrKrLrrrOrPrQrR)r:r;r2r3rS index_entrydomainr<r<r=rXs  z'ConfigurationValue.add_target_and_index content_nodeaddnodes.desc_contentcCst}d|jvr||jd\}}||||7}d|jvr4||jd\}}||||7}t|jdkrC|d|dSdS)z,Insert *type* and *default* as a field list.rsrtrN) r field_listoptions format_typerKformat_defaultlenchildreninsert)r:rrfieldmsgsr<r<r=transform_contents    z$ConfigurationValue.transform_contenttype_(tuple[nodes.field, list[system_message]]cCD|j||jd\}}tdtdtdtjdg|R}||fS)zFormats the ``:type:`` option.linenor.Type parse_inlinerr r field_namer field_body)r:rparsedrrr<r<r=rzConfigurationValue.format_typertcCr)z!Formats the ``:default:`` option.rr.Defaultr)r:rtrrrr<r<r=rrz!ConfigurationValue.format_defaultN)r2r/rwrr4r/)rwrr4ry)rwrr4r/rZ)rrr4r?)rr/r4r)rtr/r4r)r[r\r]rrrr_rflagunchanged_requiredrvr>rzr}rXrrrr<r<r<r=rqns      rqc@s<eZdZUdZdZdZdZdZdZiZ de d<dd d Z d S)Targetz@ Generic target for user-defined cross-reference types. r.FrCrTrurvr4 list[Node]c Cstd|jd}t|j|jj|j|}t j dd|gd}| ||jj ||g}|j rf|j |f}d}|d}|dkrT|d|}||dd}tj|||ddfgd }|d||j} d|jvrw|jdd\} } |jjj} | j| |||d |S) Nr5rr.rjrDrArBrC)rErF)rr9 argumentsrNrr6rHrIr;r rlset_source_inforLr0rMrrirsplitrPrQrR) r:rxrSrdretrVrUrTinoder;rrWr<r<r=runs*      z Target.runNr4r) r[r\r]r^r0 has_contentrequired_argumentsoptional_argumentsfinal_argument_whitespacervr_rr<r<r<r=rs  rc@s$eZdZdZdddZdd d Zd S) Cmdoptionz; Description of a command-line option (.. option). r2r/r3rr4c Csd}d}|dD]}|}t|}|s!tjtd||dq |\}}|ddkr=|ddkr=|d d}d|}|r[|jj j rS|t d d 7}|t 7}n|t dd7}|t ||7}|jj j rd } |r|ddkr|ddkrd } |t dd7}|d d}n%|ddkr|t 7}|}n|ddkr|t dd7}|d d }t|D]} t| tjr|t| 7}q|| 7}q| r|t dd7}n|t ||7}|s|}|g|d<n|d||d 7}q |st|S)z/Transform an option description into RST nodes.rr.z, znMalformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"rFrB[]N,FTrCr5=allnames)rrNoption_desc_rematchloggerwarningrgroupsr6configoption_emphasise_placeholdersrdesc_sig_punctuationdesc_sig_space desc_addnamer8 samp_roleparse isinstancer TextastextrK ValueError) r:r2r3count firstnamepotential_optionmoptnameargsadd_end_bracketpartr<r<r=r>sd               zCmdoption.handle_signaturerr?c Cs|jjd}|dgD],}dg}|r|||ds#|dd|}t|j|jj||}|d|q |jj ||jj j } |dgD]}| |||jj |ddqL|rftd |} ntd } |dgD]} | d | } |jd d | |ddddfqpdS)N std:programr cmdoption)-/argrr@rz%s command line optionzcommand line optionz; rEr~r.)r6 ref_contextr|rK startswithjoinrrHrIrLrPrQadd_program_optiondocnamerrO) r:rr2r3 currprogramrprefixesprefixrSrdescroptionentryr<r<r=rXs.     $zCmdoption.add_target_and_indexNrY)rr/r2r/r3rr4r?)r[r\r]r^r>rXr<r<r<r=rs :rc@8eZdZUdZdZdZdZdZiZde d<d d d Z d S)ProgramzI Directive to name the program for which options are documented. FrCrTrurvr4rcCsBtd|jd}|dkr|jjddgS||jjd<gS)Nrrr?r)rr9rrNr6rpop)r:programr<r<r=rDs  z Program.runNr r[r\r]r^rrrrrvr_rr<r<r<r=r9  rc@eZdZdd d ZdS)OptionXRefRoler6r(refnoder has_explicit_titlerftitler/rlr4tuple[str, str]cCs|jd|d<||fS)Nr)rr|)r:r6rrrrlr<r<r= process_linkNszOptionXRefRole.process_linkN r6r(rr rrfrr/rlr/r4rr[r\r]rr<r<r<r=rMrz +: +liner/r4tuple[str, str | None]cCs2t|}|d}t|dkr|dnd}||fS)NrrC)_term_classifiers_rerr)rpartstermfirst_classifierr<r<r=split_term_classifiersWs rr6r( textnodesIterable[Node] index_key str | NonesourcerintrSrIrc nodes.termc Cstjddg|R}||_||_|}|r|d|nt||d|}|d||||jj j |||dt } d||d|fg| d<|j|j| _| _|| |S)Nr.r@rrFrDmainrE) r rrrrrKrrLrPrQ _note_termrri) r6rrrrrSrIrtermtextrOr<r<r=make_glossary_term_s  rc@s>eZdZUdZdZdZdZdZdej iZ de d<d d d Z d S)Glossaryz[ Directive to create a glossary with cross-reference targets for :term: roles. TrFsortedrurvr4rc Cst}|jj|_d|jv|d<g}d}d}d}g}t|j|jjddD]\}\}} |s>|r;|r;|ddd|| d}q$|r|d s| d rNd}q$d}|rr|sc||jj j t d || d |||| fgtfd}nb|r||jj j t d || d |r|dd||| fnB||jj j t d || d n2|rn/|sd}t|t|} |r|dd|| d|| n||jj j t d || d d}q$g} |D]m\} } g}g}| D]/\}}} t|\}}|j|| d\}}t|j|||| d|jjd}||_||||q||| r.| jdd}t|j| |dd}ng}|tjdg|R| tjdg|Rqtjdg| R}|dd||7}g||S)NrTF)strictrBrCr.rz.. z,glossary term must be preceded by empty line)rrz3glossary terms must not be separated by empty linesz4glossary seems to be misformatted, check indentationr)rSrI)offsetallow_section_headingsclassesglossary)rrrHrIrzipcontentitemsrKisspacerreporterrrrrlstriprrrr6 rawsourceextendr!r definitiondefinition_list_itemdefinition_list)r:rdrE in_definition in_comment was_emptymessagesrrr indent_lenrtermsr  termnodessystem_messagesterm_rrsysmsgrrdefinition_nodesdlistr<r<r=rs                z Glossary.runNr) r[r\r]r^rrrrrrrvr_rr<r<r<r=r|s  rr.textproductionGrouprc Cs&t|dkr |d7}g}d}t|D]k}||kr+|||}|t||d}d|vr\|ddkrH|d\}}|dd} n|ddkrW|dd}|} n |}|} n|}||} t |dd| d} | tj ||dgd 7} || | }q|t|kr|t||d|S) NrrArC~tokenrW)reftype refdomainrhxrefr) rtoken_refinditerstartrKr rgrouprrliteralend) rrretnodesposrtxtrrrrlrr<r<r= token_xrefss:         r)c@r)ProductionListz0 Directive to list grammar productions. FrCrTrurvr4rc CsF|jjj}t}||td}|d|j d d}d}d}|D]z}|s2d|vr2| }q%d}z | dd\}} Wn t yJY|gSwt |} | }|| d <| d rd |} t|j|jj| |} | d | |jj| | t|dkr|d|} n|} |jd | | |d | t| ||| q%|gS)Nz\\\nr.r FrATrC tokennamezgrammar-token-%sr@rrF)r6rPrQrproductionlistrrecompiler9rrrNr productionrrHrIrKnote_implicit_targetrrRrr))r:rrd nl_escape_relinesrfirst_rule_seenruler;tokenssubnoderrSobjNamer<r<r=rsB        zProductionList.runNrrr<r<r<r=r*rr*c@r) TokenXRefRoler6r(rr rrfrr/rlr4rcCsN|d}|js#|ddkr#d|vr|d\}}||fS|dd}||fS)NrrrArC)rrr)r:r6rrrrlrr<r<r=rDs  zTokenXRefRole.process_linkNrrr<r<r<r=r9Crr9c seZdZUdZdZdZeeddddeedd ddeed d d dded deeddeeddeedddddZde d<e e e e e eedZde d<eddeddeeeejddedejddedddeddedejd 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<dfdCdD Z %dddJdKZ e!ddMdNZ"dddTdUZ#e!ddVdWZ$dddXdYZ%e!dd[d\Z&e!dd^d_Z'e!dd`daZ(ddbdcZ)ddhdiZ*ddkdlZ+ddodpZ,ddxdyZ-dddZ.dddZ/dddZ0dddZ1dddZ2dddZ3dddZ4dddZ5dddZ6dddZ7ddddZ8dddZ9dddZ:dddZ;dddZS)StandardDomainzs Domain for all objects that don't fit into another domain or are added via the application interface. rWrz glossary termrrB) searchprioz grammar tokenrzreference labelrefkeywordzconfiguration valueconfvalzenvironment variableenvvarzprogram optionrrIdoc)rrlabelr>r?rr@zdict[str, ObjType] object_types)rrrr>r?rr-zdict[str, type[Directive]]rT) warn_dangling)innernodeclassrC) lowercaserDrC)rErC)rCrD) rr>r?rrr<numrefr=r@z"dict[str, RoleFunction | XRefRole]rolesgenindexr.Index py-modindexz Module Indexsearchz Search Page)rHmodindexrK)rHr.)rJr.)rKr.) 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)rrFr=r@r)figureN)tableN) code-blockNz0dict[type[Node], tuple[str, TitleGetter | None]]enumerable_nodesr6r(r4r?cs>t|t|j|_|jjjD] \}}||j|<qdSN)super__init__rrWappregistryr)r:r6rdsettings __class__r<r=rZs   zStandardDomain.__init__r;r/rrSrcCsj||jvr |j|||fkr ttd||j|j|d||f|j|<|r3|||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)rPrrrr6doc2pathrO)r:r;rrSrr<r<r=note_hyperlink_targets z$StandardDomain.note_hyperlink_target&dict[tuple[str, str], tuple[str, str]]cC|jdiS)NrNdata setdefaultr:r<r<r=rNzStandardDomain.objectsNrJlabelidrGrcCsR||f|jvr|j||fd}tjtd||||d|jj|f|j||f<dS)zRNote a generic object for cross reference. .. versionadded:: 3.0 rz4duplicate %s description of %s, other instance in %srFN)rNrrrr6r)r:rJr;rjrGrr<r<r=rRs  zStandardDomain.note_objectcCrd)z2.. note:: Will be removed soon. internal use only.rrerhr<r<r=_termsszStandardDomain._termscCs*|d||||jj|f|j|<dS)zeNote a term for cross reference. .. note:: Will be removed soon. internal use only. rN)rRr6rrklower)r:rrjrGr<r<r=rszStandardDomain._note_term-dict[tuple[str | None, str], tuple[str, str]]cCrd)NrMrerhr<r<r=rMrizStandardDomain.progoptionsdict[str, tuple[str, str, str]]cCrd)NrOrerhr<r<r=rOrizStandardDomain.labelscCrd)NrPrerhr<r<r=rPrizStandardDomain.anonlabelscCsd}t|jD]\}\}}||kr|j|=q t|jD]\}\}}||kr-|j|=qt|jD]\}\}}||krC|j|=q5t|jD]\}\}}}||krZ|j|=qKt|jD]\}\}}||krp|j|=qbdSrX)listrMrrNrkrOrP)r:rkeyfn_lr<r<r= clear_docs,zStandardDomain.clear_docdocnamesSet[str] otherdatadict[str, Any]cCs|dD]\}}|d|vr||j|<q|dD]\}}|d|vr+||j|<q|dD]\}}|d|vrA||j|<q2|dD]\}}|d|vrW||j|<qH|dD]\}}|d|vrm||j|<q^dS)NrMrrNrrOrP)rrMrNrkrOrP)r:rtrvrprfr<r<r=merge_domaindatas*          zStandardDomain.merge_domaindatarcc Cs|jD]\}}|s q|j|}|durq|j|}t|tjr3d|vr3|j|d}|dd}|jdksBd|vsB|j drCq||j vr[t j t d|||j |d|d||f|j|<|jd krtttj|d}t|} ne|jd kr~t|} n[||r||pd } | sqnKt|tjtjBr|jrttj|jd}t|tjtjBrttj|jd}t|tjtjBrt|} nt|tj d} | r| d r| d } nq||| f|j |<qdS) Nrefidnamesrfootnoterefuridesc_r`rFsectionrubricr.caption)! nametypesrnameidsr@rr rlr|tagnamerrOrrrrarPrrris_enumerable_nodeget_numfig_titler rrr rr rrnextfindallrtoctree) r:r6rrIr;explicitrjrdrsectnamerr<r<r= process_docsZ              zStandardDomain.process_docrrcCs(||f|jvr||f|j||f<dSdSrX)rM)r:rr;rrjr<r<r=rFsz!StandardDomain.add_program_option fromdocnamebuilderr'rrolenamerr c Ks|dtj}|d ddi|} t||} | ddur-| dd| dd|||kr6|| d<n td} || d <|| d <|||| d <|rV| d d |7<| | | S)N nodeclassr.internalTrrWzstd-ry refdocname refsectnamer|#r.r.)rr referenceinliner|rKrget_relative_uri) r:rrrrjrrrrnewnode innernodecontnoder<r<r=build_reference_nodeLs$   z#StandardDomain.build_reference_nodetyprlrdrrElement | Nonec Csz|dkr|j}n+|dkr|j}n#|dkr|j}n|dkr |j}n|dkr(|j}n |dkr0|j}n|j}||||||||S)Nr<rFr=r@rr)_resolve_ref_xref_resolve_numref_xref_resolve_keyword_xref_resolve_doc_xref_resolve_option_xref_resolve_term_xref_resolve_obj_xref) r:r6rrrrlrdrresolverr<r<r= resolve_xrefeszStandardDomain.resolve_xrefc CsT|dr|j|d\}} |} n |j|d\}} } |s dS||||| | dS)N refexplicitrr.r.r.r<)rPr|rrOr) r:r6rrrrlrdrrrjrr<r<r=rys z StandardDomain._resolve_ref_xrefc Cs ||jvr|j|d\}} } n |j|d\}} d} |sdS||j| } | dus.J|| } | dur9dS| dkrN|jjdurNtj t d|d|Sz| ||| || } | dur_|WSWnt yutj t d| |d|YSwzM|dr| }n|jj| d }| durd |vrtj t d ||d|WSd tt| }d |vsd |vr| r|j| |d}n |j|d}n||}Wn3ty}ztj t d|||d|WYd}~Sd}~wtytj t d||d|YSw|j|||| |dtj|dS)Nrrr~Fz(numfig is disabled. :numref: is ignored.rFzBFailed to create a cross reference. Any number is not assigned: %srr.z{name}zthe link has no caption: %s.number)r;r)rzinvalid numfig_format: %s (%r)zinvalid numfig_format: %srF)rr)rOr|rP get_doctreer@get_enumerable_node_typernumfigrrr get_fignumberrr numfig_formatrmapr/formatKeyError TypeErrorrrnumber_reference)r:r6rrrrlrdrrrjfigname target_nodefigtype fignumberrfignumnewtitleexcr<r<r=rsh       z#StandardDomain._resolve_numref_xrefc Cs,|j|d\}} } |sdSt|||| |S)Nr)rOr|r ) r:r6rrrrlrdrrrjrr<r<r=rs z$StandardDomain._resolve_keyword_xrefc Csj|d|}t||d} | |jvrdS|dr|} nt|j| } tj| | dgd} t||| d| S)Nrefdocrhrr@r) r|rall_docsrrtitlesr rr ) r:r6rrrrlrdrrrrrr<r<r=rs   z StandardDomain._resolve_doc_xrefcCs|d}|}|j||fd\} } | s6dD]} | |vr5|| \} } } |j|| fd\} } | r5nq| sfg}t|rdt|d\}}||d|}|j||fd\} } | r_nt|s?dSt ||| | |S)Nrr)rz[=r5rCr) r|rNrM partitionrrKrrKrr )r:r6rrrrlrdrprognamerrjneedlestemrcommands subcommandr<r<r=rs2      z#StandardDomain._resolve_option_xrefc CsR||||||||}|r|S||jvr'|j|\} } t||| | |SdSrX)rrlrkr ) r:r6rrrrlrdrresultrrjr<r<r=rs z!StandardDomain._resolve_term_xrefc Cs\||pg}|D]} | |f|jvr|j| |f\} } nq d\} } | s&dSt||| | |S)Nr)objtypes_for_rolerNr ) r:r6rrrrlrdrobjtypesrJrrjr<r<r=rsz StandardDomain._resolve_obj_xreflist[tuple[str, Element]]c Csg}|}dD]} ||||| | dkr|n|||} | r&|d| | fq|jD].} | |f} | dkr8| |f} | |jvrX|j| \} }d|| } || t||| ||fq*|S)N)r<rr<zstd:r)rlrrKrBrNrole_for_objtyper )r:r6rrrlrdrresultsltargetroleresrJrprrjr<r<r=resolve_any_xref%s,   zStandardDomain.resolve_any_xref-Iterator[tuple[str, str, str, str, str, int]]c cs8|jjD]}|t|jj|d|ddfVq|jD]*\\}}}|r9|d|}||d|d|ddfVq||d|d|ddfVq|jD]\\}}}||||d|d|j|jdfVqL|j D]\}\}} } || d || dfVqkt |j } |j D]\}\}} || vr||d || dfVqdS) Nr@r.rBrrrrCr;rA) r6rrrrMrrNrBattrsrOsetrP) r:r@progrinforxrsr;rrj sectionnamenon_anon_labelsr<r<r= get_objects<s(   zStandardDomain.get_objectsFrsrprimaryrfcCs|jSrX)lname)r:rsrr<r<r= get_type_nameQszStandardDomain.get_type_namer cCs |j|jvSrX)r_rW)r:rdr<r<r=rUs z!StandardDomain.is_enumerable_nodecCs`||r.tt|}|j|jd\}}|r||S|D]}t|tjtj Br-t |SqdS)z?Get the title of enumerable nodes to refer them using its titleNNN) rrr rWr|r_rr rrr)r:rdelemr title_getterr7r<r<r=rXs   zStandardDomain.get_numfig_titlecCsVddd}t|tjr d St|tjrd |vr||tjrd S|j|jd \}}|S)zGet type of enumerable nodes.rdr clsrsr4rfcstfdd|DS)Nc3s|]}t|VqdSrX)r).0childrr<r= iszMStandardDomain.get_enumerable_node_type..has_child..)any)rdrr<rr= has_childhsz:StandardDomain.get_enumerable_node_type..has_childr~ literal_blockrVrN)rdr rrsr4rf)rr r~ containerrrWr|r_)r:rdrrrr<r<r=rfs    z'StandardDomain.get_enumerable_node_typerrtuple[int, ...] | Nonec Cs|dkr1|jdkr dS||jvrtd|dd}||j|vr)|j|dS|j||Sz|dd}|j|||WSttfyR}zt|d}~ww)Nr~latexr<rr@rr.)r;toc_secnumbersrr|toc_fignumbersr IndexError) r:r6rrrr anchorname figure_idrr<r<r=rvs    zStandardDomain.get_fignumbercCsd|ddkr0|d}t|d}|r|d||}|r.d|}|d|SdSdS)Nrrrrhrrr)r|rrrrr)r:rdrcommandr command_strr<r<r=get_full_qualified_names   z&StandardDomain.get_full_qualified_name)r6r(r4r?r.) r;r/rr/rSr/rr/r4r?)r4rcrX) rJr/r;r/rjr/rGrr4r?)r4rR)rr/rjr/rGrr4r?)r4rm)r4rn)rr/r4r?)rtrurvrwr4r?)r6r(rr/rIrcr4r?) rrr;r/rr/rjr/r4r?)rr/rr'rr/rjr/rr/rr/rrr4r )r6r(rr/rr'rr/rlr/rdrrr r4r)r6r(rr/rr'rlr/rdrrr r4r)r4r)F)rsrrrfr4r/)rdr r4rf)rdr r4r) r6r(rr'rr/rr/rr r4r)rdr r4r)?r[r\r]r^r;rArrrBr_rrrqr`rr*rrrrbr9r rrGrQrSdangling_warningsrTrUrrWrZrbpropertyrNrRrkrrMrOrPrsrxrrrrrrrrrrrrrrrrrrr __classcell__r<r<r^r=r:Os                           3     @  !        r:r[r&rrrdr bool | NonecCs^|r|jdks |ddkrdS|d}||jvrtd}ntd}tj|||d|dddS) NrWrr<rhzundefined label: %rzDFailed to create a cross reference. A title or caption not found: %r)rGrssubtypeT)r;rPrrr)r[rrdrlmsgr<r<r=warn_missing_references  rr)cCs$|t|dtdddddS)Nzwarn-missing-referencebuiltinrT)version env_versionparallel_read_safeparallel_write_safe) add_domainr:connectr)r[r<r<r=setups  r)rr/r4r)r6r(rrrrrr/rrrSrrIrcr4rr)rr/rr/r4r)r[r&rrrdrr4r)r[r&r4r))\r^ __future__rr.rtypingrrrrrdocutilsr docutils.nodesr r r docutils.parsers.rstr rdocutils.statemachinersphinxrsphinx.addnodesrrsphinx.directivesrsphinx.domainsrr sphinx.localerr sphinx.rolesrr sphinx.utilrrrsphinx.util.docutilsrsphinx.util.nodesrrr sphinx.util.parsingr!collections.abcr"r#r$r%sphinx.applicationr&sphinx.buildersr'sphinx.environmentr(sphinx.util.typingr)r*r+r, getLoggerr[rr/rr rr/r-r`rbrqrrrrrrrrr)r*r9r:rrr<r<r<r=sf              %G(\    u!1  X