Index: third_party/Python-Markdown/markdown/extensions/codehilite.py |
diff --git a/third_party/Python-Markdown/markdown/extensions/codehilite.py b/third_party/Python-Markdown/markdown/extensions/codehilite.py |
deleted file mode 100644 |
index 0657c37681e08c5563b642a6f6bda5be253717e2..0000000000000000000000000000000000000000 |
--- a/third_party/Python-Markdown/markdown/extensions/codehilite.py |
+++ /dev/null |
@@ -1,265 +0,0 @@ |
-""" |
-CodeHilite Extension for Python-Markdown |
-======================================== |
- |
-Adds code/syntax highlighting to standard Python-Markdown code blocks. |
- |
-See <https://pythonhosted.org/Markdown/extensions/code_hilite.html> |
-for documentation. |
- |
-Original code Copyright 2006-2008 [Waylan Limberg](http://achinghead.com/). |
- |
-All changes Copyright 2008-2014 The Python Markdown Project |
- |
-License: [BSD](http://www.opensource.org/licenses/bsd-license.php) |
- |
-""" |
- |
-from __future__ import absolute_import |
-from __future__ import unicode_literals |
-from . import Extension |
-from ..treeprocessors import Treeprocessor |
- |
-try: |
- from pygments import highlight |
- from pygments.lexers import get_lexer_by_name, guess_lexer |
- from pygments.formatters import get_formatter_by_name |
- pygments = True |
-except ImportError: |
- pygments = False |
- |
- |
-def parse_hl_lines(expr): |
- """Support 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. |
- """ |
- if not expr: |
- return [] |
- |
- try: |
- return list(map(int, expr.split())) |
- except ValueError: |
- return [] |
- |
- |
-# ------------------ The Main CodeHilite Class ---------------------- |
-class CodeHilite(object): |
- """ |
- Determine language of source code, and pass it into pygments hilighter. |
- |
- Basic Usage: |
- >>> code = CodeHilite(src = 'some text') |
- >>> html = code.hilite() |
- |
- * src: Source string or any object with a .readline attribute. |
- |
- * linenums: (Boolean) Set line numbering to 'on' (True), |
- 'off' (False) or 'auto'(None). Set to 'auto' by default. |
- |
- * guess_lang: (Boolean) Turn language auto-detection |
- 'on' or 'off' (on by default). |
- |
- * css_class: Set class name of wrapper div ('codehilite' by default). |
- |
- * hl_lines: (List of integers) Lines to emphasize, 1-indexed. |
- |
- Low Level Usage: |
- >>> code = CodeHilite() |
- >>> code.src = 'some text' # String or anything with a .readline attr. |
- >>> code.linenos = True # Turns line numbering on or of. |
- >>> html = code.hilite() |
- |
- """ |
- |
- def __init__(self, src=None, linenums=None, guess_lang=True, |
- css_class="codehilite", lang=None, style='default', |
- noclasses=False, tab_length=4, hl_lines=None, use_pygments=True): |
- self.src = src |
- self.lang = lang |
- self.linenums = linenums |
- self.guess_lang = guess_lang |
- self.css_class = css_class |
- self.style = style |
- self.noclasses = noclasses |
- self.tab_length = tab_length |
- self.hl_lines = hl_lines or [] |
- self.use_pygments = use_pygments |
- |
- def hilite(self): |
- """ |
- 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.: <span class="k">). |
- |
- returns : A string of html. |
- |
- """ |
- |
- self.src = self.src.strip('\n') |
- |
- if self.lang is None: |
- self._parseHeader() |
- |
- if pygments and self.use_pygments: |
- try: |
- lexer = get_lexer_by_name(self.lang) |
- except ValueError: |
- try: |
- if self.guess_lang: |
- lexer = guess_lexer(self.src) |
- else: |
- lexer = get_lexer_by_name('text') |
- except ValueError: |
- lexer = get_lexer_by_name('text') |
- formatter = get_formatter_by_name('html', |
- linenos=self.linenums, |
- cssclass=self.css_class, |
- style=self.style, |
- noclasses=self.noclasses, |
- hl_lines=self.hl_lines) |
- return highlight(self.src, lexer, formatter) |
- else: |
- # just escape and build markup usable by JS highlighting libs |
- txt = self.src.replace('&', '&') |
- txt = txt.replace('<', '<') |
- txt = txt.replace('>', '>') |
- txt = txt.replace('"', '"') |
- classes = [] |
- if self.lang: |
- classes.append('language-%s' % self.lang) |
- if self.linenums: |
- classes.append('linenums') |
- class_str = '' |
- if classes: |
- class_str = ' class="%s"' % ' '.join(classes) |
- return '<pre class="%s"><code%s>%s</code></pre>\n' % \ |
- (self.css_class, class_str, txt) |
- |
- def _parseHeader(self): |
- """ |
- Determines language of a code block from shebang line and whether 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 identifitation 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" |
- """ |
- |
- import re |
- |
- # split text into lines |
- lines = self.src.split("\n") |
- # pull first line to examine |
- fl = lines.pop(0) |
- |
- c = re.compile(r''' |
- (?:(?:^::+)|(?P<shebang>^[#]!)) # Shebang or 2 or more colons |
- (?P<path>(?:/\w+)*[/ ])? # Zero or 1 path |
- (?P<lang>[\w+-]*) # The language |
- \s* # Arbitrary whitespace |
- # Optional highlight lines, single- or double-quote-delimited |
- (hl_lines=(?P<quot>"|')(?P<hl_lines>.*?)(?P=quot))? |
- ''', re.VERBOSE) |
- # search first line for shebang |
- m = c.search(fl) |
- if m: |
- # we have a match |
- try: |
- self.lang = m.group('lang').lower() |
- except IndexError: |
- self.lang = None |
- if m.group('path'): |
- # path exists - restore first line |
- lines.insert(0, fl) |
- if self.linenums is None and m.group('shebang'): |
- # Overridable and Shebang exists - use line numbers |
- self.linenums = True |
- |
- self.hl_lines = parse_hl_lines(m.group('hl_lines')) |
- else: |
- # No match |
- lines.insert(0, fl) |
- |
- self.src = "\n".join(lines).strip("\n") |
- |
- |
-# ------------------ The Markdown Extension ------------------------------- |
- |
- |
-class HiliteTreeprocessor(Treeprocessor): |
- """ Hilight source code in code blocks. """ |
- |
- def run(self, root): |
- """ Find code blocks and store in htmlStash. """ |
- blocks = root.iter('pre') |
- for block in blocks: |
- if len(block) == 1 and block[0].tag == 'code': |
- code = CodeHilite( |
- block[0].text, |
- linenums=self.config['linenums'], |
- guess_lang=self.config['guess_lang'], |
- css_class=self.config['css_class'], |
- style=self.config['pygments_style'], |
- noclasses=self.config['noclasses'], |
- tab_length=self.markdown.tab_length, |
- use_pygments=self.config['use_pygments'] |
- ) |
- placeholder = self.markdown.htmlStash.store(code.hilite(), |
- safe=True) |
- # Clear codeblock in etree instance |
- block.clear() |
- # Change to p element which will later |
- # be removed when inserting raw html |
- block.tag = 'p' |
- block.text = placeholder |
- |
- |
-class CodeHiliteExtension(Extension): |
- """ Add source code hilighting to markdown codeblocks. """ |
- |
- def __init__(self, *args, **kwargs): |
- # define default configs |
- self.config = { |
- 'linenums': [None, |
- "Use lines numbers. True=yes, False=no, None=auto"], |
- 'guess_lang': [True, |
- "Automatic language detection - Default: True"], |
- 'css_class': ["codehilite", |
- "Set class name for wrapper <div> - " |
- "Default: codehilite"], |
- 'pygments_style': ['default', |
- 'Pygments HTML Formatter Style ' |
- '(Colorscheme) - Default: default'], |
- 'noclasses': [False, |
- 'Use inline styles instead of CSS classes - ' |
- 'Default false'], |
- 'use_pygments': [True, |
- 'Use Pygments to Highlight code blocks. ' |
- 'Disable if using a JavaScript library. ' |
- 'Default: True'] |
- } |
- |
- super(CodeHiliteExtension, self).__init__(*args, **kwargs) |
- |
- def extendMarkdown(self, md, md_globals): |
- """ Add HilitePostprocessor to Markdown instance. """ |
- hiliter = HiliteTreeprocessor(md) |
- hiliter.config = self.getConfigs() |
- md.treeprocessors.add("hilite", hiliter, "<inline") |
- |
- md.registerExtension(self) |
- |
- |
-def makeExtension(*args, **kwargs): |
- return CodeHiliteExtension(*args, **kwargs) |