
    Qjf                       U d Z ddlmZ ddlmZ ddlmZ ddlmZm	Z	 ddl
mZ ddlmZ ddlmZmZ dd	lmZmZmZmZmZmZmZ dd
lmZ ddlmZ ddlmZ ddlm Z m!Z! ddl"m#Z#m$Z$ erddl%m&Z& ddl'm(Z( ddl)m*Z*  e#jV                  e,      Z-i Z.de/d<    eed       eed       eed       eed       eed      dZ0de/d<    e1d      d e1d      d e1d      diZ2dZ3 G d  d!      Z4y")#z%Highlight code blocks using Pygments.    )annotations)partial)import_module)TYPE_CHECKINGAny)	highlight)
ErrorToken)HtmlFormatterLatexFormatter)CLexerPythonConsoleLexerPythonLexerRstLexer	TextLexerget_lexer_by_nameguess_lexer)get_style_by_name)ClassNotFound)__)	NoneStyleSphinxStyle)logging	texescape)	Formatter)Lexer)Stylezdict[str, Lexer]lexersF)stripnl)nonepythonpyconrestcz'dict[str, type[Lexer] | partial[Lexer]]lexer_classes\z	\PYGZbs{}{z	\PYGZob{}}z	\PYGZcb{}aS  
% Sphinx redefinitions
% Originally to obtain a straight single quote via package textcomp, then
% to fix problems for the 5.0.0 inline code highlighting (captions!).
% The \text is from amstext, a dependency of sphinx.sty.  It is here only
% to avoid build errors if for some reason expansion is in math mode.
\def\PYGZbs{\text\textbackslash}
\def\PYGZus{\_}
\def\PYGZob{\{}
\def\PYGZcb{\}}
\def\PYGZca{\text\textasciicircum}
\def\PYGZam{\&}
\def\PYGZlt{\text\textless}
\def\PYGZgt{\text\textgreater}
\def\PYGZsh{\#}
\def\PYGZpc{\%}
\def\PYGZdl{\$}
\def\PYGZhy{\sphinxhyphen}% defined in sphinxlatexstyletext.sty
\def\PYGZsq{\text\textquotesingle}
\def\PYGZdq{"}
\def\PYGZti{\text\textasciitilde}
\makeatletter
% use \protected to allow syntax highlighting in captions
\protected\def\PYG#1#2{\PYG@reset\PYG@toks#1+\relax+{\PYG@do{#2}}}
\makeatother
c                      e Zd ZeZeZ	 d	 	 	 	 	 	 	 d	dZd
dZddZ		 	 	 d	 	 	 	 	 	 	 	 	 	 	 ddZ
	 	 	 d	 	 	 	 	 	 	 	 	 	 	 	 	 ddZddZy)PygmentsBridgeNc                    || _         || _        | j                  |      }d|i| _        |dk(  r| j                  | _        y | j                  | _        d| j                  d<   y )NstylehtmlPYGcommandprefix)destlatex_engine	get_styleformatter_argshtml_formatter	formatterlatex_formatter)selfr/   	stylenamer0   r+   s        3lib/python3.12/site-packages/sphinx/highlighting.py__init__zPygmentsBridge.__init__\   s_     	(y)/6.>6>!00DN!11DN38D0    c                    |r|dk(  rt         S |dk(  rt        S d|v r*|j                  dd      \  }}t        t	        |      |      S t        |      S )Nsphinxr   .   )r   r   rsplitgetattrr   r   )r6   r7   modules      r8   r1   zPygmentsBridge.get_stylej   s\    I1& I ) 0 0a 8FI=0)<<$Y//r:   c                \    |j                  | j                          | j                  di |S )N )updater2   r4   )r6   kwargss     r8   get_formatterzPygmentsBridge.get_formatteru   s(    d))*t~~'''r:   c                   |si }|dv r|j                  d      rd}nd}|dk(  rd}|t        v r	t        |   S |t        v rt        |   di |}n	 |dk(  rt        |fi |}nt	        |fi |}|s|j                  d
       |S # t
        $ r2 t        j                  t        d      ||       t        d	   di |}Y Ow xY w)N>   pypy3r    defaultpython3z>>>r!   r    pycon3guessz#Pygments lexer name %r is not known)locationr   raiseonerrorrC   )

startswithr   r$   r   r   r   loggerwarningr   
add_filter)r6   sourcelangoptsforcerN   lexers          r8   	get_lexerzPygmentsBridge.get_lexery   s     D @@  '8D6>$<]"!$'/$/E	67?'7$7E-d;d;E ^, ! 6<=th   &f-55	6s   B 8B=<B=c           
        t        |t              s|j                         }| j                  |||||      } | j                  d	i |}	 t        |||      }	| j                  dk(  r|	S t        j                  |	| j                        S # t        $ ri}
|dk(  rd}n5t        j                  t        d      ||t        |
      dd|       |rd}nd}| j                  |||||      }t        |||      }	Y d }
~
d }
~
ww xY w)
NrJ   r   z\Lexing literal_block %r as "%s" resulted in an error at token: %r. Retrying in relaxed mode.mischighlighting_failure)typesubtyperN   Tr,   rC   )
isinstancestrdecoderY   rF   r   r	   rQ   rR   r   r/   r   hlescaper0   )r6   rT   rU   rV   rW   rN   rE   rX   r4   hlsourceerrs              r8   highlight_blockzPygmentsBridge.highlight_block   s    &#&]]_FvtT5(C 'D&&00		; 	:H4 99O %%h0A0ABB;  	; y 4 H2%   !D ENN64uhGE 	:H/	;s   	B 	C9AC44C9c                    | j                         }| j                  dk(  r|j                  d      S |j                         t        z   S )Nr,   z
.highlight)rF   r/   get_style_defs_LATEX_ADD_STYLES)r6   r4   s     r8   get_stylesheetzPygmentsBridge.get_stylesheet   sB    &&(	99++L99++-0AAAr:   )r,   r<   N)r/   r`   r7   r`   r0   z
str | NonereturnNone)r7   r`   rj   ztype[Style])rE   r   rj   r   )NFN)rT   r`   rU   r`   rV   dict | NonerW   boolrN   r   rj   r   )rT   r`   rU   r`   rV   rl   rW   rm   rN   r   rE   r   rj   r`   )rj   r`   )__name__
__module____qualname__r
   r3   r   r5   r9   r1   rF   rY   re   ri   rC   r:   r8   r)   r)   V   s     #N$O Y]99-09KU9	9	0( !)) ) 	)
 ) ) 
)^ !/C/C /C 	/C
 /C /C /C 
/CbBr:   r)   N)5__doc__
__future__r   	functoolsr   	importlibr   typingr   r   pygmentsr   pygments.filtersr	   pygments.formattersr
   r   pygments.lexersr   r   r   r   r   r   r   pygments.stylesr   pygments.utilr   sphinx.localer   sphinx.pygments_stylesr   r   sphinx.utilr   r   pygments.formatterr   pygments.lexerr   pygments.styler   	getLoggerrn   rQ   r   __annotations__r$   ordescape_hl_charsrh   r)   rC   r:   r8   <module>r      s    + "  # %  ' =   . '  9 *,$$			8	$ Iu-k51'7He,		':6  t9lCHlCHl[ 8DB DBr:   