3
T'íc
' ã @ s d Z ddlZddlmZmZmZmZmZmZm Z ddl
m Z ddl m
Z
ddlmZ ddlmZmZ ddlmZ dd lmZ dd
lmZ dd lmZmZ dd l m Z dd
l m Z m Z ddl!m"Z" ddl#m$Z$ ddl%m&Z&m'Z' ddl(m)Z) e$j*e+Z,ej-dZ.G dd dee/ Z0e/ee/e/f dddZ1G dd de0Z2G dd de0Z3G d d d e0Z4G d d d eZ5eee/ef d d!d"Z6dS )#z The reStructuredText domain.é N)ÚAnyÚDictÚIteratorÚListÚOptionalÚTupleÚcast)ÚElement)Ú
directives)Úaddnodes)Údesc_signatureÚ pending_xref)ÚSphinx)ÚBuilder)ÚObjectDescription)ÚDomainÚObjType)ÚBuildEnvironment)Ú_Ú__)ÚXRefRole)Úlogging)Úmake_idÚ make_refnode)Ú
OptionSpecz\.\. (.+?)::(.*)$c @ sF e Zd ZdZeeeddddZeeedddZeed d
d ZdS ) Ú
ReSTMarkupz-
Description of generic reST markup.
N)ÚnameÚsigÚsignodeÚreturnc C sº t | j| jj| j|}|d j| | j|}|| jjjkrV||d krV|d j| | jjj| t t
| jj d}|j | j|||d | j
| j|}|r¶| jd jd||dd f d S )NÚidsÚrst)ÚlocationÚentriesÚsingleÚ )r ÚenvÚstateÚdocumentÚobjtypeÚappendÚ make_old_idr Únote_explicit_targetr Ú
ReSTDomainÚ
get_domainÚ note_objectÚget_index_textÚ indexnode)Úselfr r r Únode_idÚ old_node_idÚdomainZ indextext© r6 ú4/tmp/pip-build-gk9425m9/sphinx/sphinx/domains/rst.pyÚadd_target_and_index s
z ReSTMarkup.add_target_and_index)Ú
objectnamer r c C s dS )Nr% r6 )r2 r9 r r6 r6 r7 r0 3 s zReSTMarkup.get_index_text)r r c C s | j d | S )zGenerate old styled node_id for reST markups.
.. note:: Old Styled node_id was used until Sphinx-3.0.
This will be removed in Sphinx-5.0.
ú-)r) )r2 r r6 r6 r7 r+ 6 s zReSTMarkup.make_old_id) Ú__name__Ú
__module__Ú __qualname__Ú__doc__Ústrr r8 r0 r+ r6 r6 r6 r7 r s r )Údr c C sh | j }|jds|dfS tj|}|s0|dfS |j \}}|j rX|j d|j fS |j dfS dS )zParse a directive signature.
Returns (directive, arguments) string tuple. If no arguments are given,
returns (directive, '').
Ú.r% ú N)ÚstripÚ
startswithÚ
dir_sig_reÚmatchÚgroups)r@ ÚdirÚmZ
parsed_dirZ parsed_argsr6 r6 r7 Úparse_directive? s
rJ c @ sP e Zd ZdZeeedddZeeedddZdd d
d Zdd d d
Z dS )Ú
ReSTDirectivez*
Description of a reST directive.
)r r r c C sD t |\}}d| }|tj||7 }t|dkr@|tj||7 }|S )Nz.. %s::r )rJ r Ú desc_nameÚlenZ desc_addname)r2 r r r ÚargsrL r6 r6 r7 Úhandle_signatureW s z ReSTDirective.handle_signature)r9 r r c C s t d| S )Nz%s (directive))r )r2 r9 r r6 r6 r7 r0 _ s z ReSTDirective.get_index_textN)r c C s* | j r&| jjjdg }|j| j d d S )Nzrst:directivesr )Únamesr& Ú ref_contextÚ
setdefaultr* )r2 r
r6 r6 r7 Úbefore_contentb s z ReSTDirective.before_contentc C s | j jjdg }|r |j d S )Nzrst:directives)r& rQ rR Úpop)r2 r
r6 r6 r7 Ú
after_contentg s zReSTDirective.after_content)
r; r< r= r> r? r rO r0 rS rU r6 r6 r6 r7 rK S s
rK c @ sx e Zd ZU dZejj Zeejde j
i e e e dddZ
e e e dddd Zee d
d d Ze e d
ddZdS )ÚReSTDirectiveOptionz6
Description of an option for reST directive.
Útype)r r r c
C s yt jd|j d\}}W n tk
r8 |d }}Y nX |tjd| d| 7 }|rn|tjd| d| 7 }| jjdrd| jd }|tj||7 }|S )Nz\s*:\s+é z:%s:rB rW z (%s)) ÚreÚsplitrC Ú
ValueErrorr rL Zdesc_annotationÚoptionsÚget)r2 r r r ÚargumentÚtextr6 r6 r7 rO v s z$ReSTDirectiveOption.handle_signatureN)r r r r c
C s> t t| jjd}| j}|r<dj| j|g}dj||g}n
| j}|}t| j| jj ||}|d j
| | j |} | | jj j kr| |d kr|d j
| | jj j
| |j| j|||d |r|d j }
td| td| g} | jd j
d
d j| |d |
f n2|d j }
td| } | jd j
d
| |d |
f d S )Nr! r: ú:r )r" r z%s (directive)z:%s: (directive option)r# Úpairz; r% r$ )r r- r& r. Úcurrent_directiveÚjoinr) r r' r( r* r+ r r, r/ Úupperr r1 )
r2 r r r r5 Zdirective_nameÚprefixZobjnamer3 r4 Úkeyra r_ r6 r6 r7 r8 s,
" z(ReSTDirectiveOption.add_target_and_index)r c C s" | j jjd}|r|d S dS d S )Nzrst:directivesrX r% éÿÿÿÿ)r& rQ r] )r2 r
r6 r6 r7 rb ¥ s z%ReSTDirectiveOption.current_directive)r r c C s dj | j| j|gS )z²Generate old styled node_id for directive options.
.. note:: Old Styled node_id was used until Sphinx-3.0.
This will be removed in Sphinx-5.0.
r: )rc r) rb )r2 r r6 r6 r7 r+ s z ReSTDirectiveOption.make_old_id)r; r< r= r> r Z option_specÚcopyr Úupdater
Z unchangedr? r rO r8 Úpropertyrb r+ r6 r6 r6 r7 rV m s
!rV c @ s4 e Zd ZdZeeedddZeeedddZdS ) ÚReSTRolez%
Description of a reST role.
)r r r c C s |t jd| d| 7 }|S )Nz:%s:)r rL )r2 r r r6 r6 r7 rO º s zReSTRole.handle_signature)r9 r r c C s t d| S )Nz %s (role))r )r2 r9 r r6 r6 r7 r0 ¾ s zReSTRole.get_index_textN)r; r< r= r> r? r rO r0 r6 r6 r6 r7 rk ¶ s rk c
@ sR e Zd ZU dZdZdZeeddeeddeedddZe e
e dZ e
e
d Zd
i iZeeeeeef ef f eeeeef eeef f d d d
Zd eeeeddddZeddddZee eddddZeeeeee e e e dddZ eeeee e eeee f dd d Z e!eeeeeee"f d d d Z#dS )!r- zReStructuredText domain.r! ZreStructuredTextÚ directiverH zdirective-optionÚrole)rl zdirective:optionrm )rH rm Úobjects)r c C s | j jdi S )Nrn )ÚdatarR )r2 r6 r6 r7 rn Ù s zReSTDomain.objectsN)r) r r3 r" r c C sV ||f| j kr<| j ||f \}}tjtd|||f |d | jj|f| j ||f< d S )Nz4duplicate description of %s %s, other instance in %s)r" )rn ÚloggerÚwarningr r& Údocname)r2 r) r r3 r" rr r6 r6 r7 r/ Ý s
zReSTDomain.note_object)rr r c C s< x6t | jj D ]$\\}}\}}||kr| j||f= qW d S )N)Úlistrn Úitems)r2 rr Útypr ÚdocZ_node_idr6 r6 r7 Ú clear_docå s zReSTDomain.clear_doc)ÚdocnamesÚ otherdatar c C s@ x:|d j D ]*\\}}\}}||kr||f| j||f< qW d S )Nrn )rt rn )r2 rx ry ru r rv r3 r6 r6 r7 Úmerge_domaindataê s zReSTDomain.merge_domaindata)r& Ú fromdocnameÚbuilderru ÚtargetÚnodeÚcontnoder c C sP | j |}x@|D ]8} | jj| |fd\}
} |
rt|||
| ||d | S qW d S )NrB )NN)Zobjtypes_for_rolern r] r ) r2 r& r{ r| ru r} r~ r Zobjtypesr) Ú todocnamer3 r6 r6 r7 Ú resolve_xrefð s
zReSTDomain.resolve_xref)r& r{ r| r} r~ r r c C s` g }xV| j D ]L}| jj||fd\} }
| r |jd| j| t||| |
||d | f q W |S )Nzrst:rB )NN)Ú object_typesrn r] r* Zrole_for_objtyper ) r2 r& r{ r| r} r~ r Úresultsr) r r3 r6 r6 r7 Úresolve_any_xrefû s
zReSTDomain.resolve_any_xrefc c s: x4| j d j D ]"\\}}\}}|||||dfV qW d S )Nrn rX )ro rt )r2 ru r rr r3 r6 r6 r7 Ú get_objects s zReSTDomain.get_objects)N)$r; r< r= r> r Úlabelr r r rK rV rk r
r ZrolesZ initial_datar r? r rj rn r r/ rw r rz r r r
r r r r r Úintr
r6 r6 r6 r7 r- Â s0
$(
r- )Úappr c C s | j t dddddS )NÚbuiltiné T)ÚversionZ env_versionZparallel_read_safeZparallel_write_safe)Z
add_domainr- )r r6 r6 r7 Úsetup s
r )7r> rY Útypingr r r r r r r Zdocutils.nodesr Zdocutils.parsers.rstr
Zsphinxr Zsphinx.addnodesr r
Zsphinx.applicationr Zsphinx.buildersr Zsphinx.directivesr Zsphinx.domainsr r Zsphinx.environmentr Z
sphinx.localer r Z sphinx.rolesr Z sphinx.utilr Zsphinx.util.nodesr r Zsphinx.util.typingr Ú getLoggerr; rp ÚcompilerE r? r rJ rK rV rk r- r r6 r6 r6 r7 Ú<module> s2 $
$I J