File: //usr/local/lib/python3.10/dist-packages/pip/_vendor/pygments/__pycache__/sphinxext.cpython-310.pyc
o
��h- � @ 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-2025 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 �lexers�
formatters�filters�lexers_overviewz,invalid argument for "pygmentsdoc" directive�
� )�source)�set� filenames� arguments�document_lexers�document_formatters�document_filters�document_lexers_overview� Exceptionr �compoundr �splitr �state�document�settings�record_dependencies�add�children)�self�out�node�vl�fn� r$ �I/usr/local/lib/python3.10/dist-packages/pip/_vendor/pygments/sphinxext.py�runG s
zPygmentsDoc.runc
s\ ddl m} ddlm} g }g �dd� }t|�� dd� d�D ]9\}}||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 ��LEXERS)�find_lexer_classc 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)r@ )�tablerB r% rD 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$ )r@ �cr$ r$ r% rD � s zQPygmentsDoc.document_lexers_overview.<locals>.write_seperator.<locals>.<listcomp>r$ )�sep)rO rP r$ r% �write_seperator� s z=PygmentsDoc.document_lexers_overview.<locals>.write_seperator�Namez Extension(s)z
Short name(s)z Lexer classr+ r< r= z :class:`~r> r* r ) �$pip._vendor.pygments.lexers._mappingr( �pip._vendor.pygments.lexersr) �sorted�itemsr �alias_filenamesrI r, rK �replace) r r( r) r r- � classname�data� lexer_clsr< � column_namesrT rA r$ )rO rF rP r% r Z s@
�
� �
z$PygmentsDoc.document_lexers_overviewc
C s~ ddl m} ddlm} dd l}dd l}g }i }i }t|�� dd� d�D ]�\}} | d }
t|
d d |g�} | j �
| j � t | |�} | j
sKtd|� d�� | j
}
t|
t�rX|
�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 �� d d �� 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' )�pygmentsc S � | d S �Nr r$ r/ r$ r$ r% r1 � � z-PygmentsDoc.document_lexers.<locals>.<lambda>r2 z Warning: z does not have a docstring.�utf8�_example�tests� examplefileszutf-8)�encodingzEmpty example file 'z ' for lexer r: z
.. admonition:: Example
z
.. code-block:: z
z
r z.. versionadded:: r
r4 r9 � r5 r6 r7 r8 � c S ra rb r$ r/ r$ r$ r% r1 � rc zMissing docstring for r; �-)"rV r( � pip._vendorr` �inspect�pathlibrX rY �
__import__r r �__file__�getattr�__doc__�print�
isinstance�bytes�decode�Path�
getabsfile�parent� read_textr �
splitlines�
version_added�
setdefaultrI rK r[ �strip�rstrip� MODULEDOCr? �LEXERDOC)r r( r` rm rn r �modules�moduledocstringsr\ r] �module�mod�cls� docstring� example_file�p�content�
lexer_name�line� version_line�moddocr �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 ra rb r$ r/ r$ r$ r% r1 � rc z1PygmentsDoc.document_formatters.<locals>.<lambda>r2 rd r4 r: r9 ri r5 r6 r
)� pip._vendor.pygments.formattersr� rX rY ro r r rp rq rr rt ru rv �__name__rI �FMTERDOCrK r[ )
r r� r r\ r] r� r� r� r� r� 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 )�FILTERSrd r
)� pip._vendor.pygments.filtersr� rY r r �sysr� �
__module__rp rr rt ru rv rI � FILTERDOCr� rK )r r� r r+ r� r� r$ r$ r% r � s
z PygmentsDoc.document_filtersN)r� r� � __qualname__rr � has_content�required_arguments�optional_arguments�final_argument_whitespace� option_specr& r r r r r$ r$ r$ r% r < s <A r c C s | � dt� d S )N� pygmentsdoc)�
add_directiver )�appr$ r$ r% �setup� s r� )rr r� �docutilsr �docutils.statemachiner �docutils.parsers.rstr �sphinx.util.nodesr r� r� r� r� r r� r$ r$ r$ r% �<module> s
;