3
T'íc!8 ã @ s d dl Z d dlmZmZmZmZmZ d dlmZ d dl m
Z
m Z d dl m
Z
d dlmZ d dlmZ d dlmZ d d lmZ d d
lmZ d d lmZmZ d d lm Z m Z m Z d d
l m Z d dl!m"Z"m#Z# d dl$m%Z% d dl&m'Z' erðd dl(m)Z) e j*dZ+e j,e-Z.e/e0dddZ1G dd de Z2G dd de Z3G dd deZ4G d d d e Z5G d d d e Z6G d d! d!e Z7G d"d# d#e Z8G d$d% d%e Z9G d&d' d'ee Zd(ee/ef d)d*d+Z:dS ),é N)Ú
TYPE_CHECKINGÚAnyÚDictÚListÚcast)Únodes)ÚElementÚNode)Ú
directives)ÚBaseAdmonition)ÚClass)ÚInclude)Úaddnodes)Ú
VersionChange)Ú_Ú__)Ú docname_joinÚloggingÚurl_re)ÚSphinxDirective)ÚMatcherÚ patfilter)Úexplicit_title_re)Ú
OptionSpec)ÚSphinxz
.*[*?\[].*)ÚargumentÚreturnc C s | sdS t | S )Niç )Úint)r © r ú9/tmp/pip-build-gk9425m9/sphinx/sphinx/directives/other.pyÚint_or_nothing s r c
@ sn e Zd ZdZdZdZdZdZee j
e j e j e j e j e
e j e j d Zee dddZejee d d
d Zd S )
ÚTocTreez
Directive to notify Sphinx about the hierarchical structure of the docs,
and to include a table-of-contents like tree in the current document.
Tr F) ÚmaxdepthÚnameÚcaptionÚglobÚhiddenÚ
includehiddenÚnumberedÚ
titlesonlyÚreversed)r c C sÔ t j }| jj|d< g |d< g |d< | jjdd|d< | jjd|d< d| jk|d< d| jk|d< d | jk|d < | jjd
d |d
< d | jk|d < | j| tjd
gd}|j | | j
| | j |}|j | |S )NÚparentÚentriesÚ includefilesr" é r$ r% r& r' r( r r) ztoctree-wrapper)Úclasseséÿÿÿÿ) r ÚtoctreeÚenvÚdocnameÚoptionsÚgetÚset_source_infor ZcompoundÚappendZadd_nameÚ
parse_content)ÚselfÚsubnodeZ wrappernodeÚretr r r Úrun7 s$
z TocTree.run)r1 r c C sZ | j j}| jjj }|j| jj g }t| j j}xì| j D ]à}|sHq<t
j |}|d rät j |rä| rät
j | rät| jj|}tt||} x6| D ].}
|j|
|d jd |
f |d j|
qW | sâtjtd||d q<|r|jd} |jd} | }
n | } }
d } x.|D ]&}
|
j|
r|
d t|
}
P qW t| jj|
}
t
j | sd| dkrx|d j| | f q<|
| jjkrÔ|| jj|
d r¨td }d
}n td }d }tj||
d
||d | jj q<|
|krê|j|
ntjtd|
|d |d j| |
f |d j|
q<W d| jkrVtt |d |d< tt |d |d< |S )Nr% r, r- z2toctree glob pattern %r didn't match any documents)Úlocationé r. r9 z2toctree contains reference to excluded document %rÚexcludedz5toctree contains reference to nonexisting document %rZ not_readableZtoc)ÚtypeÚsubtyper= z%duplicated entry found in toctree: %sr* ) ÚconfigZ
source_suffixr2 Z
found_docsÚcopyÚremover3 r Zexclude_patternsÚcontentr ÚmatchÚglob_rer r Úsortedr r7 ÚloggerÚwarningr ÚgroupÚendswithÚlenZdoc2pathZ note_rereadr4 Úlistr* )r9 r1 ÚsuffixesZ all_docnamesr; r? ÚentryÚexplicitZpatnameZdocnamesr3 ÚrefÚtitleÚsuffixÚmessagerA r r r r8 O sh
zTocTree.parse_contentN)Ú__name__Ú
__module__Ú __qualname__Ú__doc__Ú has_contentÚrequired_argumentsÚoptional_argumentsÚfinal_argument_whitespacer r
Z unchangedZunchanged_requiredÚflagr Ú option_specr r r< r r1 r8 r r r r r! " s
r! c @ s< e Zd ZU dZdZdZdZdZi Ze e
e dddZ d S )
ÚAuthorz
Directive to give the name of the author of the current document
or section. Shown in the output only if the show_authors option is on.
Fr. r T)r c C s² | j js g S tjdd}tj }||7 }| jdkr<td}n0| jdkrPtd}n | jdkrdtd}ntd }|tj||7 }| jj | j
d
| j \}}|j | |g}||7 }|S ) NF)Z translatableÚ
sectionauthorzSection author: Ú moduleauthorzModule author: Ú
codeauthorz
Code author: zAuthor: r )
rB Z show_authorsr Ú paragraphZemphasisr# r ZTextÚstateÚ inline_textÚ argumentsÚlinenoÚextend)r9 ÚparaZemphÚtextÚinodesÚmessagesr; r r r r< ¡ s$
z
Author.runN)
rV rW rX rY rZ r[ r\ r] r_ r r r r< r r r r r` s
r` c @ s e Zd ZdZejZdS )ÚSeeAlsozB
An admonition mentioning things to look at as reference.
N)rV rW rX rY r ÚseealsoZ
node_classr r r r rn ¸ s rn c @ s< e Zd ZU dZdZdZdZdZi Ze e
e dddZ d S )
ÚTabularColumnszL
Directive to give an explicit tabulary column definition to LaTeX.
Fr. r T)r c C s& t j }| jd |d< | j| |gS )Nr Úspec)r Ztabular_col_specrg r6 )r9 Únoder r r r< É s
zTabularColumns.runN)
rV rW rX rY rZ r[ r\ r] r_ r r r r< r r r r rp ¿ s
rp c @ s< e Zd ZU dZdZdZdZdZi Ze e
e dddZ d S )
ÚCenteredz;
Directive to create a centered line of bold text.
Fr. r T)r c C sH | j s
g S tj }| jj| j d | j\}}|j| |g}||7 }|S )Nr )rg r Úcenteredre rf rh ri )r9 r: rl rm r; r r r r< Ú s
z Centered.runN)
rV rW rX rY rZ r[ r\ r] r_ r r r r< r r r r rs Ð s
rs c @ s< e Zd ZU dZdZdZdZdZi Ze e
e dddZ dS ) ÚAcksz(
Directive for a list of names.
Tr F)r c C sn t j }| jj|_| jj| j| j| t|jdksHt |jd t
j rht j
td| jj| jfd g S |gS )Nr. r z .. acks content is not a list)r= )r Úacksre ÚdocumentÚ nested_parserE Úcontent_offsetrM ÚchildrenÚ
isinstancer Ú bullet_listrI rJ r r2 r3 rh )r9 rr r r r r< ð s
zAcks.runN)
rV rW rX rY rZ r[ r\ r] r_ r r r r< r r r r ru æ s
ru c @ s@ e Zd ZU dZdZdZdZdZdeiZ e
e e dddZ
d S )
ÚHListz@
Directive for a list that gets compacted horizontally.
Tr FÚcolumns)r c C s | j jdd}tj }| jj|_| jj| j| j| t |j
dksVt |j
d tj rvt
jtd| jj| jfd g S |j
d }tt ||\}}d}tj }t||d< xVt|D ]J}|||k rÊ|d n| } tj }
|
|j
||
7 }
|tjd|
7 }| }q´W |gS ) Nr~ r> r. r z .. hlist content is not a list)r= ÚncolumnsÚ )r4 r5 r rd re rw rx rE ry rM rz r{ r| rI rJ r r2 r3 rh Údivmodr ÚhlistÚstrÚrangeZhlistcol) r9 r rr ZfulllistZnpercolZnmoreÚindexZnewnodeÚcolumnZendindexr| r r r r< s*
z HList.runN)rV rW rX rY rZ r[ r\ r] r r_ r r r r< r r r r r} ü s
r} c @ s< e Zd ZU dZdZdZdZdZi Ze e
e dddZ dS ) ÚOnlyzI
Directive to only include text if the given tag(s) are enabled.
Tr. r )r c C s> t j }| jj|_| j| | jd |d< | jj}|j}|j}g |_d|_zà| jj | j
| j |dd |j}| s| s|d |ks| jj r|gS d}| jj }x|r´|d7 }|j }q W |d8 }|d }t
|} ||krà|j|} || d }
ttj| jj }x t|
D ]} |j r|j }qW |j| g S ||_||_X d S )Nr ÚexprT)Z match_titlesr. r> )r Úonlyre rw r6 rg ÚmemoÚ title_stylesZ
section_levelrx rE ry r+ rM r
r r r r r7 ) r9 rr r Zsurrounding_title_stylesZsurrounding_section_levelr Z
current_depthr+ Z title_styleZ nested_depthZn_sects_to_raiseZ_ir r r r< + sJ
zOnly.runN)
rV rW rX rY rZ r[ r\ r] r_ r r r r< r r r r r ! s
r c s* e Zd ZdZee d fdd Z ZS )r
z
Like the standard "Include" directive, but interprets absolute paths
"correctly", i.e. relative to source directory.
)r c s` | j d jdr*| j d jdr*t j S | jj| j d \}}|| j d< | jj| t j S )Nr ú<ú>)rg Ú
startswithrL Úsuperr< r2 Z
relfn2pathZ
note_included)r9 Z rel_filenameÚfilename)Ú __class__r r r< a s
z Include.run)rV rW rX rY r r r< Ú
__classcell__r r )r r r
[ s r
r )Úappr c C s¨ t jdt t jdt t jdt t jdt t jdt t jdt t jdt t jdt t jd t t jd
t t jd t
t jd t t jd
t ddddS )Nr1 ra rb rc ro Ztabularcolumnsrt rv r r ÚincludeZcssclassz rst-classÚbuiltinT)ÚversionZparallel_read_safeZparallel_write_safe) r
Zregister_directiver! r` rn rp rs ru r} r r
r )r r r r Úsetupl s r );ÚreÚtypingr r r r r Zdocutilsr Zdocutils.nodesr r Zdocutils.parsers.rstr
Z+docutils.parsers.rst.directives.admonitionsr Z$docutils.parsers.rst.directives.miscr r
Z BaseIncludeZsphinxr Zsphinx.domains.changesetr Z
sphinx.localer r Z sphinx.utilr r r Zsphinx.util.docutilsr Zsphinx.util.matchingr r Zsphinx.util.nodesr Zsphinx.util.typingr Zsphinx.applicationr ÚcompilerG Ú getLoggerrV rI r r r r! r` rn rp rs ru r} r r r r r r Ú<module> s<
t"%: