ƚ\m&E t d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z dZ
dZ d Z d
Z
G d d e Zd
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 D e Zd ZdZdZdZdZdZi Zd Z d Z
d Z d Z d Z
d
S ) PygmentsDoczn
A directive to collect all lexers/formatters/filters and generate
autoclass directives for them.
F r c t | _ | j d dk r| }n| j d dk r| }n[| j d dk r| }n5| j d dk r| }nt d t j }t | d d }t | j
|| | j D ]+}| 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 p/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/pip/_vendor/pygments/sphinxext.pyrunzPygmentsDoc.runG s+ >! ( (&&((CC
^A
,
.
.**,,CC
^A
)
+
+''))CC
^A
"3
3
3//11CC JKK K~
ciioob
1
1
1 R666. E EB J ( < @ @ D D D D} c
ddl m} ddlm} g }g
d }t | d D ]\ }} ||d }|j |j z }
||d |j d
| d d
d d pd
d
|d |d d| d g d}
fd| D fd fd}
| |
| dddd | |
D ]?} | | d | d | d d| d d @| |
d
| S ) 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_linke s(
,+4++3++++Kr) c B | d d S )Nr )lowerxs r' z6PygmentsDoc.document_lexers_overview..j s AaDGMMOO r) keyr , *\*_\None .)r1
extensionsaliasesclassc H g | ] t fd D S )c J g | ] }|
t | S r0 )len).0rowcolumns r'
zCPygmentsDoc.document_lexers_overview...v s. P P PCCK Ps3v; / / P P Pr) )max)rI rK tables @r' rL z8PygmentsDoc.document_lexers_overview..v sG 6 6 6 $ P P P P5 P P PQQ 6 6 6r) c g }t | D ]H\ }}|r)| | | 0| d|z Id | S )zFormat a table row )zipappendljustjoin)columnsr# lengthcolcolumn_lengthss r' write_rowz7PygmentsDoc.document_lexers_overview..write_rowy sw C ">7 ; ;
+
+ +JJsyy 0 01111JJs6z****88C== r) c & d D } | S )zWrite a table separator rowc g | ]}d |z S )=r0 )rI cs r' rL zQPygmentsDoc.document_lexers_overview..write_seperator.. s 111Q3q5111r) r0 )seprX rY s r' write_seperatorz=PygmentsDoc.document_lexers_overview..write_seperator s" 11.111C 9c? "r) 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_filenamesrR r2 rT replace)r" r, r- r# r3 classnamedata lexer_clsrC column_namesr_ rJ rX rN rY s @@@r' r z$PygmentsDoc.document_lexers_overviewZ s
@?????@@@@@@
&fllnn:S:S T T T OIt((a11I",y/HHJ LL# DGY];; "ii
3 3 ; ;C G G O OPSUY Z Z d^d 99T!W-- G11i11
BAA 6 6 6 6(46 6 6 ! ! ! ! ! # # # # # #
??$$%%%
99V^_mTTUUU
??$$%%% . .C JJyyF L!I+CL+++ - -
.
.
.
.
??$$%%%yy~~ r) c
ddl m} ddlm} dd l}dd l}g }i }i }t
| d D ]P\ }} | d }
t |
d d |g } | j
| j t | | } | j
st d| d | j
}
t |
t r|
d }
t | d d }|r| | | j j d
z d z |z }| d
}|st- d| d| | d r<| d d }|
dz
}
|
d| dz
}
| D ] }|
d| dz
}
| j r d| j }nd}| |
g |d | d pdd | d dd d d pdd | d pd|
|f |
|vr6| j
}t |t r| d }|||
< Rt
| d D ]\ }
}||
t- d!|
||
d d" }| t> |
|d#tA | z fz |D ] } | tB | z d | S )$Nr r+ )pygmentsc | d S Nr r0 r6 s r' r8 z-PygmentsDoc.document_lexers..
AaD r) r9 z Warning: z does not have a docstring.utf8_exampletests examplefileszutf-8)encodingzEmpty example file 'z ' for lexer rA z
.. admonition:: Example
z
.. code-block:: z
z
r z.. versionadded:: r r; r@ r< r= r> r? c | d S rn r0 r6 s r' r8 z-PygmentsDoc.document_lexers.. ro r) zMissing docstring for rB -)"ra r, pip._vendorrl inspectpathlibrc rd
__import__r r __file__getattr__doc__print
isinstancebytesdecodePath
getabsfileparent read_textr
splitlines
version_added
setdefaultrR rT rf striprstrip MODULEDOCrH LEXERDOC)r" r, rl rz r{ r# modulesmoduledocstringsrg rh modulemodcls docstring example_filepcontent
lexer_nameline version_linemoddocr headings r' r zPygmentsDoc.document_lexers s ??????(((((( %fllnn.. I I I , 2 , 2OIt!WF VT4)==C N s| , , ,#y))C;
JH)HHHIII I)U++
5 % , ,V 4 4 "3
D99L
;LL!3!3H!=!=>>EL ,-/;<++w+77 (#'| ' '$' '( ( ( 7 ;!%aJ !DDI !LJ!L!L!LLI ' 2 2 4 4 ; ;!%:$%:%:%::
" GC4E G G ! vr * * 1 1 $q'"",f $q'""**366>>sDIISV $q'"",f
3
--- fe,, 3 #]]6 2 2F+1 ( $W]]__.. I I I , ,NFF '/ A A ABBB&v.99;;A>DDFFMMcRRG JJyFGSW 5E#FF G G G
,
,
8d?++++
, wws||r) c
j ddl m} g }t | d D ]\ }}|d }t |d d |g }| j |j t || }|j }t |t r| d }|j
} | t | d |d pdd |d d
d pd|fz d | S )
Nr )
FORMATTERSc | d S rn r0 r6 s r' r8 z1PygmentsDoc.document_formatters.. s
! r) r9 rp r; rA r@ ru r< r= r ) pip._vendor.pygments.formattersr rc rd r| r r r} r~ r r r r __name__rR FMTERDOCrT rf )
r" r r# rg rh r r r r r s
r' r z PygmentsDoc.document_formatters s< >>>>>> %j&6&6&8&8nn M M M / /OIt!WF VT4)==C N s| , , ,#y))C I)U++
5 % , ,V 4 4 lG JJx7DIId1g,>,>,H&#'99T!W#5#5#=#=c5#I#I#SV#,#. .
/
/
/
/ wws||r) c ddl m} g }| D ]\ }}| j t
j |j j |j }t |t r| d }|
t |j ||fz d | S )Nr )FILTERSrp r ) pip._vendor.pygments.filtersr rd r r sysr
__module__r} r r r r rR FILTERDOCr rT )r" r r# r1 r r s r' r z PygmentsDoc.document_filters s 888888 D DID# N s{3> : C D D D I)U++
5 % , ,V 4 4 JJyCL$ #BB C C C Cwws||r) N)r r __qualname__r has_contentrequired_argumentsoptional_argumentsfinal_argument_whitespace option_specr( r r r r r0 r) r' r r < s K % K &: : : x? ? ? B $
r) r c < | dt d S )N pygmentsdoc)
add_directiver )apps r' setupr s m[11111r) )r r docutilsr docutils.statemachiner docutils.parsers.rstr sphinx.util.nodesr r r r r r r r0 r) r' r s
* * * * * * * * * * * * 6 6 6 6 6 6
w w w w w ) w w w t2 2 2 2 2r)