3
�;�e1 � @ st d Z ddlmZ ddlZddlmZ ddlmZ ddlm Z ddl
m Z dZ d Z
d
Zd ZG d d
� d
e �Zdd� ZdS )a
pygments.sphinxext
~~~~~~~~~~~~~~~~~~
Sphinx extension to generate automatic documentation of lexers,
formatters and filters.
:copyright: Copyright 2006-2017 by the Pygments team, see AUTHORS.
:license: BSD, see LICENSE for details.
� )�print_functionN)�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 @ sD e Zd ZdZdZdZdZdZi Zdd� Z dd� Z
d d
� Z d d � Z d
S )� PygmentsDoczn
A directive to collect all lexers/formatters/filters and generate
autoclass directives for them.
F� r c C s� t � | _| jd dkr | j� }n8| jd dkr8| j� }n | jd dkrP| j� }ntd��tj� }t |j
d�dd�}t | j ||� x | jD ]}| j j
jjj|� q�W |jS ) Nr �lexersZ
formatters�filtersz,invalid argument for "pygmentsdoc" directive�
� )�source)�set� filenamesZ arguments�document_lexers�document_formatters�document_filters� Exceptionr Zcompoundr �splitr �stateZdocumentZsettingsZrecord_dependencies�addZchildren)�self�outZnodeZvl�fn� r � /usr/lib/python3.6/sphinxext.py�runH s
zPygmentsDoc.runc C s� ddl m} g }i }i }� x�t|j� dd� d�D ]�\}}|d }t|d d |g�}| jj|j� t||�} | j szt
d| � | j }
t |
t �r�|
j
d�}
|j|g �j|dj|d �p�d
dj|d �jd d
�jdd�p�d
dj|d �p�d
|
f� ||kr0|j } t | t ��r| j
d�} | ||< q0W x�t|j� dd� d�D ]z\}} || d k�rTtd|f ��|| j� d j� jd�}
|jt||
dt|
� f � x | D ]}|jt| � �q�W �q0W dj|�S )Nr )�LEXERSc S s | d S )Nr r )�xr r r �<lambda>^ s z-PygmentsDoc.document_lexers.<locals>.<lambda>)�keyz&Warning: %s does not have a docstring.�utf8z, � �None� �*z\*�_�\� c S s | d S )Nr r )r r r r r t s zMissing docstring for %s�.�-r )Zpygments.lexers._mappingr �sorted�items�
__import__r r �__file__�getattr�__doc__�print�
isinstance�bytes�decode�
setdefault�append�join�replacer �
splitlines�strip�rstrip� MODULEDOC�len�LEXERDOC)r r r �modulesZmoduledocstrings� classname�data�module�mod�cls� docstringZmoddocr �headingr r r r Y sB
zPygmentsDoc.document_lexersc
C s� ddl m} g }x�t|j� dd� d�D ]�\}}|d }t|d d |g�}| jj|j� t||�}|j }t
|t �rx|j d�}|j
} |jt| dj|d �p�d dj|d
�jd d �p�d |f � q&W d
j|�S )Nr )�
FORMATTERSc S s | d S )Nr r )r r r r r � s z1PygmentsDoc.document_formatters.<locals>.<lambda>)r r! z, r" r# r$ r% z\*r )Zpygments.formattersrG r+ r, r- r r r. r/ r0 r2 r3 r4 �__name__r6 �FMTERDOCr7 r8 )
r rG r r@ rA rB rC rD rE rF r r r r ~ s
z PygmentsDoc.document_formattersc C sv ddl m} g }xZ|j� D ]N\}}| jjtj|j j� |j }t
|t �rR|j d�}|j
t|j||f � qW dj|�S )Nr )�FILTERSr! r )Zpygments.filtersrJ r, r r �sysr? �
__module__r. r0 r2 r3 r4 r6 � FILTERDOCrH r7 )r rJ r �namerD rE r r r r � s
z PygmentsDoc.document_filtersN)
rH rL � __qualname__r0 Z has_contentZrequired_argumentsZoptional_argumentsZfinal_argument_whitespaceZ option_specr r r r r r r r r = s %r c C s | j dt� d S )NZ pygmentsdoc)Z
add_directiver )Zappr r r �setup� s rP )r0 Z
__future__r rK Zdocutilsr Zdocutils.statemachiner Zdocutils.parsers.rstr Zsphinx.util.nodesr r< r> rI rM r rP r r r r �<module> s
`