File: //opt/saltstack/salt/lib/python3.10/site-packages/pygments/__pycache__/sphinxext.cpython-310.pyc
o
;j� � @ sh d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z dZ
dZ d Z d
Z
G d d � d e�Zd
d� ZdS )a
pygments.sphinxext
~~~~~~~~~~~~~~~~~~
Sphinx extension to generate automatic documentation of lexers,
formatters and filters.
:copyright: Copyright 2006-present by the Pygments team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�nodes)�ViewList)� Directive)�nested_parse_with_titlesz
.. module:: %s
%s
%s
z`
.. class:: %s
:Short names: %s
:Filenames: %s
:MIME types: %s
%s
%s
zA
.. class:: %s
:Short names: %s
:Filenames: %s
%s
z'
.. class:: %s
:Name: %s
%s
c @ sL e Zd ZdZdZdZdZdZi Zdd� Z dd� Z
d d
� Z d d � Z d
d� Z
dS )� PygmentsDoczn
A directive to collect all lexers/formatters/filters and generate
autoclass directives for them.
F� r c C s� t � | _| jd dkr| �� }n(| jd dkr | �� }n | jd dkr(| �� }n| jd dkr4| �� }ntd��t� � }t
|� d�dd �}t | j
||� | jD ] }| j
jjj�|� qO|jS )
Nr �lexersZ
formatters�filtersZlexers_overviewz,invalid argument for "pygmentsdoc" directive�
� )�source)�set� filenamesZ arguments�document_lexers�document_formatters�document_filters�document_lexers_overview� Exceptionr Zcompoundr �splitr �stateZdocumentZsettingsZrecord_dependencies�add�children)�self�out�nodeZvl�fn� r �F/opt/saltstack/salt/lib/python3.10/site-packages/pygments/sphinxext.py�runG s
zPygmentsDoc.runc
s\ ddl m} ddl}g }g �dd� }t|�� dd� d�D ];\}}|j�|d �}|j|j }�� ||d |j
�d
� |�� d d �� d
d�pEdd
� |d �|d � d|� �d�� q g d�} �fdd�| D �� � fdd��� �fdd�}
|� |
� � |� �dddd �� |� |
� � �D ]} |� �| d | d | d d | d! � d"��� q�|� |
� � d#� |�S )$z�Generate a tabular overview of all lexers.
The columns are the lexer name, the extensions handled by this lexer
(or "None"), the aliases and a link to the lexer class.r ��LEXERSNc S s |r d| � d|� d�S | S )N�`z <z>`_r )�name�urlr r r � format_linke s z9PygmentsDoc.document_lexers_overview.<locals>.format_linkc S s | d d � � S )Nr )�lower��xr r r �<lambda>j s z6PygmentsDoc.document_lexers_overview.<locals>.<lambda>��keyr �, �*�\*�_�\�None� �.)r" �
extensions�aliases�classc s" g | ]
� t � fd d��D ���qS )c s g | ] }|� rt |� ��qS r )�len)�.0�row��columnr r �
<listcomp>v s zCPygmentsDoc.document_lexers_overview.<locals>.<listcomp>.<listcomp>)�max)r7 )�tabler9 r r; v s �z8PygmentsDoc.document_lexers_overview.<locals>.<listcomp>c sF g }t � | �D ]\}}|r|�|�|�� q|�d| � qd�|�S )zFormat a table row� )�zip�append�ljust�join)�columnsr �length�col)�column_lengthsr r � write_rowy s
z7PygmentsDoc.document_lexers_overview.<locals>.write_rowc s dd� � D �} �| � S )zWrite a table separator rowc S s g | ]}d | �qS )�=r )r7 �cr r r r; � s zQPygmentsDoc.document_lexers_overview.<locals>.write_seperator.<locals>.<listcomp>r )�sep)rF rG r r �write_seperator� s z=PygmentsDoc.document_lexers_overview.<locals>.write_seperator�Namez Extension(s)z
Short name(s)z Lexer classr" r3 r4 z :class:`~r5 r! r
)
�pygments.lexers._mappingr Zpygments.lexers�sorted�itemsr Zfind_lexer_classr Zalias_filenamesr@ r# rB �replace) r r �pygmentsr r$ � classname�dataZ lexer_clsr3 Z column_namesrK r8 r )rF r= rG r r Z s@
�
� �
z$PygmentsDoc.document_lexers_overviewc
C sz ddl m} dd l}dd l}dd l}g }i }i }t|�� dd� d�D ]�\}} | d }
t|
d d |g�} | j� | j
� t | |�} | j sIt
d|� d�� | j }
t|
t�rV|
�d�}
t | d d �}|r�|�|�|��jjd
d | }|jd d
�}|s�td|� d|� ���| d r�| d d }|
d7 }
|
d|� d�7 }
|�� D ]
}|
d|� d�7 }
q�| jr�d| j� �}nd}|�|
g ��|d�| d �p�dd�| d ��dd ��d d �p�dd�| d �p�d|
|f� |
|vr�| j }t|t�r�|�d�}|||
< q"t|�� d d� d�D ]:\}
}||
d u �rtd!|
� ���||
�� d � � � d"�}|�t |
|d#t |� f � |D ]
} |�t | � �q,q�d�|�S )$Nr r c S � | d S �Nr r r& r r r r( � � z-PygmentsDoc.document_lexers.<locals>.<lambda>r) z Warning: z does not have a docstring.�utf8Z_exampleZtestsZ examplefileszutf-8)�encodingzEmpty example file 'z ' for lexer r1 z
.. admonition:: Example
z
.. code-block:: z
z
r
z.. versionadded:: r r+ r0 � r, r- r. r/ � c S rT rU r r& r r r r( � rV zMissing docstring for r2 �-)!rM r rQ �inspect�pathlibrN rO �
__import__r r �__file__�getattr�__doc__�print�
isinstance�bytes�decode�PathZ
getabsfile�parent� read_textr �
splitlinesZ
version_added�
setdefaultr@ rB rP �strip�rstrip� MODULEDOCr6 �LEXERDOC)r r rQ r\ r] r �modulesZmoduledocstringsrR rS �module�mod�cls� docstringZ example_file�p�contentZ
lexer_name�lineZ version_lineZmoddocr �headingr r r r � s�
��� �� �
� �
zPygmentsDoc.document_lexersc
C s� ddl m} g }t|�� dd� d�D ]I\}}|d }t|d d |g�}| j�|j� t||�}|j }t
|t �r;|� d�}|j
} |�t| d�|d �pJd d�|d
��d d �pVd |f � qd
�|�S )Nr )�
FORMATTERSc S rT rU r r& r r r r( � rV z1PygmentsDoc.document_formatters.<locals>.<lambda>r) rW r+ r1 r0 rY r, r- r )Zpygments.formattersrx rN rO r^ r r r_ r` ra rc rd re �__name__r@ �FMTERDOCrB rP )
r rx r rR rS rp rq rr rs rw r r r r � s
�
z PygmentsDoc.document_formattersc C sr ddl m} g }|�� D ]'\}}| j�tj|j j� |j }t
|t �r(|� d�}|�
t|j||f � q d�|�S )Nr )�FILTERSrW r )Zpygments.filtersr{ rO r r �sysro �
__module__r_ ra rc rd re r@ � FILTERDOCry rB )r r{ r r" rr rs r r r r � s
z PygmentsDoc.document_filtersN)ry r} � __qualname__ra Z has_contentZrequired_argumentsZoptional_argumentsZfinal_argument_whitespaceZ option_specr r r r r r r r r r < s <A r c C s | � dt� d S )NZ pygmentsdoc)Z
add_directiver )Zappr r r �setup� s r� )ra r| Zdocutilsr Zdocutils.statemachiner Zdocutils.parsers.rstr Zsphinx.util.nodesr rm rn rz r~ r r� r r r r �<module> s
;