관리-도구
편집 파일: sphinxext.cpython-38.pyc
U &?�f- � @ 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-2024 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 | �� }nP| jd dkr8| �� }n8| jd dkrP| �� }n | jd dkrh| �� }ntd��t� � }t |� d�dd �}t | j ||� | jD ]}| j jjj�|� q�|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 �stateZdocument�settingsZrecord_dependencies�add�children)�self�out�nodeZvl�fn� r �L/opt/hc_python/lib/python3.8/site-packages/pip/_vendor/pygments/sphinxext.py�runG s zPygmentsDoc.runc sb ddl m} ddlm} g }g �dd� }t|�� dd� d�D ]r\}}||d �}|j|j }��||d |j �d � |�� d d �� d d�p�dd � |d �|d � d|� �d�� q<ddddg} �fdd�| D �� � fdd��� �fdd �} |�| � � |��d d d d �� |�| � � �D ]2} |��| 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 |rd| � 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 � z6PygmentsDoc.document_lexers_overview.<locals>.<lambda>��keyr �, �*�\*�_�\�None� �.)r& � extensions�aliases�classr& r8 r9 r: c 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< )�tabler> 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 )r< �cr r r r@ � s zQPygmentsDoc.document_lexers_overview.<locals>.write_seperator.<locals>.<listcomp>r )�sep)rK rL 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# �pip._vendor.pygments.lexersr$ �sorted�itemsr �alias_filenamesrE r' rG �replace) r r# r$ r r( � classname�dataZ lexer_clsr8 Z column_namesrP r= r )rK rB rL 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 s�td|� d�� | j } t| t�r�| �d �} t | d d �}|�rX|�|�|��jjd d | }|jd d�}|�s td|� d|� ���| d �rX| d d }| d7 } | d|� d�7 } |�� D ]}| d|� d�7 } �q@| j�rnd| j� �}nd}|�| g ��|d�| d ��p�dd�| d �� d d �� d d ��p�dd�| d ��p�d| |f� | |krH| j }t|t��r�|�d �}||| < qHt|�� d!d� d�D ]v\} }|| d k�r6td"| � ���|| �� d � � � d#�}|�t | |d$t |� f � |D ]} |�t!| � �qp�qd�|�S )%Nr r" )�pygmentsc S s | d S �Nr r r* r r r r, � r- z-PygmentsDoc.document_lexers.<locals>.<lambda>r. z Warning: z does not have a docstring.�utf8Z_example�testsZ examplefileszutf-8)�encodingzEmpty example file 'z ' for lexer r6 z .. admonition:: Example z .. code-block:: z z r z.. versionadded:: r r0 r5 � r1 r2 r3 r4 � c S s | d S r[ r r* r r r r, � r- zMissing docstring for r7 �-)"rR r# � pip._vendorrZ �inspect�pathlibrT rU � __import__r r �__file__�getattr�__doc__�print� isinstance�bytes�decode�Path� getabsfile�parent� read_textr � splitlinesZ version_added� setdefaultrE rG rW �strip�rstrip� MODULEDOCr; �LEXERDOC)r r# rZ rc rd r �modulesZmoduledocstringsrX rY �module�mod�cls� docstringZ example_file�p�content� lexer_name�lineZ version_lineZmoddocr �headingr r r r � sz ��� � "� zPygmentsDoc.document_lexersc C s� ddl m} g }t|�� dd� d�D ]�\}}|d }t|d d |g�}| j�|j� t||�}|j }t |t �rv|� d�}|j } |�t| d�|d �p�d d�|d ��d d �p�d |f � q$d �|�S )Nr )� FORMATTERSc S s | d S r[ r r* r r r r, � r- z1PygmentsDoc.document_formatters.<locals>.<lambda>r. r\ r0 r6 r5 r_ r1 r2 r )Z pip._vendor.pygments.formattersr� rT rU re r r rf rg rh rj rk rl �__name__rE �FMTERDOCrG rW ) r r� r rX rY rx ry rz r{ r� r r r r � s � z PygmentsDoc.document_formattersc C sr ddl m} g }|�� D ]N\}}| j�tj|j j� |j }t |t �rP|� d�}|� t|j||f � qd�|�S )Nr )�FILTERSr\ r )� pip._vendor.pygments.filtersr� rU r r �sysrw � __module__rf rh rj rk rl rE � FILTERDOCr� rG )r r� r r& rz r{ r r r r � s z PygmentsDoc.document_filtersN)r� r� � __qualname__rh Z has_contentZrequired_argumentsZoptional_argumentsZfinal_argument_whitespaceZ option_specr! r r r r r r r r r < s <Ar c C s | � dt� d S )NZ pygmentsdoc)Z add_directiver )Zappr r r �setup� s r� )rh r� Zdocutilsr Zdocutils.statemachiner Zdocutils.parsers.rstr Zsphinx.util.nodesr ru rv r� r� r r� r r r r �<module> s ;