/Vh4dZddlmZddlmZddlmZddlmZddl m Z m Z m Z e r dd l mcmZ dd lmZdd lmZmZdd lmZdd lmZdZddZGddZGddeZGddeZdZy #e$rdZY1wxYw)z Adds code/syntax highlighting to standard Python-Markdown code blocks. See the [documentation](https://Python-Markdown.github.io/extensions/code_hilite) for details. ) annotations) Extension) Treeprocessor)parseBoolValue) TYPE_CHECKINGCallableAnyN) highlight)get_lexer_by_name guess_lexer)get_formatter_by_name) ClassNotFoundTFc||sgS ttt|jS#t$rgcYSwxYw)zSupport our syntax for emphasizing certain lines of code. `expr` should be like '1 2' to emphasize lines 1 and 2 of a code block. Returns a list of integers, the line numbers to emphasize. )listmapintsplit ValueError)exprs N/home/dcms/DCMS/lib/python3.12/site-packages/markdown/extensions/codehilite.pyparse_hl_linesr*s=  CTZZ\*++  s &- ;;c*eZdZdZddZdddZd dZy) CodeHiliteau Determine language of source code, and pass it on to the Pygments highlighter. Usage: ```python code = CodeHilite(src=some_code, lang='python') html = code.hilite() ``` Arguments: src: Source string or any object with a `.readline` attribute. Keyword arguments: lang (str): String name of Pygments lexer to use for highlighting. Default: `None`. guess_lang (bool): Auto-detect which lexer to use. Ignored if `lang` is set to a valid value. Default: `True`. use_pygments (bool): Pass code to Pygments for code highlighting. If `False`, the code is instead wrapped for highlighting by a JavaScript library. Default: `True`. pygments_formatter (str): The name of a Pygments formatter or a formatter class used for highlighting the code blocks. Default: `html`. linenums (bool): An alias to Pygments `linenos` formatter option. Default: `None`. css_class (str): An alias to Pygments `cssclass` formatter option. Default: 'codehilite'. lang_prefix (str): Prefix prepended to the language. Default: "language-". Other Options: Any other options are accepted and passed on to the lexer and formatter. Therefore, valid options include any options which are accepted by the `html` formatter or whichever lexer the code's language uses. Note that most lexers do not have any options. However, a few have very useful options, such as PHP's `startinline` option. Any invalid options are ignored without error. * **Formatter options**: * **Lexer Options**: Additionally, when Pygments is enabled, the code's language is passed to the formatter as an extra option `lang_str`, whose value being `{lang_prefix}{lang}`. This option has no effect to the Pygments' builtin formatters. Advanced Usage: ```python code = CodeHilite( src = some_code, lang = 'php', startinline = True, # Lexer option. Snippet does not start with `RTZ2[ G #!(Z!>GI  W $")++k<"HGJ  W $"&GJ  cf|jjd|_|j|r|jtr|j r t |jfi|j}|js|jd|_|j|j}t|jtr" t!|jfi|j}n|jdd|i|j}t%|j||S|jj'dd}|j'dd}|j'dd }|j'd d }g}|jr5|j)d j+|j|j|jd r|j)dd}|r dj+dj-|}dj+|jd||S#t$rl |jr!t|jfi|j}nt di|j}n$#t$rt di|j}YnwxYwYwxYw#t"$rt!di|j}YwxYw)a6 Pass code to the [Pygments](https://pygments.org/) highlighter with optional line numbers. The output should then be styled with CSS to your liking. No styles are applied by default - only styling hooks (i.e.: ``). returns : A string of html.  rlang_str&&<<>>"z"z{}{}r$r%z class="{}" z)
{}
r&)text)r#)r+stripr _parseHeaderpygmentsrr r-rrraliasesr isinstancer"strrrr replaceappendformatjoin)r.shebanglexerr3 formattertxtclasses class_strs rhilitezCodeHilite.hilitesP88>>$' 99      )) F)$))Dt||D99!MM!, **+DII;7H$1137N 5d6M6M ^QUQ]Q] ^I4D33VXVV TXXui8 8((""30C++c6*C++c6*C++c8,CGyyv}}T-=-=tyyIJ||I&z*I)00'1BC @GG Z( E FF +DHH E E 1 IDLL I!F-E EEF  F%N 5 M MINsI H J J  AI#"J #JJ JJ  J J0/J0cddl}|jjd}|jd}|j d|j }|j |}|r |jdj|_ |jdr|jd||jd |jdrd |jd<t|jd |jd <n|jd|dj|jd|_y#t$r d|_ YwxYw) aP Determines language of a code block from shebang line and whether the said line should be removed or left in place. If the shebang line contains a path (even a single /) then it is assumed to be a real shebang line and left alone. However, if no path is given (e.i.: `#!python` or `:::python`) then it is assumed to be a mock shebang for language identification of a code fragment and removed from the code block prior to processing for code highlighting. When a mock shebang (e.i: `#!python`) is found, line numbering is turned on. When colons are found in place of a shebang (e.i.: `:::python`), line numbering is left in the current state - off by default. Also parses optional list of highlight lines, like: :::python hl_lines="1 3" rNr2a (?:(?:^::+)|(?P^[#]!)) # Shebang or 2 or more colons (?P(?:/\w+)*[/ ])? # Zero or 1 path (?P[\w#.+-]*) # The language \s* # Arbitrary whitespace # Optional highlight lines, single- or double-quote-delimited (hl_lines=(?P"|')(?P.*?)(?P=quot))? rpathr$rIThl_lines)rer+rr,compileVERBOSEsearchgrouplowerr IndexErrorinsertr-rrHr?)r.rSlinesflcms rr@zCodeHilite._parseHeaders$ t$ YYq\ JJ**  HHRL  !GGFO113 wwv Q#||I&.17793E*. Y''5aggj6I'JDLL $ LLB 99U#))$/ !   !s!$D77E  E N)r+rD)T)rIboolreturnrD)r`None)__name__ __module__ __qualname____doc__r/rOr@r>r0rrr:s6p(9v50r0rc,eZdZUdZded<ddZddZy) HiliteTreeprocessorz' Highlight source code in code blocks. zdict[str, Any]configcr|jdd}|jdd}|jdd}|S)zUnescape code.r7r6r9r8r5r4)rE)r.r=s r code_unescapez!HiliteTreeprocessor.code_unescapes9||FC(||FC(||GS) r0c |jd}|D]}t|dk(s|djdk(s%|jj }|dj }|Qt |j|f|jj|jddd|}|jjj|j}|jd |_||_y) z, Find code blocks and store in `htmlStash`. prerrcodeNpygments_styledefault) tab_lengthstylep)iterlentagrhcopyr=rrjmdrpr, htmlStashstorerOclear)r.rootblocksblock local_configr=rm placeholders rrunzHiliteTreeprocessor.run s5! )E5zQ58<<6#9#{{//1 Qx}}<!&&t,#ww11&**+;YG#  #gg//55dkkmD    ( % )r0N)r=rDr`rD)r{z etree.Elementr`ra)rbrcrdre__annotations__rjrr>r0rrgrgs1 )r0rgceZdZdZdZdZy)CodeHiliteExtensionz7 Add source code highlighting to markdown code blocks. c 4ddgddgddgddgdd gdd gd d gd dgd|_ |jD]U\}}||jvr|j||'t|tr t |d}|dg|j|<Wy#t $rYwxYw)NzOUse lines numbers. True|table|inline=yes, False=no, None=auto. Default: `None`.Tz/Automatic language detection - Default: `True`.r(z9Set class name for wrapper
- Default: `codehilite`.roz@Pygments HTML Formatter Style (Colorscheme). Default: `default`.Fz;Use inline styles instead of CSS classes - Default `False`.z\Highlight code blocks with pygments. Disable if using a JavaScript library. Default: `True`.r!zTPrefix prepended to the language when `use_pygments` is false. Default: `language-`.r#zDUse a specific formatter for Pygments highlighting. Default: `html`.)r%rr'rn noclassesrr r") preserve_noner;)rhitems setConfigrCrDrr)r.kwargskeyvalues rr/zCodeHiliteExtension.__init__&sgGY]Tts^#-  4 / ,,. /JCdkk!sE*eS) .uD I%*2; C  /&s* B  BBct|}|j|_|jj |dd|j |y)z1 Add `HilitePostprocessor` to Markdown instance. rON)rg getConfigsrhtreeprocessorsregisterregisterExtension)r.rwhiliters rextendMarkdownz"CodeHiliteExtension.extendMarkdownQs@%b)* ""7Hb9 T"r0N)rbrcrdrer/rr>r0rrr#sA)/V#r0rc tdi|S)Nr>)r)rs r makeExtensionrZs  ( ((r0)rrDr`z list[int])re __future__rr;rrrutilrtypingr r r xml.etree.ElementTreeetree ElementTreerAr pygments.lexersr rpygments.formattersr pygments.utilr ImportErrorrrrgrrr>r0rrs#*!//))">9+H  }0}0F#)-#)L4#)4#n)i HsA55A?>A?