File: //usr/local/lib/python3.7/site-packages/pip/_vendor/pygments/__pycache__/sphinxext.cpython-37.pyc
B
L��g� � @ 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-2023 by the Pygments team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�nodes)�ViewList)� Directive)�nested_parse_with_titlesz
.. module:: %s
%s
%s
zX
.. class:: %s
:Short names: %s
:Filenames: %s
:MIME types: %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 | �� }nP| jd dkr8| �� }n8| jd dkrP| �� }n | jd dkrh| �� }ntd��t� � }t
|� d�dd �}t | j
||� x | jD ]}| j
jjj�|� q�W |jS )
Nr �lexers�
formatters�filtersZlexers_overviewz,invalid argument for "pygmentsdoc" directive�
� )�source)�set� filenames� arguments�document_lexers�document_formatters�document_filters�document_lexers_overview� Exceptionr Zcompoundr �splitr �state�document�settingsZrecord_dependencies�add�children)�self�out�nodeZvl�fn� r �B/tmp/pip-unpacked-wheel-hv55ucu3/pip/_vendor/pygments/sphinxext.py�runE s
zPygmentsDoc.runc
sj ddl m} ddlm} g }g �dd� }x�t|�� dd� d�D ]r\}}||d �}|j|j }��||d |j �d
�
|�� d d �� d
d�p�dd
�
|d �|d � d|� �d�� q>W ddddg} �fdd�| D �� � fdd��� �fdd �}
|�|
� � |��d d d d �� |�|
� � x:�D ]2} |��| d | d | d d!| d � d"��� �q W |�|
� � 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 )�LEXERS)�find_lexer_classc S s |rd| � d|� d�S | S )N�`z <z>`_r )�name�urlr r r! � format_linkc s z9PygmentsDoc.document_lexers_overview.<locals>.format_linkc S s | d d � � S )Nr )�lower)�xr r r! �<lambda>h � z6PygmentsDoc.document_lexers_overview.<locals>.<lambda>)�keyr z, �*z\*�_�\�None� �.)r& �
extensions�aliases�classr& r4 r5 r6 c s" g | ]� t � fd d��D ���qS )c s g | ]}|� rt |� ��qS r )�len)�.0�row)�columnr r! �
<listcomp>t s zCPygmentsDoc.document_lexers_overview.<locals>.<listcomp>.<listcomp>)�max)r8 )�table)r: r! r; t s z8PygmentsDoc.document_lexers_overview.<locals>.<listcomp>c sJ g }x:t � | �D ],\}}|r.|�|�|�� q|�d| � qW d�|�S )zFormat a table row� )�zip�append�ljust�join)�columnsr �l�c)�column_lengthsr r! � write_roww s z7PygmentsDoc.document_lexers_overview.<locals>.write_rowc s dd� � D �} �| � S )zWrite a table separator rowc S s g | ] }d | �qS )�=r )r8 rE r 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 classz :class:`~r% r ) �$pip._vendor.pygments.lexers._mappingr# Zpip._vendor.pygments.lexersr$ �sorted�itemsr Zalias_filenamesr@ r' rB �replace) r r# r$ r r( � classname�dataZ lexer_clsr4 Z column_namesrJ r9 r )rF r= rG r! r X s:
z$PygmentsDoc.document_lexers_overviewc
C s� ddl m} g }i }i }� x�t|�� dd� d�D ]�\}}|d }t|d d |g�}| j�|j� t||�} | j szt
d| � | j }
t |
t �r�|
�
d�}
|�|g ��|d�|d �p�d
d�|d ��d d
��dd�p�d
d�|d �p�d
|
f� ||kr0|j } t | t ��r| �
d�} | ||< q0W x�t|�� dd� d�D ]z\}} || d k�rTtd|f ��|| �� d �� �d�}
|�t||
dt|
� f � x | D ]}|�t| � �q�W �q0W d�|�S )Nr )r# c S s | d S )Nr r )r* r r r! r+ � r, z-PygmentsDoc.document_lexers.<locals>.<lambda>)r- z&Warning: %s does not have a docstring.�utf8z, r2 r1 � r. z\*r/ r0 � c S s | d S )Nr r )r* r r r! r+ � r, zMissing docstring for %sr3 �-r )rL r# rM rN �
__import__r r �__file__�getattr�__doc__�print�
isinstance�bytes�decode�
setdefaultr@ rB rO r �
splitlines�strip�rstrip� MODULEDOCr7 �LEXERDOC)r r# r �modulesZmoduledocstringsrP rQ �module�mod�cls� docstringZmoddocr �headingr r r! r � sB
zPygmentsDoc.document_lexersc
C s� ddl m} g }x�t|�� dd� d�D ]�\}}|d }t|d d |g�}| j�|j� t||�}|j }t
|t �rx|� d�}|j
} |�t| d�|d �p�d d�|d
��d d �p�d |f � q&W d
�|�S )Nr )�
FORMATTERSc S s | d S )Nr r )r* r r r! r+ � r, z1PygmentsDoc.document_formatters.<locals>.<lambda>)r- rR z, r2 r1 rS r. z\*r )Z pip._vendor.pygments.formattersrj rM rN rV r r rW rX rY r[ r\ r] �__name__r@ �FMTERDOCrB rO )
r rj r rP rQ re rf rg rh ri r r r! r � s
z PygmentsDoc.document_formattersc C sv ddl m} g }xZ|�� D ]N\}}| j�tj|j j� |j }t
|t �rR|� d�}|�
t|j||f � qW d�|�S )Nr )�FILTERSrR r )Z pip._vendor.pygments.filtersrm rN r r �sysrd �
__module__rW rY r[ r\ r] r@ � FILTERDOCrk rB )r rm r r& rg rh r r r! r � s
z PygmentsDoc.document_filtersN)rk ro � __qualname__rY Z has_contentZrequired_argumentsZoptional_argumentsZfinal_argument_whitespaceZ option_specr" r r r r r r r r! r : s <%r c C s | � dt� d S )NZ pygmentsdoc)Z
add_directiver )Zappr r r! �setup� s rr )rY rn Zdocutilsr Zdocutils.statemachiner Zdocutils.parsers.rstr Zsphinx.util.nodesr rb rc rl rp r rr r r r r! �<module>
s