-Beo2dZddlmZddlmZddlmZ ddlmZddl m Z m Z dd l m Z dd lmZd Zd ZGddZGddeZGddeZdZy#e$rd ZY0wxYw)a CodeHilite Extension for Python-Markdown ======================================== Adds code/syntax highlighting to standard Python-Markdown code blocks. See for documentation. Original code Copyright 2006-2008 [Waylan Limberg](http://achinghead.com/). All changes Copyright 2008-2014 The Python Markdown Project License: [BSD](https://opensource.org/licenses/bsd-license.php) ) Extension) Treeprocessor)parseBoolValue) 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 ints, the line numbers to emphasize. )listmapintsplit ValueError)exprs >lib/python3.12/site-packages/markdown/extensions/codehilite.pyparse_hl_linesr s=  CTZZ\*++  s &- ;;c$eZdZdZdZddZdZy) CodeHilitea Determine language of source code, and pass it on to the Pygments highlighter. Usage: code = CodeHilite(src=some_code, lang='python') html = code.hilite() Arguments: * src: Source string or any object with a .readline attribute. * lang: String name of Pygments lexer to use for highlighting. Default: `None`. * guess_lang: Auto-detect which lexer to use. Ignored if `lang` is set to a valid value. Default: `True`. * use_pygments: Pass code to pygments for code highlighting. If `False`, the code is instead wrapped for highlighting by a JavaScript library. Default: `True`. * pygments_formatter: The name of a Pygments formatter or a formatter class used for highlighting the code blocks. Default: `html`. * linenums: An alias to Pygments `linenos` formatter option. Default: `None`. * css_class: An alias to Pygments `cssclass` formatter option. Default: 'codehilite'. * lang_prefix: 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: https://pygments.org/docs/formatters/#HtmlFormatter Lexer Options: https://pygments.org/docs/lexers/ 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's builtin formatters. Advanced Usage: code = CodeHilite( src = some_code, lang = 'php', startinline = True, # Lexer option. Snippet does not start with `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)a7 Pass code to the [Pygments](http://pygments.pocoo.org/) highliter 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)rrr aliasesr isinstancerstrr r rreplaceappendformatjoin)r*shebanglexerr/ formattertxtclasses class_strs rhilitezCodeHilite.hilite{sP88>>$' 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) aH Determines language of a code block from shebang line and whether the said line should be removed or left in place. If the sheband 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" rNr.a (?:(?:^::+)|(?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 rEThl_lines)rer'rr(compileVERBOSEsearchgrouplowerr IndexErrorinsertr)rrDr;)r*rOlinesflcms rr<zCodeHilite._parseHeaders$ t$ YYq\ JJ**  HHRL  !GGFO113 wwv Q#||I&.17793E*. Y''5aggj6I'JDLL $ LLB 99U#))$/ !   !s!$D77E  E N)T)__name__ __module__ __qualname____doc__r+rKr<r:r,rrr0s4l(9v50r,rceZdZdZdZdZy)HiliteTreeprocessorz' Highlight source code in code blocks. cr|jdd}|jdd}|jdd}|S)zUnescape code.r3r2r5r4r1r0)rA)r*r9s r code_unescapez!HiliteTreeprocessor.code_unescapes9||FC(||FC(||GS) r,c |jd}|D]}t|dk(s|djdk(s%|jj }t |j |djf|jj|jddd|}|jjj|j}|jd|_||_y ) z* Find code blocks and store in htmlStash. prerrcodepygments_styledefault) tab_lengthstylepN)iterlentagconfigcopyrrbr9mdrhr( htmlStashstorerKclear)r*rootblocksblock local_configre placeholders rrunzHiliteTreeprocessor.runs5! )E5zQ58<<6#9#{{//1 !&&uQx}}5#ww11&**+;YG#  #gg//55dkkmD    (  )r,N)r[r\r]r^rbryr:r,rr`r`s1)r,r`ceZdZdZdZdZy)CodeHiliteExtensionz6 Add source code highlighting to markdown codeblocks. c 2ddgddgddgddgdd gdd gd d gd dgd|_|jD]U\}}||jvr|j||'t|tr t |d}|dg|j|<Wy#t $rYwxYw)Nz=Use lines numbers. True|table|inline=yes, False=no, None=autoTz,Automatic language detection - Default: Truer$z6Set class name for wrapper
- Default: codehilitergz>Pygments HTML Formatter Style (Colorscheme) - Default: defaultFz8Use inline styles instead of CSS classes - Default falsez[Use Pygments to Highlight code blocks. Disable if using a JavaScript library. Default: TruerzQPrefix prepended to the language when use_pygments is false. Default: "language-"rzBUse a specific formatter for Pygments highlighting.Default: "html")r!rr#rf noclassesrrr) preserve_noner7)rnitems setConfigr?r@rr)r*kwargskeyvalues rr+zCodeHiliteExtension.__init__sXZIK&01 ) BC *+"-. c$*$5#%- 8!,,. /JCdkk!sE*eS) .uD I%*2; C  /&s) B  BBct|}|j|_|jj |dd|j |y)z/ Add HilitePostprocessor to Markdown instance. rKN)r` getConfigsrntreeprocessorsregisterregisterExtension)r*rphiliters rextendMarkdownz"CodeHiliteExtension.extendMarkdown@s@%b)* ""7Hb9 T"r,N)r[r\r]r^r+rr:r,rr{r{s@)/V#r,r{c tdi|S)Nr:)r{)rs r makeExtensionrIs  ( ((r,N)r^r7rrrutilrr=rpygments.lexersr r pygments.formattersr pygments.utilr ImportErrorrrr`r{rr:r,rrss"*!">9+H  {0{0B)-)B4#)4#n)[ HsAA#"A#