3
T'íck ã @ s d Z ddlmZ ddlmZ ddlmZmZmZm Z m
Z
m Z m Z m
Z
ddlmZmZmZ ddlmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd l m Z dd l m Z ydd
lm Z W n e!k
rÜ ddlm"Z Y nX erîddl#m$Z$ e%e&dddZ'e%e(dddZ)e
e(e%f e%dddZ*e e(e
e dddZ+ee%e%ddd Z,G d d d Z-e e e%eee%d d d!Z.G d"d# d#eZ/G d$d% d%eeZ0d&S )'z+Glue code for the jinja2 templating engine.é )Úpath)Úpformat)Ú
TYPE_CHECKINGÚAnyÚCallableÚDictÚIteratorÚListÚTupleÚUnion)Ú
BaseLoaderÚFileSystemLoaderÚTemplateNotFound)Ú Environment)ÚSandboxedEnvironment)Úopen_if_exists)ÚTemplateBridge)ÚTheme)Úlogging)Úmtimes_of_files)Ú pass_context)Úcontextfunction)ÚBuilder)ÚvalÚreturnc C s t | tr| j dkS t| S )NÚtrueÚ1ÚyesÚon)r r r r )Ú
isinstanceÚstrÚlowerÚbool)r © r# ú3/tmp/pip-build-gk9425m9/sphinx/sphinx/jinja2glue.pyÚ_tobool s
r% c C s" yt | S tk
r dS X d S )Nr )ÚintÚ
ValueError)r r# r# r$ Ú_toint s r( c C s4 | dkr dS t | j r0t| dkr(dS d| S | S )a
Make val a css dimension. In particular the following transformations
are performed:
- None -> 'initial' (default CSS value)
- 0 -> '0'
- ints and string representations of ints are interpreted as pixels.
Everything else is returned unchanged.
NÚinitialr Ú0z%spx)r Úisdigitr& )r r# r# r$ Ú_todim' s
r, )ÚvaluesÚslicesr c
c sÀ t | }d}x$| D ] }|dt|d d 7 }qW || }d}x|t|D ]p}d}|} ||d krjt|}n@x>| |d
D ].}|dt|d d 7 }|d7 }||krxP qxW || |
V qHW d S )Nr é )ÚlistÚlenÚrange)
r- r. ÚseqÚlengthÚvalueZitems_per_sliceÚoffsetZ slice_numberÚcountÚstartr# r# r$ Ú _slice_index9 s"
r9 )ÚcontextÚkeyr c C s> d| kri | j d< |r:|| j d kr:d| j d |< d| S dS )z+Helper to output each access key only once.Z _accesskeysr/ zaccesskey="%s"Ú )Úvars)r: r; r# r# r$ Ú accesskeyN s
r> c @ s: e Zd ZddddZedddZedddZeZdS ) ÚidgenN)r c C s
d| _ d S )Nr )Úid)Úselfr# r# r$ Ú__init__Y s zidgen.__init__c C s | j S )N)r@ )rA r# r# r$ Úcurrent\ s z
idgen.currentc C s | j d7 _ | j S )Nr/ )r@ )rA r# r# r$ Ú__next___ s zidgen.__next__)Ú__name__Ú
__module__Ú __qualname__rB r& rC rD Únextr# r# r# r$ r? X s r? )r: ÚmessageÚargsÚkwargsr c O sJ d| kr*| j d| j dd }d||f }tjd}|j|f|| dS )NZpagenameZ file_suffixr< zin rendering %s: %sz
sphinx.themes)Úgetr Ú getLoggerÚwarning)r: rI rJ rK ÚfilenameÚloggerr# r# r$ rN e s
rN c @ s, e Zd ZdZeeeeeef dddZdS )ÚSphinxFileSystemLoaderzd
FileSystemLoader subclass that is not so strict about '..' entries in
template names.
)Ú environmentÚtemplater c s xr| j D ]h}tj|| t }|d kr*q| |j j| j}W d Q R X tj td fdd }| |fS W t |d S )N)r c s( yt j kS tk
r" dS X d S )NF)r ÚgetmtimeÚOSErrorr# )rO Úmtimer# r$ Úuptodate s z3SphinxFileSystemLoader.get_source.<locals>.uptodate)
Ú
searchpathr Újoinr ÚreadÚdecodeÚencodingrT r" r )rA rR rS rX ÚfÚcontentsrW r# )rO rV r$ Ú
get_sourceu s
z!SphinxFileSystemLoader.get_sourceN) rE rF rG Ú__doc__r r r
r r_ r# r# r# r$ rQ o s rQ c @ sx e Zd ZdZddeee ddddZeeeddd Z eeed
d d Z
e d
ddZ e
eeeeef dddZdS )ÚBuiltinTemplateLoaderzK
Interfaces the rendering environment of jinja2 for use in Sphinx.
Nr )ÚbuilderÚthemeÚdirsr c sB |r |j }|dd |D }n |r6t|}t|}ng }g }t jj| _ jjr fdd jjD }||dd
< ||dd
< || _dd |D | _ jj d k }|r®dgng }t
| |d| _ t | j j
d< t| j j
d < t| j j
d
< t| j j
d < tt| j jd < t| j jd
< tt| j jd< t| j jd< |r>| j j jj d S )Nc S s g | ]}t j|d qS )z..)r rY )Ú.0Úpr# r# r$ ú
<listcomp> s z.BuiltinTemplateLoader.init.<locals>.<listcomp>c s g | ]}t j j|qS r# )r rY Zconfdir)re Útp)rb r# r$ rg ¡ s r c S s g | ] }t |qS r# )rQ )re Úxr# r# r$ rg ª s zjinja2.ext.i18n)ÚloaderÚ
extensionsZtoboolZtointZtodimZ slice_indexÚdebugrN r> r? )Zget_theme_dirsr0 r1 ÚconfigZtemplates_pathÚtemplatepathlenÚ pathchainÚloadersZappZ
translatorr rR r% Úfiltersr( r, r9 r r ÚglobalsrN r> r? Z install_gettext_translations) rA rb rc rd ro Z loaderchainZcfg_templates_pathZuse_i18nrk r# )rb r$ Úinit s<
zBuiltinTemplateLoader.init)rS r: r c C s | j j|j|S )N)rR Z get_templateÚrender)rA rS r: r# r# r$ rt » s z BuiltinTemplateLoader.render)Úsourcer: r c C s | j j|j|S )N)rR Z from_stringrt )rA ru r: r# r# r$ Ú
render_string¾ s z#BuiltinTemplateLoader.render_string)r c C s t t| jdS )Nz.html)Úmaxr ro )rA r# r# r$ Únewest_template_mtimeÁ s z+BuiltinTemplateLoader.newest_template_mtime)rR rS r c C sf | j }|jdr*|| jd
}|dd
}x.|D ]&}y |j||S tk
rT Y q0X q0W t|d S )Nú!r/ )rp Ú
startswithrn r_ r )rA rR rS rp rj r# r# r$ r_ Æ s
z BuiltinTemplateLoader.get_source)NN)rE rF rG r` r r r rs r rt rv Úfloatrx r r
r r_ r# r# r# r$ ra s +ra N)1r` Úosr Úpprintr Útypingr r r r r r r
r Zjinja2r r
r Zjinja2.environmentr Zjinja2.sandboxr Z jinja2.utilsr Zsphinx.applicationr Zsphinx.themingr Z sphinx.utilr Zsphinx.util.osutilr r Ú ImportErrorr Zsphinx.buildersr r r" r% r& r( r, r9 r> r? rN rQ ra r# r# r# r$ Ú<module> s6 (