eric: comparison ThirdParty/Pygments/pygments/formatters/html.py

-:8bc578136279
+:4f20dba37ab6
 pygments.formatters.html
 ~~~~~~~~~~~~~~~~~~~~~~~~
 Formatter for HTML output.
-:copyright: Copyright 2006-2013 by the Pygments team, see AUTHORS.
+:copyright: Copyright 2006-2014 by the Pygments team, see AUTHORS.
 :license: BSD, see LICENSE for details.
 """
-try:
+from __future__ import print_function
-basestring    # __IGNORE_WARNING__
-except NameError:
-basestring = str
 import os
 import sys
 import os.path
-import io
 from pygments.formatter import Formatter
 from pygments.token import Token, Text, STANDARD_TYPES
-from pygments.util import get_bool_opt, get_int_opt, get_list_opt, bytes
+from pygments.util import get_bool_opt, get_int_opt, get_list_opt, \
+StringIO, string_types, iteritems
 try:
 import ctags
 except ImportError:
 ctags = None
 __all__ = ['HtmlFormatter']
 _escape_html_table = {
-ord('&'): '&amp;',
+ord('&'): u'&amp;',
-ord('<'): '&lt;',
+ord('<'): u'&lt;',
-ord('>'): '&gt;',
+ord('>'): u'&gt;',
-ord('"'): '&quot;',
+ord('"'): u'&quot;',
-ord("'"): '&#39;',
+ord("'"): u'&#39;',
 }
 def escape_html(text, table=_escape_html_table):
 """Escape &, <, > as well as single and double quotes for HTML."""
 return text.translate(table)
 `cssclass`
 CSS class for the wrapping ``<div>`` tag (default: ``'highlight'``).
 If you set this option, the default selector for `get_style_defs()`
 will be this class.
-*New in Pygments 0.9:* If you select the ``'table'`` line numbers, the
+.. versionadded:: 0.9
-wrapping table will have a CSS class of this string plus ``'table'``,
+If you select the ``'table'`` line numbers, the wrapping table will
-the default is accordingly ``'highlighttable'``.
+have a CSS class of this string plus ``'table'``, the default is
+accordingly ``'highlighttable'``.
 `cssstyles`
 Inline CSS styles for the wrapping ``<div>`` tag (default: ``''``).
 `prestyles`
-Inline CSS styles for the ``<pre>`` tag (default: ``''``).  *New in
+Inline CSS styles for the ``<pre>`` tag (default: ``''``).
-Pygments 0.11.*
+.. versionadded:: 0.11
 `cssfile`
 If the `full` option is true and this option is given, it must be the
 name of an external file. If the filename does not include an absolute
 path, the file's path will be assumed to be relative to the main output
 file's path, if the latter can be found. The stylesheet is then written
-to this file instead of the HTML file. *New in Pygments 0.6.*
+to this file instead of the HTML file.
+.. versionadded:: 0.6
 `noclobber_cssfile`
 If `cssfile` is given and the specified file exists, the css file will
 not be overwritten. This allows the use of the `full` option in
 combination with a user specified css file. Default is ``False``.
-*New in Pygments 1.1.*
+.. versionadded:: 1.1
 `linenos`
 If set to ``'table'``, output line numbers as a table with two cells,
 one containing the line numbers, the other the whole code.  This is
 copy-and-paste-friendly, but may cause alignment problems with some
 unless you give the enclosing ``<pre>`` tags an explicit ``line-height``
 CSS property (you get the default line spacing with ``line-height:
 125%``).
 `hl_lines`
-Specify a list of lines to be highlighted.  *New in Pygments 0.11.*
+Specify a list of lines to be highlighted.
+.. versionadded:: 0.11
 `linenostart`
 The line number for the first line (default: ``1``).
 `linenostep`
 `nobackground`
 If set to ``True``, the formatter won't output the background color
 for the wrapping element (this automatically defaults to ``False``
 when there is no wrapping element [eg: no argument for the
-`get_syntax_defs` method given]) (default: ``False``). *New in
+`get_syntax_defs` method given]) (default: ``False``).
-Pygments 0.6.*
+.. versionadded:: 0.6
 `lineseparator`
 This string is output between lines of code. It defaults to ``"\n"``,
 which is enough to break a line inside ``<pre>`` tags, but you can
-e.g. set it to ``"<br>"`` to get HTML line breaks. *New in Pygments
+e.g. set it to ``"<br>"`` to get HTML line breaks.
-0.7.*
+.. versionadded:: 0.7
 `lineanchors`
 If set to a nonempty string, e.g. ``foo``, the formatter will wrap each
 output line in an anchor tag with a ``name`` of ``foo-linenumber``.
-This allows easy linking to certain lines. *New in Pygments 0.9.*
+This allows easy linking to certain lines.
+.. versionadded:: 0.9
 `linespans`
 If set to a nonempty string, e.g. ``foo``, the formatter will wrap each
 output line in a span tag with an ``id`` of ``foo-linenumber``.
-This allows easy access to lines via javascript. *New in Pygments 1.6.*
+This allows easy access to lines via javascript.
+.. versionadded:: 1.6
 `anchorlinenos`
 If set to `True`, will wrap line numbers in <a> tags. Used in
 combination with `linenos` and `lineanchors`.
 `tagsfile`
 If set to the path of a ctags file, wrap names in anchor tags that
 link to their definitions. `lineanchors` should be used, and the
 tags file should specify line numbers (see the `-n` option to ctags).
-*New in Pygments 1.6.*
+.. versionadded:: 1.6
 `tagurlformat`
 A string formatting pattern used to generate links to ctags definitions.
 Available variables are `%(path)s`, `%(fname)s` and `%(fext)s`.
 Defaults to an empty string, resulting in just `#prefix-number` links.
-*New in Pygments 1.6.*
+.. versionadded:: 1.6
 **Subclassing the HTML formatter**
-*New in Pygments 0.7.*
+.. versionadded:: 0.7
 The HTML formatter is now built in a way that allows easy subclassing, thus
 customizing the output HTML code. The `format()` method calls
 `self._format_lines()` which returns a generator that yields tuples of ``(1,
 line)``, where the ``1`` indicates that the ``line`` is a line of the
 highlighting style. ``arg`` can be a string or list of selectors to
 insert before the token type classes.
 """
 if arg is None:
 arg = ('cssclass' in self.options and '.'+self.cssclass or '')
-if isinstance(arg, basestring):
+if isinstance(arg, string_types):
 args = [arg]
 else:
 args = list(arg)
 def prefix(cls):
 for arg in args:
 tmp.append((arg and arg + ' ' or '') + cls)
 return ', '.join(tmp)
 styles = [(level, ttype, cls, style)
-for cls, (style, ttype, level) in self.class2style.items()
+for cls, (style, ttype, level) in iteritems(self.class2style)
 if cls and style]
 styles.sort()
 lines = ['%s { %s } /* %s */' % (prefix(cls), style, repr(ttype)[6:])
 for (level, ttype, cls, style) in styles]
 if arg and not self.nobackground and \
 # pseudo files, e.g. name == '<fdopen>'
 raise AttributeError
 cssfilename = os.path.join(os.path.dirname(filename),
 self.cssfile)
 except AttributeError:
-sys.stderr.write('Note: Cannot determine output file name, ' \
+print('Note: Cannot determine output file name, ' \
-'using current directory as base for the CSS file name')
+'using current directory as base for the CSS file name',
+file=sys.stderr)
 cssfilename = self.cssfile
 # write CSS file only if noclobber_cssfile isn't given as an option.
 try:
 if not os.path.exists(cssfilename) or not self.noclobber_cssfile:
 cf = open(cssfilename, "w")
 for t, line in inner:
 yield t, line
 yield 0, DOC_FOOTER
 def _wrap_tablelinenos(self, inner):
-dummyoutfile = io.StringIO()
+dummyoutfile = StringIO()
 lncount = 0
 for t, line in inner:
 if t:
 lncount += 1
 dummyoutfile.write(line)
 for t, line in lines:
 if num%sp == 0:
 style = 'background-color: #ffffc0; padding: 0 5px 0 5px'
 else:
 style = 'background-color: #f0f0f0; padding: 0 5px 0 5px'
-yield 1, '<span style="%s">%*s</span> ' % (
+yield 1, '<span style="%s">%*s </span>' % (
 style, mw, (num%st and ' ' or num)) + line
 num += 1
 else:
 for t, line in lines:
 yield 1, ('<span style="background-color: #f0f0f0; '
-'padding: 0 5px 0 5px">%*s</span> ' % (
+'padding: 0 5px 0 5px">%*s </span>' % (
 mw, (num%st and ' ' or num)) + line)
 num += 1
 elif sp:
 for t, line in lines:
-yield 1, '<span class="lineno%s">%*s</span> ' % (
+yield 1, '<span class="lineno%s">%*s </span>' % (
 num%sp == 0 and ' special' or '', mw,
 (num%st and ' ' or num)) + line
 num += 1
 else:
 for t, line in lines:
-yield 1, '<span class="lineno">%*s</span> ' % (
+yield 1, '<span class="lineno">%*s </span>' % (
 mw, (num%st and ' ' or num)) + line
 num += 1
 def _wrap_lineanchors(self, inner):
 s = self.lineanchors

Mercurial Repositories > eric / file comparison

comparison: ThirdParty/Pygments/pygments/formatters/html.py

ThirdParty/Pygments/pygments/formatters/html.py