$g4dZddlmZddlmZddlmZddlmZddl m Z m Z m Z e r dd l mcmZ dd lmZdd lmZmZdd lmZdd lmZdZn #e$rdZYnwxYwddZGddZGddeZGddeZdZd S)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) ClassNotFoundTFexprstrreturn list[int]c|sgS ttt|S#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)rs ^/var/www/html/netbox-4.1.3/venv/lib/python3.11/site-packages/markdown/extensions/codehilite.pyparse_hl_linesr*sZ  CTZZ\\**+++  s3: A A c,eZdZdZd dZddd Zdd Zd S) 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[2[ G # #!(Z!>!>GI  W $ $")++k<"H"HGJ  W $ $"&GJ  Tshebangboolrc|jd|_|j|r|tr+|jr# t |jfi|j}nc#t$rV |j rt|jfi|j}nt di|j}n!#t$rt di|j}YnwxYwYnwxYw|js|j d|_|j |j}t|jtr: t!|jfi|j}n5#t"$rt!di|j}YnwxYw|jdd|i|j}t%|j||S|jdd}|d d }|d d }|d d}g}|jr3|d|j |j|jdr|dd}|r(dd|}d|jd||S)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.  Ntextrr'lang_str&&<<>>"z"z{}{}r(r)z class="{}" z)
{}
r*)r8)r')rstripr! _parseHeaderpygmentsr#r r0rr"raliasesr$ isinstancer&rrrr replaceappendformatjoin)r1r4lexerr9 formattertxtclasses class_strs rhilitezCodeHilite.hilites8>>$'' 9         ) ))  F)$)DDt|DD F F FFJ +DH E E E E 1 I IDL I I!FFF-EE EEEEEF  F9 -!M!, *7DI77H$1377 WN 5d6M ^ ^QUQ] ^ ^II$NNN 5 M M M MIIIN4D3VVXVVV TXui88 8(""300C++c6**C++c6**C++c8,,CGy Kv}}T-=tyIIJJJ|I& +z***I D)00'1B1BCC @GG Z( sHA&& C10B"!C"C=C?CCC D%%EENonecddl}|jd}|d}|d|j}||}|r |d|_ n#t$r d|_ YnwxYw|dr| d||j d|dr d |j d<t|d |j d <n| d|d|d|_dS) 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" rNr7a (?:(?:^::+)|(?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))? r!pathr(r4Thl_lines)rerrr/compileVERBOSEsearchgrouplowerr! IndexErrorinsertr0rrLrD)r1rWlinesflcms rrEzCodeHilite._parseHeadersa$  t$$ YYq\\ JJ*   HHRLL   !GGFOO1133  ! ! !   !wwv $ Q###|I&.17793E3E.*. Y''5aggj6I6I'J'JDL $ $ LLB   99U##))$//s',BB('B(N)rr)T)r4r5rr)rrS)__name__ __module__ __qualname____doc__r2rRrErCr3rrr:sa66p(99999v505050505050r3rc.eZdZUdZded<d dZdd Zd S)HiliteTreeprocessorz' Highlight source code in code blocks. zdict[str, Any]configr8rrc|dd}|dd}|dd}|S)zUnescape code.r=r<r?r>r;r:)rI)r1r8s r code_unescapez!HiliteTreeprocessor.code_unescapesB||FC((||FC((||GS)) r3root etree.ElementrSc |d}|D]}t|dkr|djdkr|j}|dj}|Ot ||f|jj | ddd|}|jj | }|d |_||_dS) z, Find code blocks and store in `htmlStash`. prerrcodeNpygments_styledefault) tab_lengthstylep)iterlentagricopyr8rrkmdrsr/ htmlStashstorerRclear)r1rlblocksblock local_configr8rp placeholders rrunzHiliteTreeprocessor.run s5!! ) )E5zzQ58<6#9#9#{//11 Qx}<!&&t,,#w1&**+;YGG#  #g/55dkkmmDD    ( % ) )r3N)r8rrr)rlrmrrS)rcrdrerf__annotations__rkrrCr3rrhrhsP11))))))r3rhceZdZdZdZdZdS)CodeHiliteExtensionz7 Add source code highlighting to markdown code blocks. c Dddgddgddgddgdd gdd gd d gd dgd|_ |D]i\}}||jvr|||%t|tr# t |d}n#t $rYnwxYw|dg|j|<jdS)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`.rrz@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)r"r+rq noclassesr#r$r&) preserve_nonerA)riitems setConfigrHrrr)r1kwargskeyvalues rr2zCodeHiliteExtension.__init__&s&gGY]Tts^#-   4 / ,,.. / /JCdk!!sE****eS)) .uD I I I%$)2; C   / /s1B BBct|}||_|j|dd||dS)z1 Add `HilitePostprocessor` to Markdown instance. rRN)rh getConfigsritreeprocessorsregisterregisterExtension)r1rzhiliters rextendMarkdownz"CodeHiliteExtension.extendMarkdownQsU%b))** ""7Hb999 T"""""r3N)rcrdrerfr2rrCr3rrr#s9AA)/)/)/V#####r3rc tdi|S)NrC)r)rs r makeExtensionrZs  ( ( ( ((r3)rrrr)rf __future__rrArrrutilrtypingr r r xml.etree.ElementTreeetree ElementTreerFr pygments.lexersr rpygments.formattersr pygments.utilr ImportErrorrrrhrrrCr3rrs#"""""******!!!!!!//////////*)))))))))"""""">>>>>>>>999999++++++HHHHH     }0}0}0}0}0}0}0}0F#)#)#)#)#)-#)#)#)L4#4#4#4#4#)4#4#4#n)))))sAAA