R`i l d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z dZ
dZ d Z d
Z
G d d e Zd
Zy)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 B e Zd ZdZdZdZdZdZi Zd Z d Z
d Z d Z d Z
y
) PygmentsDoczn
A directive to collect all lexers/formatters/filters and generate
autoclass directives for them.
F r c t | _ | j d dk( r| j }nt| j d dk( r| j }nQ| j d dk( r| j }n.| j d dk( r| j
}n t d t j }t |j d d }t | j || | j D ]; }| j j j j j# | = |j$ S )
Nr lexers
formattersfilterslexers_overviewz,invalid argument for "pygmentsdoc" directive
)source)set filenames argumentsdocument_lexersdocument_formattersdocument_filtersdocument_lexers_overview Exceptionr compoundr splitr statedocumentsettingsrecord_dependenciesaddchildren)selfoutnodevlfns /builddir/build/BUILDROOT/alt-python312-pip-23.3.1-3.el8.x86_64/opt/alt/python312/lib/python3.12/site-packages/pip/_vendor/pygments/sphinxext.pyrunzPygmentsDoc.runE s >>! (&&(C
^^A
,
.**,C
^^A
)
+'')C
^^A
"3
3//1C JK K~~
ciiob
1 R6..B JJ ( ( < < @ @ D !}} c
ddl m} ddlm} g }g }d }t |j d D ] \ }} ||d }|j |j z } |j ||d |j dj | j d d
j d d xs d
dj |d |d d| d g d}
|
D cg c]- } t |D cg c] } | | s t | | c} / c} } fdfd}
|j |
|j dddd |j |
|D ], } |j | d | d | d d| d d . |j |
d j | S c c} w c c} } w ) zGenerate 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 |r d| d| dS | S )N`z `_ )nameurls r' format_linkz9PygmentsDoc.document_lexers_overview..format_linkc s 4&3%s++Kr) c . | d d j S )Nr )lowerxs r' z6PygmentsDoc.document_lexers_overview..h s AaDGMMOr) keyr , *\*_\None .)r1
extensionsaliasesclassc g }t | D ]< \ }}|r!|j |j | )|j d|z > dj | S )zFormat a table row )zipappendljustjoin)columnsr# lccolumn_lengthss r' write_rowz7PygmentsDoc.document_lexers_overview..write_roww sT CNG41JJqwwqz*JJs1u% 5 88C= r) c < D cg c] } d| z }} | S c c} w )zWrite a table separator row=r0 )rN seprO rP s r' write_seperatorz=PygmentsDoc.document_lexers_overview..write_seperator s* "01.Q3q5.C1 c? " 2s Namez Extension(s)z
Short name(s)z Lexer classr1 rC rD z :class:`~rE r/ r )$pip._vendor.pygments.lexers._mappingr, pip._vendor.pygments.lexersr- sorteditemsr alias_filenamesrI r2 rK replacemaxlen)r" r, r- r# tabler3 classnamedata lexer_clsrC column_namescolumnrowrT rO rP s @@r' r z$PygmentsDoc.document_lexers_overviewX s
@@
&flln:S TOIt(a1I",,y/H/HHJ LL#DGY]]; "ii
3 ; ;C G O OPSUY Z d^d 99T!W- G9Ai[1
U B (46(4f 5 P5CCKs3v; /5 PQ(46 ! #
?$%
9V^_mTU
?$%C JJyF L!ICL>+ -
.
?$%yy~ = Q 6s G,
F=7F= G=Gc
ddl m} g }i }i }t |j d D ]R \ }}|d }t |d d |g }| j
j
|j t || } | j st d|z | j }
t |
t r|
j d }
|j |g j |dj! |d xs d dj! |d
j# d d j# d
d xs d dj! |d xs d |
f ||vs!|j } t | t r| j d } | ||< U t |j d D ] \ }} || t% d| || j' d j) j+ d }
|j t, ||
dt/ |
z fz | D ] }|j t0 |z dj! | S )Nr r+ c | d S Nr r0 r6 s r' r8 z-PygmentsDoc.document_lexers.. AaDr) r9 z&Warning: %s does not have a docstring.utf8r; rA r@ r< r= r> r? c | d S rg r0 r6 s r' r8 z-PygmentsDoc.document_lexers.. rh r) zMissing docstring for rB -r )rV r, rX rY
__import__r r __file__getattr__doc__print
isinstancebytesdecode
setdefaultrI rK r[ r
splitlinesstriprstrip MODULEDOCr] LEXERDOC)r" r, r# modulesmoduledocstringsr_ r` modulemodcls docstringmoddocr headings r' r zPygmentsDoc.document_lexers s
? %flln. I IOIt!WF VT4)=C NN s|| ,#y)C;;>JK I)U+ % , ,V 4 vr * 1 1 $q'",f $q'"**36>>sDISV $q'",f 3
-- fe, #]]6 2F+1 () J, %W]]_. INFF '/ f FGG&v.99;A>DDFMMcRG JJyFGSW 5E#FF G
8d?+ J wws|r) c
( ddl m} g }t |j d D ] \ }}|d }t |d d |g }| j
j
|j t || }|j }t |t r|j d }|j } |j t | dj! |d xs ddj! |d j# d
d xs d|fz d j! | S )
Nr )
FORMATTERSc | d S rg r0 r6 s r' r8 z1PygmentsDoc.document_formatters.. s !r) r9 ri r; rA r@ rj r< r= r ) pip._vendor.pygments.formattersr rX rY rn r r ro rp rq rs rt ru __name__rI FMTERDOCrK r[ )
r" r r# r_ r` r~ r r r r s
r' r z PygmentsDoc.document_formatters s > %j&6&6&8n MOIt!WF VT4)=C NN s|| ,#y)C I)U+ % , ,V 4 llG JJx7DIId1g,>,H&#'99T!W#5#=#=c5#I#SV#,#. .
/ N wws|r) c ddl m} g }|j D ] \ }}| j j t
j |j j |j }t |t r|j d }|j t |j ||fz dj! | S )Nr )FILTERSri r ) pip._vendor.pygments.filtersr rY r r sysr|
__module__ro rq rs rt ru rI FILTERDOCr rK )r" r r# r1 r r s r' r z PygmentsDoc.document_filters s 8 ID# NN s{{3>> : C C D I)U+ % , ,V 4 JJyCLL$ #BB C ) wws|r) N)r r __qualname__rq has_contentrequired_argumentsoptional_argumentsfinal_argument_whitespace option_specr( r r r r r0 r) r' r r : s@ K % K &: x# J $
r) r c 0 | j dt y )N pygmentsdoc)
add_directiver )apps r' setupr s m[1r) )rq r docutilsr docutils.statemachiner docutils.parsers.rstr sphinx.util.nodesr rz r{ r r r r r0 r) r' r sK * * 6
[ ) [ |2r)