3
T'ícG ã @ st d dl Z d dlZd dlmZ d dlmZmZmZmZm Z d dl
m Z d dl m
Z
mZ d dlmZ d dlmZ d dlmZ d d lmZ d d
lmZ d d lmZ d d lm Z m Z d d
l m Z d dl m!Z! erÔd dl"m#Z# e j$e%Z&G dd de Z'd"ee( e)e e(e)f ee( dddZ*e ee(e j+dddZ,G dd de Z-G dd dZ.G d d d e Z/d ee(ef d d d!Z0dS )#é N)Ú unified_diff)Ú
TYPE_CHECKINGÚAnyÚDictÚListÚTuple)Únodes)ÚElementÚNode)Ú
directives)Ú
StringList)Úaddnodes)ÚConfig)Ú optional_int)Ú__)ÚloggingÚ parselinenos)ÚSphinxDirective)Ú
OptionSpec)ÚSphinxc @ sF e Zd ZU dZdZdZdZdZej ej
dZ e e
e dddZd S )
Ú Highlightzt
Directive to set the highlighting language for code blocks, as well
as the threshold for line numbers.
Fé r )ÚforceÚlinenothreshold)Úreturnc C sF | j d j }| jjdtj}d| jk}|| jjd< tj |||dgS )Nr r r Úhighlight_language)Úlangr r )
Ú argumentsÚstripÚoptionsÚgetÚsysÚmaxsizeÚenvÚ temp_datar
Z
highlightlang)ÚselfÚlanguager r © r' ú8/tmp/pip-build-gk9425m9/sphinx/sphinx/directives/code.pyÚrun( s
z
Highlight.runN)Ú__name__Ú
__module__Ú __qualname__Ú__doc__Ú has_contentÚrequired_argumentsÚoptional_argumentsÚfinal_argument_whitespacer ÚflagZ positive_intÚ option_specr r r
r) r' r' r' r( r s
r )ÚlinesÚdedentÚlocationr c s d kr t jdj| jdS t fdd| D rFtjtd|d g }x6| D ].}| d
}|jdrt| rtd}|j | qPW |S )NÚ Tc 3 s | ]}|d
j V qd S )N)r )Ú.0Ús)r5 r' r( ú <genexpr>7 s z dedent_lines.<locals>.<genexpr>z!non-whitespace stripped by dedent)r6 Ú
)
Útextwrapr5 ÚjoinÚ
splitlinesÚanyÚloggerÚwarningr ÚendswithÚappend)r4 r5 r6 Ú new_linesÚlineÚnew_liner' )r5 r( Ú dedent_lines3 s
rG )Ú directiveÚ literal_nodeÚcaptionr c C s¾ t jdddgd}t j }| jjt|gdd| j| t|d t jrdt d|d j
}t |nVt|d t jr¶t j |d j
df|d j }|j|_|j|_||7 }||7 }|S td S )Nr7 Tzliteral-block-wrapper)Ú
literal_blockÚclasses)Úsourcer zInvalid caption: %s)r Ú containerr ÚstateZ nested_parser Zcontent_offsetÚ
isinstanceZsystem_messager ZastextÚ
ValueErrorrJ Z rawsourceÚchildrenrM rE Ú RuntimeError)rH rI rJ Zcontainer_nodeÚparsedÚmsgZ caption_noder' r' r( Úcontainer_wrapperD s"
rV c @ sZ e Zd ZU dZdZdZdZdZej ej e
e ej ej ej
ejdZeee ddd Zd
S ) Ú CodeBlockz^
Directive for a code block with special highlighting or line numbering
settings.
Tr r F)r Úlinenosr5 z lineno-startzemphasize-linesrJ ÚclassÚname)r c s8 | j j}dj| j}| jj| j}| jjd}|rÆy`t | j t
| }t fdd|D r~t j
td | jd f |d fdd|D }W qÊ tk
r } z|jj
|| jd gS d }~X qÊX nd }d
| jkr | jj| j}|jd }t|| jd
|d}d j|}tj||}d
| jks0d| jkr8d |d
< |d | jjdg 7 < d| jk|d< | jrx| jd |d< n| jjjd| jj|d< i } |d< |d k r®|| d< d| jkrÈ| jd | d< | j| | jjd}
|
r(yt| ||
}W n2 tk
r& } z|jj
| | jd gS d } ~ X nX | j | |gS )Nr; zemphasize-linesc 3 s | ]}| kV qd S )Nr' )r8 Úi)Únlinesr' r( r: x s z CodeBlock.run.<locals>.<genexpr>z*line number spec is out of range(1-%d): %r)r6 c s g | ]}| k r|d qS )r r' )r8 Úx)r\ r' r( ú
<listcomp>} s z!CodeBlock.run.<locals>.<listcomp>)rE r5 Tr7 rX z lineno-startrL rY r r r& r Úhighlight_argsÚhl_linesÚ linenostartrJ ) rO Údocumentr= ÚcontentÚ
state_machineÚget_source_and_lineÚlinenor r Úlenr r? r@ rA r rQ Úreporterr> rG r rK r r# r$ Úconfigr Úset_source_inforV Úadd_name) r% rb Úcoder6 Úlinespecr` Úerrr4 ÚliteralÚ
extra_argsrJ Úexcr' )r\ r( r) n sX
"
z
CodeBlock.runN)r* r+ r, r- r. r/ r0 r1 r r2 r ÚintÚunchanged_requiredÚ class_optionÚ unchangedr3 r r r
r) r' r' r' r( rW Y s
rW c @ s¨ e Zd Zd*d+d,d-d.d/d0d1d2d3d4d5d6g
Zeeed d
ddZd dddZd7ee ee
f e e dddZ d8e ee
f e ee
f dddZ
d9e ee
f e e dddZd:e e e ee
f e e dd d Zd;e e e ee
f e e dd d Zd<e e e ee
f e e dd d!Zd=e e e ee
f e e dd"d#Zd>e e e ee
f e e dd$d%Zd?e e e ee
f e e dd&d'Zd@e e e ee
f e e dd(d)Zd S )AÚLiteralIncludeReaderú lineno-matchú lineno-startrC Úprependú start-afterústart-atú
end-beforeúend-atÚdiffÚpyobjectr4 N)Úfilenamer ri r c C s8 || _ || _|jd|j| _| jjdd| _| j d S )NÚencodingz lineno-startr )r r r Zsource_encodingr Ú lineno_startÚ
parse_options)r% r r ri r' r' r( Ú__init__½ s
z LiteralIncludeReader.__init__)r c C s@ x:| j D ]0\}}|| jkr|| jkrttd||f qW d S )Nz%Cannot use both "%s" and "%s" options)ÚINVALID_OPTIONS_PAIRr rQ r )r% Zoption1Zoption2r' r' r( r Å s z"LiteralIncludeReader.parse_options)r r6 r c C sº yHt || jdd.}|j }d| jkr6|j| jd }|jdS Q R X W nl tk
r| } zttd| |W Y d d }~X n: tk
r´ } z ttd| j|f |W Y d d }~X nX d S )NÚstrict)r Úerrorsz tab-widthTz.Include file %r not found or reading it failedz`Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option) Úopenr Úreadr Ú
expandtabsr> ÚOSErrorr Ú UnicodeError)r% r r6 ÚfÚtextrq r' r' r( Ú read_fileË s
z LiteralIncludeReader.read_file)r6 r c C sp d| j kr| j }nJ| j| j| j| j| j| j| jg}| j | j
|d}x|D ]}|||d}qJW dj |t |fS )Nr~ )r6 r7 )
r Ú show_diffÚpyobject_filterÚ start_filterÚ
end_filterÚ lines_filterÚprepend_filterÚ
append_filterÚ
dedent_filterr r r= rg )r% r6 r4 ÚfiltersÚfuncr' r' r( r Û s
zLiteralIncludeReader.readc C s: | j | j}| jjd}| j |}t|||| j}t|S )Nr~ )r r r r r Úlist)r% r6 rD Z old_filenameZ old_linesr~ r' r' r( r ì s
z LiteralIncludeReader.show_diff)r4 r6 r c C s | j jd}|rddlm} |j| jd}|j }||krRttd|| jf n8|| d }|| d }||d |
}d| j kr|| _ |S ) Nr r )ÚModuleAnalyzerr7 z,Object named %r not found in include file %rr é z lineno-match)
r r Z
sphinx.pycoder Zfor_filer Z find_tagsrQ r r ) r% r4 r6 r r ZanalyzerÚtagsÚstartÚendr' r' r( r ó s
z$LiteralIncludeReader.pyobject_filterc sÒ | j jd}|rÎt|t}tfdd|D rRtjtdt|f |d d| j kr|d t fddt |D r| j
|d 7 _
n t td fd
d |D g krÎt td || j f S )
Nr4 c 3 s | ]}|t kV qd S )N)rg )r8 r[ )r4 r' r( r: s z4LiteralIncludeReader.lines_filter.<locals>.<genexpr>z*line number spec is out of range(1-%d): %r)r6 z lineno-matchr c 3 s | ]\}} | |kV qd S )Nr' )r8 r[ Ún)Úfirstr' r( r: s z8Cannot use "lineno-match" with a disjoint set of "lines"c s g | ]}|t k r | qS r' )rg )r8 r )r4 r' r( r^ s z5LiteralIncludeReader.lines_filter.<locals>.<listcomp>z2Line spec %r: no lines pulled from include file %r)
r r r rg r? r@ rA r ÚallÚ enumerater rQ r )r% r4 r6 rm Zlinelistr' )r¡ r4 r( r s
z!LiteralIncludeReader.lines_filterc C sØ d| j kr | j jd}d}n d| j kr8| j jd}d}nd }|rÔxpt|D ]d\}}||krJ|rd| j krz| j|d 7 _||d d
S d| j kr¢| j|7 _||d
S qJW |dkrÈtd| n td| |S ) Nzstart-atFz start-afterTz lineno-matchr z!start-after pattern not found: %sz start-at pattern not found: %s)r r r£ r rQ )r% r4 r6 r Ú inclusiverf rE r' r' r( r s*
z!LiteralIncludeReader.start_filterc C s® d| j kr | j jd}d}n d| j kr8| j jd}d}nd }|rªxFt|D ]:\}}||krJ|rn|d |d
S |dkrxqJ|d |
S qJW |dkrtd| n td| |S ) Nzend-atTz
end-beforeFr r z end-at pattern not found: %sz end-before pattern not found: %s)r r r£ rQ )r% r4 r6 r r¤ rf rE r' r' r( r < s&
z LiteralIncludeReader.end_filterc C s$ | j jd}|r |jd|d |S )Nry r r; )r r Úinsert)r% r4 r6 ry r' r' r( r W s z#LiteralIncludeReader.prepend_filterc C s" | j jd}|r |j|d |S )NrC r; )r r rC )r% r4 r6 rC r' r' r( r ^ s z"LiteralIncludeReader.append_filterc C s( d| j kr t|| j jd|dS |S d S )Nr5 )r6 )r rG r )r% r4 r6 r' r' r( r e s
z"LiteralIncludeReader.dedent_filter)rw rx )rw rC )rw ry )rz r{ )r| r} )r~ r )r~ rx )r~ rw )r~ r4 )r~ rz )r~ r| )r~ r{ )r~ r} )N)N)N)N)N)N)N)N)N)N)r* r+ r, r
Ústrr r r r r rr r r r r r r r r r r r r' r' r' r( rv ¬ s2 " $$$ $$$rv c @ s e Zd ZU dZdZdZdZdZee j
e e j
e e j e j
e j
e j e j e j e j e j e j e j e j e j e je je je j dZeee ddd Zd
S ) ÚLiteralIncludez·
Like ``.. include:: :literal:``, but only warns if the include file is
not found, and does not raise errors. Also has several options for
selecting what to include.
Fr r T)r5 rX z lineno-startz lineno-matchz tab-widthr& r r r r4 z start-afterz
end-beforezstart-atzend-atry rC zemphasize-linesrJ rY rZ r~ )r c s2 | j j}|jjs$|jjd| jdgS d| jkrN| jj | jd \}}|| jd< yª| j
j | j}| jj | j d \}}| jj
| t|| j| j}|j|d\} tj|||d} d| jk| d< | j| | jjdràd| d < nd | jkrø| jd | d < d
| jks d | jks d | jkr$d
| d
< | d | jjdg 7 < i }
| d< d| jkr´t| jd } t fdd| D rtjtd | jd f |d fdd| D |
d< |j|
d< d| jkrì| jd pÞ| j d } t| | | } | j| | gS t k
r, }
z|jj|
| jdgS d }
~
X nX d S )NzFile insertion disabled)rE r~ r )r6 )rM r Zudiffr& rX z lineno-startz lineno-matchTrL rY r_ zemphasize-linesc 3 s | ]}| kV qd S )Nr' )r8 r[ )r4 r' r( r: ¯ s z%LiteralInclude.run.<locals>.<genexpr>z*line number spec is out of range(1-%d): %rc s g | ]}| k r|d qS )r r' )r8 r] )r4 r' r( r^ ³ s z&LiteralInclude.run.<locals>.<listcomp>r` ra rJ ) rO rb ÚsettingsZfile_insertion_enabledrh rA rf r r# Z
relfn2pathrd re r Znote_dependencyrv ri r r rK rj r r r? r@ r r rV rk Ú Exception)r% rb Ú_Úpathr6 Z rel_filenamer Úreaderr Zretnoderp r` rJ rq r' )r4 r( r) sP
zLiteralInclude.runN)r* r+ r, r- r. r/ r0 r1 r r r2 rr rs r ru rt r3 r r r
r) r' r' r' r( r§ l s6
r§ r )Úappr c C s< t jdt t jdt t jdt t jdt ddddS )NZ highlightz
code-blockZ
sourcecodeZliteralincludeÚbuiltinT)ÚversionZparallel_read_safeZparallel_write_safe)r Zregister_directiver rW r§ )r r' r' r( Úsetupà s r° )N)1r! r< Údifflibr Útypingr r r r r Zdocutilsr Zdocutils.nodesr r
Zdocutils.parsers.rstr Zdocutils.statemachiner Zsphinxr
Z
sphinx.configr Zsphinx.directivesr Z
sphinx.localer Z sphinx.utilr r Zsphinx.util.docutilsr Zsphinx.util.typingr Zsphinx.applicationr Ú getLoggerr* r@ r r¦ rr rG rN rV rW rv r§ r° r' r' r' r( Ú<module> s2
&S AW