|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/sphinx/__pycache__/ |
Upload File : |
o
�$�a � @ 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 zdd
lm Z W n e!ym ddlm"Z Y nw ervddl#m$Z$ de%de&fdd�Z'de%de(fdd�Z)de
e(e%f de%fdd�Z*de de(de
e fdd�Z+d ed e%de%fd d �Z,G d d!� d!�Z-e d e d"e%d#ed$ede%f
d%d&��Z.G d'd(� d(e�Z/G d)d*� d*ee�Z0d+S ),z�
sphinx.jinja2glue
~~~~~~~~~~~~~~~~~
Glue code for the jinja2 templating engine.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� )�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 | t�r | �� dv S t| �S )N)�true�1�yes�on)�
isinstance�str�lower�bool�r � r$ �3/usr/lib/python3/dist-packages/sphinx/jinja2glue.py�_tobool" s
r& c C s zt | �W S ty Y dS w �Nr )�int�
ValueErrorr# r$ r$ r% �_toint( s
�r* c C s4 | du rdS t | ��� rt| �dkrdS 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�slicesc
c s� � t | �}d}| D ]}|dt|d d � 7 }q || }d}t|�D ]7}d}|} ||d kr3t|�}n | |d � D ]}|dt|d d � 7 }|d7 }||krQ nq9|| |� V q"d S )Nr � )�list�len�range)
r/ r0 �seq�length�value�items_per_slice�offset� slice_number�count�startr$ r$ r% � _slice_indexA s( �
��r= �context�keyc C s> d| vr i | j d< |r || j d vr d| j d |< d| S dS )z+Helper to output each access key only once.� _accesskeysr1 zaccesskey="%s"� )�vars)r> r? r$ r$ r% � accesskeyV s
rC c @ s6 e Zd Zd dd�Zdefdd�Zdefdd�ZeZdS )
�idgenr Nc C s
d| _ d S r' ��id��selfr$ r$ r% �__init__a s
zidgen.__init__c C s | j S �NrE rG r$ r$ r% �currentd s z
idgen.currentc C s | j d7 _ | j S )Nr1 rE rG r$ r$ r% �__next__g s zidgen.__next__)r N)�__name__�
__module__� __qualname__rI r( rK rL �nextr$ r$ r$ r% rD ` s
rD �message�args�kwargsc O sP d| v r| � d�| � dd� }d||f }t�d�}|j|g|�R i |�� dS )N�pagename� file_suffixrA zin rendering %s: %sz
sphinx.themes)�getr � getLogger�warning)r> rQ rR rS �filename�loggerr$ r$ r% rX m s
rX c @ s0 e Zd ZdZdededeeeef fdd�ZdS )�SphinxFileSystemLoaderzd
FileSystemLoader subclass that is not so strict about '..' entries in
template names.
� environment�templater c s� | j D ]@}t�||�� t� �}|d u rq|� |�� �| j�}W d � n1 s)w Y t�� ��dtf� �fdd� }|� |f S t |��)Nr c s& zt �� ��kW S ty Y dS w )NF)r �getmtime�OSErrorr$ �rY �mtimer$ r% �uptodate� s
�z3SphinxFileSystemLoader.get_source.<locals>.uptodate)
�
searchpathr �joinr �read�decode�encodingr^ r" r )rH r\ r] rc �f�contentsrb r$ r` r% �
get_source} s
�
z!SphinxFileSystemLoader.get_sourceN) rM rN rO �__doc__r r r
r rj r$ r$ r$ r% r[ w s $r[ c @ s� e Zd ZdZddddedee ddfdd �Zd
ed edefd d
�Z ded edefdd�Z
de fdd�Z de
d
edeeeef fdd�ZdS )�BuiltinTemplateLoaderzK
Interfaces the rendering environment of jinja2 for use in Sphinx.
N�builderr �theme�dirsr c sD |r|� � }|dd� |D � }n|rt|�}t|�}ng }g }t� jj�| _� jjrA� fdd�� jjD �}||dd�< ||dd�< || _dd� |D �| _� jj d u}|rWdgng }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 �� jj � d S d S )Nc S s g | ]}t �|d ��qS )z..)r rd )�.0�pr$ r$ r% �
<listcomp>� s z.BuiltinTemplateLoader.init.<locals>.<listcomp>c s g | ] }t �� j|��qS r$ )r rd �confdir)rp �tp�rm r$ r% rr � s �r c S s g | ]}t |��qS r$ )r[ )rp �xr$ r$ r% rr � s zjinja2.ext.i18n)�loader�
extensions�tobool�toint�todim� slice_index�debugrX rC rD )�get_theme_dirsr2 r3 �config�templates_path�templatepathlen� pathchain�loaders�app�
translatorr r\ r& �filtersr* r. r= r r �globalsrX rC rD � install_gettext_translations) rH rm rn ro r� � loaderchain�cfg_templates_path�use_i18nrx r$ ru r% �init� sB
� � �zBuiltinTemplateLoader.initr] r> c C � | j �|��|�S rJ )r\ � get_template�render)rH r] r> r$ r$ r% r� � � z BuiltinTemplateLoader.render�sourcec C r� rJ )r\ � from_stringr� )rH r� r> r$ r$ r% �
render_string� r� z#BuiltinTemplateLoader.render_stringc C s t t| jd��S )Nz.html)�maxr r� rG r$ r$ r% �newest_template_mtime� s z+BuiltinTemplateLoader.newest_template_mtimer\ c C s` | j }|�d�r|| jd � }|dd � }|D ]}z |�||�W S ty+ Y qw t|��)N�!r1 )r� �
startswithr� rj r )rH r\ r] r� rw r$ r$ r% rj � s
�z BuiltinTemplateLoader.get_source)NN)rM rN rO rk r r r r� r r� r� �floatr� r r
r rj r$ r$ r$ r% rl � s +$rl N)1rk �osr �pprintr �typingr r r r r r r
r �jinja2r r
r �jinja2.environmentr �jinja2.sandboxr � jinja2.utilsr �sphinx.applicationr �sphinx.themingr � sphinx.utilr �sphinx.util.osutilr r � ImportErrorr �sphinx.buildersr r r" r& r( r* r. r= rC rD rX r[ rl r$ r$ r$ r% �<module> s:
( �