File: //lib/python3/dist-packages/sphinx/util/__pycache__/template.cpython-310.pyc
o
$�a� � @ s d Z ddlZddlmZ ddlmZ ddlmZmZmZm Z m
Z
ddl m Z ddl
mZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
lmZmZ G dd� d�Z G dd� de �Z G dd� de �Z G dd� de �Z G dd� de �Z G dd� de�Z!dS )z�
sphinx.util.template
~~~~~~~~~~~~~~~~~~~~
Templates utility functions for Sphinx.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�partial)�path)�Callable�Dict�List�Tuple�Union)�TemplateNotFound)� Environment)�
BaseLoader)�SandboxedEnvironment)� package_dir)�SphinxFileSystemLoader)�get_translator)�rst� texescapec @ sL e Zd Zd
deddfdd�Zdededefdd �Zd
ededefd d �ZdS )� BaseRendererN�loader�returnc C s. t |dgd�| _t| jjd< | j�t� � d S )Nzjinja2.ext.i18n)r �
extensions�repr)r �envr �filters� install_gettext_translationsr )�selfr � r �6/usr/lib/python3/dist-packages/sphinx/util/template.py�__init__ s zBaseRenderer.__init__�
template_name�contextc C � | j �|��|�S �N)r � get_template�render)r r r r r r r# ! � zBaseRenderer.render�sourcec C r r! )r � from_stringr# )r r% r r r r �
render_string$ r$ zBaseRenderer.render_stringr! ) �__name__�
__module__� __qualname__r r �strr r# r' r r r r r s r c sL e Zd Zdeeee f ddf� fdd� Zedededefdd ��Z � Z
S )
� FileRenderer� search_pathr Nc s8 t |t�r |g}nttd |��}t|�}t� �|� d S r! )�
isinstancer+ �list�filterr �superr )r r- r �� __class__r r r ) s
zFileRenderer.__init__�filenamer c C s( t j�|�}t j�|�}| |��||�S r! )�osr �dirname�basenamer# )�clsr4 r r6 r7 r r r �render_from_file3 s z FileRenderer.render_from_file� r( r) r* r r+ r r � classmethodr r9 �
__classcell__r r r2 r r, ( s "
r, c sN e Zd Zd
deeee f ddf� fdd�
Zedededefdd ��Z � Z
S ) �SphinxRendererN�
template_pathr c s& |d u r t j�td�}t� �|� d S )N� templates)r5 r �joinr
r1 r )r r> r2 r r r ; s zSphinxRenderer.__init__r4 r c C s t �||�S r! )r, r9 )r8 r4 r r r r r9 @ s z SphinxRenderer.render_from_filer! r: r r r2 r r= : s $ r= c s, e Zd Zddededdf� fdd�
Z� ZS )�
LaTeXRendererNr> � latex_enginer c s� |d u r t j�tdd�}t� �|� ttj|d�}|| j j
d< || j j
d< tj | j j
d< d| j _ d| j _
d | j _d| j _d
| j _d | j _d S ) Nr? �latex)rB �e�escape�eabbrz<%=z%>z<%z<#z#>)r5 r r@ r
r1 r r r rE r r � escape_abbr�variable_start_string�variable_end_string�block_start_string�block_end_string�comment_start_string�comment_end_string)r r> rB rE r2 r r r F s zLaTeXRenderer.__init__�NN)r( r) r* r+ r r< r r r2 r rA E s $rA c s8 e Zd Zddeeee f deddf� fdd�
Z� ZS )� ReSTRendererNr> �languager c sH t � �|� | jj|d� tj| jjd< tj| jjd< tj| jjd< d S )N)rP rD rE �heading)r1 r r �extendr rE r rQ )r r> rP r2 r r r \ s
zReSTRenderer.__init__rN )r( r) r* r r+ r r r< r r r2 r rO [ s 0rO c @ sR e Zd ZdZdedee dee ddfdd�Zd ed
edeeee f fd d �Z
dS )
�SphinxTemplateLoaderz(A loader supporting template inheritance�confdir�templates_paths�system_templates_pathsr Nc C s` g | _ g | _|D ]}tt�||��}| j �|� q|D ]}t|�}| j �|� | j�|� qd S r! )�loaders�
sysloadersr r r@ �append)r rT rU rV �templates_pathr r r r r k s �z SphinxTemplateLoader.__init__� environment�templatec C sZ |� d�r| j}|dd � }n| j}|D ]}z |�||�W S ty( Y qw t|��)N�!� )�
startswithrX rW �
get_sourcer )r r[ r\ rW r r r r r` y s
�z SphinxTemplateLoader.get_source) r( r) r* �__doc__r+ r r r
r r r` r r r r rS h s �
�$rS )"ra r5 � functoolsr r �typingr r r r r �jinja2r �jinja2.environmentr
�jinja2.loadersr �jinja2.sandboxr �sphinxr
�sphinx.jinja2gluer �
sphinx.localer � sphinx.utilr r r r, r= rA rO rS r r r r �<module> s&