3
T'íc³ ã @ sÄ d Z ddlZddlZddlmZ ddlmZmZmZmZm Z m
Z
m Z m Z m
Z
mZmZmZ ddlmZ ddlmZmZmZ ddlmZmZ ddlmZ dd l m Z dd
l m Z m Z dd l!m"Z" dd l#m$Z$ dd
l%m&Z&m'Z' ddl(m)Z)m*Z* ddl+m,Z, ddl-m.Z.m/Z/m0Z0 ddl1m2Z2 ddl3m4Z4m5Z5m6Z6 ddl7m8Z8m9Z9 erbddl:m;Z; ddl<m=Z= ddl>m?Z? e/j@eAZBejCdZDejCdejEZFG dd de$eG ZHG dd d eHZIG d d d e,ZJG d d d e2ZKG d!d" d"e$eG ZLG d#d$ d$e2ZMG d%d& d&e,ZNeGe e eG d'd(d)ZOd*e e eGeGePeGejQejRd+d,d-ZSG d.d/ d/e2ZTdAeGeGe e d1d2d3ZUG d4d5 d5e2ZVG d6d7 d7e,ZWG d8d9 d9e&ZXd:e&e e eY d;d<d=ZZd:eeGef d>d?d@Z[dS )BzThe standard domain.é N)Úcopy) Ú
TYPE_CHECKINGÚAnyÚCallableÚDictÚIterableÚIteratorÚListÚOptionalÚTupleÚTypeÚUnionÚcast)Únodes)ÚElementÚNodeÚsystem_message)Ú DirectiveÚ
directives)Ú
StringList)Úaddnodes)Údesc_signatureÚ pending_xref)ÚRemovedInSphinx50Warning)ÚObjectDescription)ÚDomainÚObjType)Ú_Ú__)ÚXRefRole)Ú docname_joinÚloggingÚws_re)ÚSphinxDirective)Ú clean_astextÚmake_idÚ make_refnode)Ú
OptionSpecÚ RoleFunction)ÚSphinx)ÚBuilder)ÚBuildEnvironmentz ((?:/|--|-|\+)?[^\s=]+)(=?\s*.*)z`((~?\w*:)?\w+)`c @ sh e Zd ZU dZdZedZed deegef eeedddZ eeeddd d
Z
eed d d
Z dS )Ú
GenericObjectzM
A generic x-ref directive registered with Sphinx.add_object_type().
Ú Nr+ )ÚsigÚsignodeÚreturnc C s@ | j r| j | j||}n$|j |tj||7 }tjd|}|S )Nú )Ú
parse_nodeÚenvÚclearr Ú desc_namer" Úsub)Úselfr. r/ Úname© r9 ú4/tmp/pip-build-gk9425m9/sphinx/sphinx/domains/std.pyÚhandle_signature/ s z GenericObject.handle_signature)r8 r. r/ r0 c
C s t | j| jj| j|}|d j| | j|}|| jjjkrV||d krV|d j| | jjj| | j rØ| j j
d}|d kr®| j d |
j }| j |d d
j |f }nd}| j |f }| j d j|||dd f t
t| jjd} | j| j|||d d S )
NÚidsú:é ÚsingleÚentriesr- Ústd)Úlocationéÿÿÿÿ)r% r3 ÚstateÚdocumentÚobjtypeÚappendÚ make_old_idr< Únote_explicit_targetÚ
indextemplateÚfindÚstripÚ indexnoder ÚStandardDomainÚ
get_domainÚ note_object)
r7 r8 r. r/ Únode_idÚ old_node_idÚcolonÚ indextypeÚ
indexentryrA r9 r9 r: Úadd_target_and_index9 s
z"GenericObject.add_target_and_index)r8 r0 c C s | j d | S )z°Generate old styled node_id for generic objects.
.. note:: Old Styled node_id was used until Sphinx-3.0.
This will be removed in Sphinx-5.0.
ú-)rF )r7 r8 r9 r9 r: rH R s zGenericObject.make_old_id) Ú__name__Ú
__module__Ú __qualname__Ú__doc__rJ Ústrr2 r r r; rV rH r9 r9 r9 r: r, ( s
r, c @ s e Zd ZedZdS )ÚEnvVarzenvironment variable; %sN)rX rY rZ r rJ r9 r9 r9 r: r] [ s r] c @ s8 e Zd ZdZejdeeee e
e e f dddZ dS )ÚEnvVarXRefRolezQ
Cross-referencing role for environment variables (adds an index entry).
r+ )rE r3 ÚnodeÚis_refr0 c C s~ |s|gg fS |d }d|j d }tj }d||dd fdtd| |dd fg|d< tjdd|gd}|j| |||gg fS ) NÚ reftargetzindex-%sÚindexr? r- zenvironment variable; %sr@ )r< )Z new_serialnor rb r r ÚtargetrI ) r7 rE r3 r_ r` ZvarnameZtgtidrM Z
targetnoder9 r9 r: Ú result_nodesd s
zEnvVarXRefRole.result_nodesN)
rX rY rZ r[ r rE r Úboolr r r r rd r9 r9 r9 r: r^ _ s r^ c @ sP e Zd ZU dZdZdZdZdZdZi Z e
e e ddd Z
eed
d d Zd
S )ÚTargetz@
Generic target for user-defined cross-reference types.
r- Fr> r T)r0 c
C sL t jd| jd j }t| j| jj| j|}t j
dd|gd}| j | | j |}|| jjj
krz||d krz|d j| | jjj| |g}| jr | j|f }d}|jd}|d krÜ|d |
j }||d d
j }tj|||dd fgd } |jd| | j}
d| jkr$| jjdd\} }
tt| jjd
} | j|
|||d |S )
Nr1 r r- )r< r< r? r= r> )r@ rA )rB rC )r" r6 Ú argumentsrL r% r3 rD rE r8 r rc Úset_source_inforH r< rG rI rJ rK r rb ÚinsertÚsplitr rN rO rP )
r7 ÚfullnamerQ r_ rR ÚretrU rT rS Úinoder8 r rA r9 r9 r: Úrun s0
z
Target.run)r8 r0 c C s | j d | S )z¨Generate old styled node_id for targets.
.. note:: Old Styled node_id was used until Sphinx-3.0.
This will be removed in Sphinx-5.0.
rW )r8 )r7 r8 r9 r9 r: rH ¡ s zTarget.make_old_idN)rX rY rZ r[ rJ Ú has_contentÚrequired_argumentsÚoptional_argumentsÚfinal_argument_whitespaceÚ option_specr' r r rn r\ rH r9 r9 r9 r: rf t s
!rf c @ sH e Zd ZdZeeedddZeeeddddZeeed d
d ZdS ) Ú Cmdoptionz;
Description of a command-line option (.. option).
)r. r/ r0 c C sæ d}d}xÐ|j dD ]Â}|j }tj|}|sDtjtd||d q|j \}}|jdrx|jdrx|dd
}d| }|r|t j
dd7 }|t j ||7 }|t j
||7 }|sÀ|}|g|d
< n|d
j | |d 7 }qW |sât
|S ) z/Transform an option description into RST nodes.r r- z, znMalformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args")rB ú[ú]Nr> ÚallnamesrC )rj rL Úoption_desc_reÚmatchÚloggerÚwarningr ÚgroupsÚendswithr Z desc_addnamer5 rG Ú
ValueError) r7 r. r/ ÚcountÚ firstnameZpotential_optionÚmÚoptnameÚargsr9 r9 r: r; ¯ s4
zCmdoption.handle_signatureN)r r. r/ r0 c C sf | j jjd}x|jdg D ]}dg}|r4|j| |jdsH|jd dj|}t| j | jj||}|d j| | j ||} | | jjj
kr | |d kr |d j| q W | jjj | t t
| j jd}
x0|jdg D ] }|
j||| j j|d d qÚW |rtd
| } ntd } xF|jdg D ]6} d j| | g}
| jd
jd|
|d d dd f q(W d S )Nz std:programrw Ú cmdoptionrW ú/Úargr< rA r z%s command line optionzcommand line optionz; r@ Úpairr- )rW r
)r3 Ú ref_contextÚgetrG Ú
startswithÚjoinr% rD rE rH r< rI r rN rO Úadd_program_optionÚdocnamer rM )r7 r r. r/ Z currprogramr ÚprefixesÚprefixrQ rR ÚdomainÚdescrÚoptionÚentryr9 r9 r: rV Ð s2
z Cmdoption.add_target_and_index)r r r0 c C s t j|d | S )zªGenerate old styled node_id for cmdoption.
.. note:: Old Styled node_id was used until Sphinx-3.0.
This will be removed in Sphinx-5.0.
rW )r r% )r7 r r r9 r9 r: rH ñ s zCmdoption.make_old_id) rX rY rZ r[ r\ r r; rV rH r9 r9 r9 r: rt ª s !!rt c @ s< e Zd ZU dZdZdZdZdZi Ze e
e dddZ d S )
ÚProgramzI
Directive to name the program for which options are documented.
Fr> r T)r0 c C s@ t jd| jd j }|dkr0| jjjdd n || jjd< g S )NrW r ÚNonez std:program)r" r6 rg rL r3 r Úpop)r7 Úprogramr9 r9 r: rn s
z Program.runN)
rX rY rZ r[ ro rp rq rr rs r' r r rn r9 r9 r9 r: r ú s
r c @ s, e Zd Zdeeeeeeef dddZdS )ÚOptionXRefRoler+ )r3 ÚrefnodeÚhas_explicit_titleÚtitlerc r0 c C s |j jd|d< ||fS )Nz std:program)r r )r7 r3 r r r rc r9 r9 r: Ú process_link s zOptionXRefRole.process_linkN)rX rY rZ r re r\ r r r9 r9 r9 r: r s r )Úliner0 c C s t jd| d g }|S )Nz +: +)Úrerj )r Úpartsr9 r9 r: Úsplit_term_classifiers s r r+ )r3 Ú textnodesÚ index_keyÚsourceÚlinenorQ rE r0 c C s¸ t jd | }||_||_|j }|r6|d j| n&t| |d|}|d j| |j| tt | j
d} | j |||d t j
}
d||d|fg|
d< |j|j |
_|
_|j|
|S )
Nr- r< ÚtermrA )rB r? Úmainr@ )r- r- )r r¥ r£ r ÚastextrG r% rI r rN rO Ú
_note_termr rb ) r3 r¡ r¢ r£ r¤ rQ rE r¥ ZtermtextrA rM r9 r9 r: Úmake_glossary_term s
r© c @ sB e Zd ZU dZdZdZdZdZdej iZ
e
e e
dddZd S )
ÚGlossaryz[
Directive to create a glossary with cross-reference targets for :term:
roles.
Tr FÚsorted)r0 c C sÎ t j }| jj|_d| jk|d< g }d}d}d}g }xt| j| jjD ]t\}\}} |s~|rx|rx|d d jd|| d}qH|o|d j rP|j
dr¤d}qHnd}|rì|sÎ|j| jj j t
d|| d |j||| fgt f d}nb|r|j| jj j t
d
|| d |r0|d d j||| f n |j| jj j t
d || d nj|rXnb|svd}t|t|j }
|r|d d j||
d
|| n |j| jj j t
d || d d}qHW g } xØ|D ]Ð\} }
g }g }xl| D ]d\}}} t|}| jj|d | \}}t| j||d || d | jjd }||_|j| |j| qâW |j| tj }|
r|| jj|
|
jd d | |j| | jtjd| qÌW tjd| }|d
jd ||7 }||g S )Nr« TFr> r- r z.. z,glossary term must be preceded by empty line)r£ r z3glossary terms must not be separated by empty linesz4glossary seems to be misformatted, check indentation)rQ rE ÚclassesÚglossaryrC rC rC )r- )r- ) r r rD rE ÚoptionsÚzipÚcontentÚitemsrG Úisspacer Zreporterr{ r r ÚlenÚlstripr Z inline_textr© r3 Z rawsourceÚextendr Ú
definitionZ nested_parseZdefinition_list_itemZdefinition_list)r7 r_ r@ Z
in_definitionZ
in_commentZ was_emptyÚmessagesr r£ r¤ Z
indent_lenr± Útermsr¶ Z termnodesZsystem_messagesr r¡ Zsysmsgr¥ ZdefnodeZdlistr9 r9 r: rn G s
"
z Glossary.runN)rX rY rZ r[ ro rp rq rr r Úflagrs r' r r rn r9 r9 r9 r: rª 9 s
rª r- )ÚtextÚproductionGroupr0 c C s8 t |dkr|d7 }g }d}xætj| D ]Ø}|j |krZ| ||j
}|jtj|| |jd}d|kr¼|d dkr|jd\}}|dd
} qÈ|d dkr²|dd
}|} qÈ|}|} n |}|| } t |dd| d}
|
tj
||dgd 7 }
|j|
|j }q(W |t | k r4|jtj| |d
| |d
|S )
Nr r= r> ú~ÚtokenrA )ÚreftypeZ refdomainra Zxref)r¬ ) r³ Útoken_reÚfinditerÚstartrG r ZTextÚgrouprj r ÚliteralÚend) rº r» ZretnodesÚposr Útxtr½ r r rc r r9 r9 r: Ú token_xrefs« s8
"rÇ c @ sL e Zd ZU dZdZdZdZdZi Ze e
e dddZ e
e
d d
d Zd S )
ÚProductionListz0
Directive to list grammar productions.
Fr> r T)r0 c C s t t| jjd}tj }| j| tjd}|j d| j
d j d}d}d}x<|D ]2}|dkrvd|krv|j }qV|d7 }y|j dd\}} W n t
k
r¨ P Y nX tj|}
|j }||
d< |
d rpd | } t| j| jj| |} |
d
j| | j|}
|
| jjjkr.|
|
d
kr.|
d
j|
| jjj|
|
t|dkrZd ||f }n|}|jd || |d
|
jt| | |j|
qVW |gS )NrA z\\\nr- r Ú
r= r> Z tokennamezgrammar-token-%sr< z%s:%sr½ )rB )r rN r3 rO r Úproductionlistrh r Úcompiler6 rg rj rL r~ Ú
productionr% rD rE rG rH r< Znote_implicit_targetr³ rP rµ rÇ )r7 r r_ Z nl_escape_reÚlinesr» ÚiZruler8 ÚtokensÚsubnoder rQ rR ZobjNamer9 r9 r: rn × sF
zProductionList.run)r½ r0 c C s t jd| S )z§Generate old styled node_id for tokens.
.. note:: Old Styled node_id was used until Sphinx-3.0.
This will be removed in Sphinx-5.0.
zgrammar-token-)r r% )r7 r½ r9 r9 r: rH s zProductionList.make_old_idN)rX rY rZ r[ ro rp rq rr rs r' r r rn r\ rH r9 r9 r9 r: rÈ Ì s
-rÈ c @ s, e Zd Zdeeeeeeef dddZdS )Ú
TokenXRefRoler+ )r3 r r r rc r0 c C sJ |j d}| j rB|d dkrBd|kr6|jd\}}n |dd
}||fS )Nr¼ r r= r> )r´ r rj )r7 r3 r r r rc r r9 r9 r: r s
zTokenXRefRole.process_linkN)rX rY rZ r re r\ r r r9 r9 r9 r: rÑ
s rÑ c sê e Zd ZU dZdZdZeeddddeedd ddeed
d d ddeed
deeddeedddddZe e
ef e e e e
eedZe e
ee f edde e eejddedejddedddeddedejddZe e
eeef f i i d d ed fd d ed fd!d ed"fd#d
ddd#d$Z d%d&d'd(d)d*Z ej dej dej diZ!e ee" e#e
e$e% f f !d/d,d0 fd1d2 Z&de
e
e
e
d,d3d4d5Z'e(e e#e
e
f e#e
e
f f d6d7d8Z)de
e
e
e*d,d9d:d;Z+e
e
e
e
d,d<d=d>Z,e(e e
e#e
e
f f d6d?d@Z-de
e
e*d,dAdBdCZ.e(e e#e
e
f e#e
e
f f d6dDdEZ/e(e e
e#e
e
e
f f d6dFdGZ0e(e e
e#e
e
f f d6dHdIZ1e
d,dJdKdLZ2e3e
e d,dMdNdOZ4d/e
ej5d,dPdQdRZ6e
e
e
e
d,dSdTdUZ7e
dVe
e
e
e
e*e8dWdXdYZ9d/e
dVe
e
e:e8e$e8 dZd[d\Z;d/e
dVe
e
e:e8e$e8 dZd]d^Z<d/e
dVe
e
e:e8e$e8 dZd_d`Z=d/e
dVe
e
e:e8e$e8 dZdadbZ>d/e
dVe
e
e:e8e$e8 dZdcddZ?d/e
dVe
e
e:e8e$e8 dZdedfZ@d/e
dVe
e
e:e8e8dZdgdhZAd/e
dVe
e
e:e8e$e8 dZdidjZBd/e
dVe
e:e8e3e#e
e8f dkdldmZCeDe#e
e
e
e
e
eEf d6dndoZFdeeGe
dqdrdsZHe"eGdtdudvZIe"e$e
dtdwdxZJe"e$e
dtdydzZKd/dVe
e
e8e#eEd{f d|d}d~ZLe8e$e
dtddZM ZNS )rN zs
Domain for all objects that don't fit into another domain or are added
via the application interface.
rA ZDefaultz
glossary termr¥ r> )Ú
searchprioz
grammar tokenr½ zreference labelÚrefÚkeywordzenvironment variableÚenvvarzprogram optionr rE Údoc)r¥ r½ ÚlabelrÕ r rÖ )r r r rÕ r rÊ T)Ú
warn_dangling)ÚinnernodeclassrØ )Ú lowercaserÙ rØ )rÚ rØ )rØ rÙ )r rÕ r½ r¥ rÓ ÚnumrefrÔ rÖ Úgenindexr- ÚIndexú py-modindexz Module IndexÚsearchz Search Page)rÜ Zmodindexrß )Ú progoptionsÚobjectsÚlabelsÚ
anonlabelsz term not in glossary: %(target)szundefined label: %(target)szunknown keyword: %(target)sz unknown document: %(target)szunknown option: %(target)s)r¥ rÛ rÔ rÖ r ÚfigureNÚtableú
code-blockr+ )r3 r0 c sB t j| t| j| _x$|jjjj D ]\}}|| j|< q(W d S )N)ÚsuperÚ__init__r Úenumerable_nodesÚappÚregistryr± )r7 r3 r_ Úsettings)Ú __class__r9 r: rè f s zStandardDomain.__init__)r8 r rQ r r0 c C sf || j kr@| j | ||fkr@tjtd|| jj| j | d ||f| j |< |rb|||f| j|< dS )aU Add 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
z(duplicate label %s, other instance in %sr N)rã rz r{ r r3 Údoc2pathrâ )r7 r8 r rQ r r9 r9 r: Únote_hyperlink_targetn s
z$StandardDomain.note_hyperlink_target)r0 c C s | j jdi S )Nrá )ÚdataÚ
setdefault)r7 r9 r9 r: rá s zStandardDomain.objects)rF r8 ÚlabelidrB r0 c C sR ||f| j kr8| j ||f d }tjtd||||d | jj|f| j ||f< dS )zRNote a generic object for cross reference.
.. versionadded:: 3.0
r z4duplicate %s description of %s, other instance in %s)rB N)rá rz r{ r r3 r )r7 rF r8 rò rB r r9 r9 r: rP s
zStandardDomain.note_object)rF r8 r rò r0 c C s& t jdtdd ||f| j||f< d S )Nz*StandardDomain.add_object() is deprecated.é )Ú
stacklevel)ÚwarningsÚwarnr rá )r7 rF r8 r rò r9 r9 r: Ú
add_object s
zStandardDomain.add_objectc C s | j jdi S )z2.. note:: Will be removed soon. internal use only.r¸ )rð rñ )r7 r9 r9 r: Ú_terms s zStandardDomain._terms)r¥ rò rB r0 c C s* | j d||| | jj|f| j|j < dS )zeNote a term for cross reference.
.. note:: Will be removed soon. internal use only.
r¥ N)rP r3 r rø Úlower)r7 r¥ rò rB r9 r9 r: r¨ s zStandardDomain._note_termc C s | j jdi S )Nrà )rð rñ )r7 r9 r9 r: rà © s zStandardDomain.progoptionsc C s | j jdi S )Nrâ )rð rñ )r7 r9 r9 r: râ s zStandardDomain.labelsc C s | j jdi S )Nrã )rð rñ )r7 r9 r9 r: rã ± s zStandardDomain.anonlabels)r r0 c C sú d }x.t | jj D ] \}\}}||kr| j|= qW x.t | jj D ] \}\}}||krD| j|= qDW x.t | jj D ] \}\}}||krt| j|= qtW x0t | jj D ] \}\}}}||kr¤| j|= q¤W x.t | jj D ] \}\}}||krÖ| j|= qÖW d S )N)Úlistrà r± rá rø râ rã )r7 r ÚkeyÚfnZ_lr9 r9 r: Ú clear_docµ s zStandardDomain.clear_doc)ÚdocnamesÚ otherdatar0 c C sô x.|d j D ] \}}|d |kr|| j|< qW x.|d j D ] \}}|d |kr>|| j|< q>W x.|d j D ] \}}|d |krn|| j|< qnW x.|d j D ] \}}|d |kr|| j|< qW x.|d j D ] \}}|d |krÎ|| j|< qÎW d S )Nrà r rá r¸ râ rã )r± rà rá rø râ rã )r7 rþ rÿ rû rð r9 r9 r: Úmerge_domaindataÇ s z StandardDomain.merge_domaindata)r3 r rE r0 c C sj xb|j j D ]R\}}|s q|j| }|d kr2q|j| }t|tjrld|krl|jj|d }|d d }|jdksd|ks|jj drq|| j
kr¼t j t
d||j| j
| d |d ||f| j|< |jd krîttj|d }t|} nd|jd
krt|} nN| j|r$| j|} | sRqn.t|jtjd }
|
r|
jd r|
jd } nq||| f| j
|< qW d S ) NÚrefidÚnamesr ZfootnoteÚrefuriZdesc_z(duplicate label %s, other instance in %s)rB ÚsectionZrubricÚcaption)Z nametypesr± Znameidsr< Ú
isinstancer rc r Útagnamer râ rz r{ r rî rã r r r$ Úis_enumerable_nodeÚget_numfig_titleÚnextÚfindallr Útoctree) r7 r3 r rE r8 Úexplicitrò r_ r Úsectnamer r9 r9 r: Ú process_docÙ sB
zStandardDomain.process_doc)r r8 r rò r0 c C s ||f| j ||f< d S )N)rà )r7 r r8 r rò r9 r9 r: r s z!StandardDomain.add_program_optionr* )Ú fromdocnameÚbuilderr rò r Úrolenamer® r0 c K sº |j dtj}|d
ddi|} tj||}
|
jdd k rZ|
d jd |
d jd| ||krl|| d< n@td} || d < || d
< |j||| d < |r¬| d d | 7 < | j|
| S )NÚ nodeclassr- ZinternalTr¬ rA zstd-r Z
refdocnameZ refsectnamer ú#)r- r- )r r Ú referenceÚinliner rG r Zget_relative_uri) r7 r r r rò r r r® r ZnewnodeÚ innernodeÚcontnoder9 r9 r: Úbuild_reference_node s"
z#StandardDomain.build_reference_node)r3 r r Útyprc r_ r r0 c C sz |dkr| j }nV|dkr | j}nF|dkr0| j}n6|dkr@| j}n&|dkrP| j}n|dkr`| j}n| j}||||||||S )NrÓ rÛ rÔ rÖ r r¥ )Ú_resolve_ref_xrefÚ_resolve_numref_xrefÚ_resolve_keyword_xrefÚ_resolve_doc_xrefÚ_resolve_option_xrefÚ_resolve_term_xrefÚ_resolve_obj_xref) r7 r3 r r r rc r_ r Úresolverr9 r9 r: Ú resolve_xref s zStandardDomain.resolve_xrefc C sT |d r$| j j|d\}} |j }
n| jj|d\}} }
|s@d S | j|||| |
dS )NÚ refexplicitr- rÓ )r- r- )r- r- r- )rã r r§ râ r ) r7 r3 r r r rc r_ r r rò r r9 r9 r: r 2 s
z StandardDomain._resolve_ref_xrefc C sþ || j kr | j j|d\}} }
n| jj|d\}} d }
|s>d S |j|jj| } | j| } | d krfd S | dkr|jjdkrtj t
d|d |S y"| j ||| || }
|
d kr°|S W n( t k
rÚ tj t
d| |d |S X y¤|d rò|j
}n|jjj| d}|
d kr.d|kr.tj t
d ||d |S d
jtt|
}d|ksRd |krv|
rh|j|
|d }n |j|d
}n|| }W n` tk
r¸ } ztj t
d|||d |S d }~X n* tk
rà tj t
d||d |S X | j|||| |dtj|dS )Nr- r Fz(numfig is disabled. :numref: is ignored.)rB zBFailed to create a cross reference. Any number is not assigned: %sr$ z{name}zthe link has no caption: %sÚ.Únumber)r8 r& )r& z invalid numfig_format: %s (%r)zinvalid numfig_format: %srÛ )r r )r- r- r- )r- r- )râ r rã Z get_doctreer< Úget_enumerable_node_typeÚconfigZnumfigrz r{ r Ú
get_fignumberr~ r§ Z
numfig_formatr Úmapr\ ÚformatÚKeyErrorÚ TypeErrorr r Znumber_reference)r7 r3 r r r rc r_ r r rò ZfignameÚ target_nodeÚfigtypeZ fignumberr ZfignumZnewtitleÚexcr9 r9 r: r D sX
z#StandardDomain._resolve_numref_xrefc C s, | j j|d\}} }
|s d S t|||| |S )Nr- )r- r- r- )râ r r& ) r7 r3 r r r rc r_ r r rò r r9 r9 r: r s
z$StandardDomain._resolve_keyword_xrefc C sn |j d|}t||d } | |jkr(d S |d r:|j }
nt|j| }
tj|
|
dgd} t||| d | S d S )NÚrefdocra r$ rÖ )r¬ ) r r Úall_docsr§ r$ Útitlesr r r& ) r7 r3 r r r rc r_ r r1 r r r r9 r9 r: r s
z StandardDomain._resolve_doc_xrefc
C s |j d}|j }| jj ||fd\} }
| sg } xRtj|r~tj|d\} }| j| dj| }| jj ||fd\} }
| r2P q2W d S t||| |
|S )Nz std:programr- r> rW )r- r- )r- r- ) r rL rà r" rß rj rG r r& )
r7 r3 r r r rc r_ r Úprognamer rò ÚcommandsÚ
subcommandr9 r9 r: r s
z#StandardDomain._resolve_option_xrefc C sV | j |||||||}|r |S |j | jkrN| j|j \} }
t||| |
|S d S d S )N)r! rù rø r& ) r7 r3 r r r rc r_ r Úresultr rò r9 r9 r: r ´ s
z!StandardDomain._resolve_term_xrefc C s^ | j |p g }x6|D ]&} | |f| jkr| j| |f \}
} P qW d\}
} |
sNd S t|||
| |S )Nr- )r- r- )Zobjtypes_for_rolerá r& ) r7 r3 r r r rc r_ r ZobjtypesrF r rò r9 r9 r: r! Ã s
z StandardDomain._resolve_obj_xref)r3 r r rc r_ r r0 c C sº g }|j }xDdD ]<} | j|||| | dkr.|n|||}
|
r|jd| |
f qW xb| jD ]X} | |f} | dkrv| |f} | | jkrZ| j| \}
}|jd| j| t|||
||f qZW |S )NrÓ r zstd:r¥ )rÓ r )rù r# rG Ú object_typesrá Zrole_for_objtyper& )r7 r3 r r rc r_ r ÚresultsZltargetÚroleÚresrF rû r rò r9 r9 r: Úresolve_any_xrefÒ s$
z StandardDomain.resolve_any_xrefc c sN x.| j jD ]"}|t| j j| d|dd fV q
W xb| jj D ]T\\}}}|rvdj||g}||d|d |d dfV q<||d|d |d dfV q<W x@| jj D ]2\\}}}||||d |d | j| j d fV q W x.| j
j D ] \}\}} }
||
d|| d
fV qâW t | j
} x8| j j D ]*\}\}} || kr ||d|| d fV q W d S ) NrÖ r- r> r% r r rÒ r× rC rC rC )
r3 r2 r$ r3 rà r± r rá r8 Úattrsrâ Úsetrã ) r7 rÖ Úprogr Úinfork Útyper8 r rò Z sectionnameZnon_anon_labelsr9 r9 r: Ú get_objectsé s "
zStandardDomain.get_objectsF)rA Úprimaryr0 c C s |j S )N)Úlname)r7 rA rC r9 r9 r: Ú
get_type_nameþ s z StandardDomain.get_type_name)r_ r0 c C s |j | jkS )N)rí ré )r7 r_ r9 r9 r: r s z!StandardDomain.is_enumerable_nodec C s` | j |r\tt|}| jj|jd\}}|r4||S x&|D ] }t|tjtj fr:t
|S q:W dS )z?Get the title of enumerable nodes to refer them using its titleN)NN) r r r ré r rí r r r r r$ )r7 r_ Úelemr Z title_getterrÐ r9 r9 r: r s
z StandardDomain.get_numfig_titlec C sb t ttddd}t|tjr"dS t|tjrFd|krF||tjrFdS | jj |j
d\}}|S dS ) z Get type of enumerable nodes.)r_ Úclsr0 c s t fdd| D S )Nc 3 s | ]}t | V qd S )N)r )Ú.0Úchild)rG r9 r: ú <genexpr> s zMStandardDomain.get_enumerable_node_type.<locals>.has_child.<locals>.<genexpr>)Úany)r_ rG r9 )rG r: Ú has_child s z:StandardDomain.get_enumerable_node_type.<locals>.has_childr Ú
literal_blockz
code-blockN)NN) r r re r r r Ú containerrM ré r rí )r7 r_ rL r/ r r9 r9 r: r' s z'StandardDomain.get_enumerable_node_type.)r3 r r/ r r. r0 c C s¸ |dkrh|j dkrt S ||jkr(tq´d|d d }||j| krV|j| jdS |j| j|S nLy |d d }|j| | | S ttfk
r² } z t|W Y d d }~X nX d S )Nr Zlatexr r< r r- )r8 ÚtupleZtoc_secnumbersr~ r Ztoc_fignumbersr, Ú
IndexError) r7 r3 r r/ r r. Z
anchornameZ figure_idr0 r9 r9 r: r) # s
z StandardDomain.get_fignumberc C sf |j ddkr^|j d}tj|j d}|r8|jd| |j }|rXdjdj||gS d S nd S d S )Nr¾ r z std:programra r r% rW )r r" rj ri r r )r7 r_ r4 Úcommandr r9 r9 r: Úget_full_qualified_name: s
z&StandardDomain.get_full_qualified_namerC rC rC rC )rÜ r- )rÞ r- )rß r- )rä N)rå N)ræ N)r- )N)N)F)OrX rY rZ r[ r8 r× r r r8 r r\ r rt r] rª rÈ r r r r r^ rÑ r r r Zrolesr
r( Z initial_dataZdangling_warningsrä rå rN ré r r r
r rè rï Úpropertyrá r rP r÷ rø r¨ rà râ rã rý r r rE r r r r r r# r r r r r r r! r< r ÚintrB re rE r r r' r) rR Ú
__classcell__r9 r9 )rí r: rN sÊ
"& & (
(" )=
" rN r) )rê r r_ r0 c C sd |r|j dks|d dkr d S |d }||jkr:td}ntd}tj|| |d|d d dS d S ) NrA r¾ rÓ ra zundefined label: %szDFailed to create a cross reference. A title or caption not found: %s)rB rA ÚsubtypeT)r8 rã r rz r{ )rê r r_ rc Úmsgr9 r9 r: Úwarn_missing_referenceI s
rX )rê r0 c C s$ | j t | jdt dddddS )Nzwarn-missing-referenceÚbuiltinró T)ÚversionZ env_versionZparallel_read_safeZparallel_write_safe)Z
add_domainrN ÚconnectrX )rê r9 r9 r: ÚsetupX s
r\ )r- )\r[ r rõ r Útypingr r r r r r r r
r r r
r Zdocutilsr Zdocutils.nodesr r r Zdocutils.parsers.rstr r Zdocutils.statemachiner Zsphinxr Zsphinx.addnodesr r Zsphinx.deprecationr Zsphinx.directivesr Zsphinx.domainsr r Z
sphinx.localer r Z sphinx.rolesr Z sphinx.utilr r! r" Zsphinx.util.docutilsr# Zsphinx.util.nodesr$ r% r& Zsphinx.util.typingr' r( Zsphinx.applicationr) Zsphinx.buildersr* Zsphinx.environmentr+ Ú getLoggerrX rz rË rx ÚUr¿ r\ r, r] r^ rf rt r r r rT rE r¥ r© rª rÇ rÈ rÑ rN re rX r\ r9 r9 r9 r: Ú<module> sb 8
36P
r!A 4