U
    ;»{j-  ã                   @   sh   d Z ddlZddlmZ ddlmZ ddlmZ ddlm	Z	 dZ
dZd	Zd
ZG dd„ deƒZdd„ ZdS )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 Zd ZdZdZdZdZdZi Zdd„ Z	dd„ Z
d	d
„ 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 ƒ | _| jd dkr |  ¡ }nP| jd dkr8|  ¡ }n8| jd dkrP|  ¡ }n | jd dkrh|  ¡ }ntdƒ‚t 	¡ }t
| d¡dd	�}t| j||ƒ | jD ]}| jjjj |¡ qž|jS )
Nr   ÚlexersÚ
formattersÚfiltersZlexers_overviewz,invalid argument for "pygmentsdoc" directiveÚ
Ú )Úsource)ÚsetÚ	filenamesÚ	argumentsÚdocument_lexersÚdocument_formattersÚdocument_filtersÚdocument_lexers_overviewÚ	Exceptionr   Zcompoundr   Úsplitr   ÚstateÚdocumentÚsettingsZrecord_dependenciesÚaddÚchildren)ÚselfÚoutÚnodeZvlÚfn© r    ú?/tmp/pip-install-zsn1f9xv/pip/pip/_vendor/pygments/sphinxext.pyÚrunG   s     




zPygmentsDoc.runc              
      sb  ddl m} ddlm} g }g ‰dd„ }t| ¡ dd„ d�D ]r\}}||d	 ƒ}|j|j }ˆ ||d	 |j	ƒd
 
|¡ dd¡ dd¡pŠdd
 
|d ¡|d › d|› �dœ¡ q<ddddg}	‡fdd„|	D ƒ‰ ‡ fdd„‰‡ ‡fdd„}
| |
ƒ ¡ | ˆ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   |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   ó    z6PygmentsDoc.document_lexers_overview.<locals>.<lambda>©Úkeyr   ú, Ú*ú\*Ú_ú\ÚNoneé   Ú.)r'   Ú
extensionsÚaliasesÚclassr'   r9   r:   r;   c                    s"   g | ]‰ t ‡ fd d„ˆD ƒƒ‘qS )c                    s    g | ]}|ˆ  rt |ˆ  ƒ‘qS r    )Úlen)Ú.0Úrow©Úcolumnr    r!   Ú
<listcomp>v   s      zCPygmentsDoc.document_lexers_overview.<locals>.<listcomp>.<listcomp>)Úmax)r=   )Útabler?   r!   rA   v   s   ÿz8PygmentsDoc.document_lexers_overview.<locals>.<listcomp>c                     sF   g }t ˆ | ƒD ],\}}|r,| | |¡¡ q| d| ¡ qd |¡S )zFormat a table rowú )ÚzipÚappendÚljustÚjoin)Úcolumnsr   ÚlengthÚcol)Úcolumn_lengthsr    r!   Ú	write_rowy   s    z7PygmentsDoc.document_lexers_overview.<locals>.write_rowc                     s   dd„ ˆ D ƒ} ˆ| Ž S )zWrite a table separator rowc                 S   s   g | ]}d | ‘qS )ú=r    )r=   Úcr    r    r!   rA   †   s     zQPygmentsDoc.document_lexers_overview.<locals>.write_seperator.<locals>.<listcomp>r    )Úsep)rL   rM   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$   Zpip._vendor.pygments.lexersr%   ÚsortedÚitemsr   Zalias_filenamesrF   r(   rH   Úreplace)r   r$   r%   r   r)   Ú	classnameÚdataZ	lexer_clsr9   Zcolumn_namesrQ   r>   r    )rL   rC   rM   r!   r   Z   s@    ü

ÿü
z$PygmentsDoc.document_lexers_overviewc              
   C   s”  ddl m} ddlm} dd l}dd l}g }i }i }t| ¡ dd„ d�D �]²\}}	|	d }
t|
d d |gƒ}| j	 
|j¡ t||ƒ}|js˜td|› d�ƒ |j}t|tƒr²| d	¡}t|d
d ƒ}|�rX| | |¡¡jjd d | }|jdd�}|�s
td|› d|› �ƒ‚|	d �rX|	d d }|d7 }|d|› d�7 }| ¡ D ]}|d|› d�7 }�q@|j�rnd|j› �}nd}| |
g ¡ |d |	d ¡�p’dd |	d ¡ dd¡ dd¡�p´dd |	d  ¡�pÆd||f¡ |
|krH|j}t|tƒ�rô| d	¡}|||
< qHt| ¡ d!d„ d�D ]v\}
}||
 d k�r6td"|
› �ƒ‚||
  ¡ d   ¡  d#¡}| t|
|d$t |ƒ f ¡ |D ]}	| t!|	 ¡ �qp�qd |¡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examplefileszutf-8)ÚencodingzEmpty example file 'z' for lexer r7   z

    .. admonition:: Example
z
      .. code-block:: z

z
          r   z.. versionadded:: r   r1   r6   é   r2   r3   r4   r5   é   c                 S   s   | d S rZ   r    r+   r    r    r!   r-   Í   r.   zMissing docstring for r8   ú-)"rS   r$   Úpip._vendorrY   ÚinspectÚpathlibrT   rU   Ú
__import__r   r   Ú__file__ÚgetattrÚ__doc__ÚprintÚ
isinstanceÚbytesÚdecodeÚPathÚ
getabsfileÚparentÚ	read_textr   Ú
splitlinesZversion_addedÚ
setdefaultrF   rH   rV   ÚstripÚrstripÚ	MODULEDOCr<   ÚLEXERDOC)r   r$   rY   rb   rc   r   ÚmodulesZmoduledocstringsrW   rX   ÚmoduleÚmodÚclsÚ	docstringZexample_fileÚpÚcontentZ
lexer_nameÚlineZversion_lineZmoddocr   Úheadingr    r    r!   r   –   sz    


ÿÿÿÿ
"ú

zPygmentsDoc.document_lexersc           
   
   C   sÂ   ddl m} g }t| ¡ dd„ 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 rZ   r    r+   r    r    r!   r-   Û   r.   z1PygmentsDoc.document_formatters.<locals>.<lambda>r/   r[   r1   r7   r6   r^   r2   r3   r   )Zpip._vendor.pygments.formattersr   rT   rU   rd   r   r   re   rf   rg   ri   rj   rk   Ú__name__rF   ÚFMTERDOCrH   rV   )
r   r   r   rW   rX   rw   rx   ry   rz   r~   r    r    r!   r   ×   s     


þ
zPygmentsDoc.document_formattersc                 C   sr   ddl m} g }| ¡ D ]N\}}| j tj|j j¡ |j	}t
|tƒrP| d¡}| t|j||f ¡ qd |¡S )Nr   )ÚFILTERSr[   r   )Zpip._vendor.pygments.filtersr‚   rU   r   r   Úsysrv   Ú
__module__re   rg   ri   rj   rk   rF   Ú	FILTERDOCr€   rH   )r   r‚   r   r'   ry   rz   r    r    r!   r   é   s    

zPygmentsDoc.document_filtersN)r€   r„   Ú__qualname__rg   Zhas_contentZrequired_argumentsZoptional_argumentsZfinal_argument_whitespaceZoption_specr"   r   r   r   r   r    r    r    r!   r   <   s   <Ar   c                 C   s   |   dt¡ d S )NZpygmentsdoc)Zadd_directiver   )Zappr    r    r!   Úsetupö   s    r‡   )rg   rƒ   Zdocutilsr   Zdocutils.statemachiner   Zdocutils.parsers.rstr   Zsphinx.util.nodesr   rt   ru   r�   r…   r   r‡   r    r    r    r!   Ú<module>   s   

 ;