2013-09-22 20:39:16 +00:00
|
|
|
# -*- coding: utf-8 -*-
|
|
|
|
"""
|
|
|
|
pygments.formatters.terminal
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
Formatter for terminal output with ANSI sequences.
|
|
|
|
|
2017-02-14 07:25:51 +00:00
|
|
|
:copyright: Copyright 2006-2017 by the Pygments team, see AUTHORS.
|
2013-09-22 20:39:16 +00:00
|
|
|
:license: BSD, see LICENSE for details.
|
|
|
|
"""
|
|
|
|
|
|
|
|
import sys
|
|
|
|
|
|
|
|
from pygments.formatter import Formatter
|
|
|
|
from pygments.token import Keyword, Name, Comment, String, Error, \
|
2014-12-01 06:10:30 +00:00
|
|
|
Number, Operator, Generic, Token, Whitespace
|
2013-09-22 20:39:16 +00:00
|
|
|
from pygments.console import ansiformat
|
|
|
|
from pygments.util import get_choice_opt
|
|
|
|
|
|
|
|
|
|
|
|
__all__ = ['TerminalFormatter']
|
|
|
|
|
|
|
|
|
|
|
|
#: Map token types to a tuple of color values for light and dark
|
|
|
|
#: backgrounds.
|
|
|
|
TERMINAL_COLORS = {
|
|
|
|
Token: ('', ''),
|
|
|
|
|
|
|
|
Whitespace: ('lightgray', 'darkgray'),
|
|
|
|
Comment: ('lightgray', 'darkgray'),
|
|
|
|
Comment.Preproc: ('teal', 'turquoise'),
|
|
|
|
Keyword: ('darkblue', 'blue'),
|
|
|
|
Keyword.Type: ('teal', 'turquoise'),
|
|
|
|
Operator.Word: ('purple', 'fuchsia'),
|
|
|
|
Name.Builtin: ('teal', 'turquoise'),
|
|
|
|
Name.Function: ('darkgreen', 'green'),
|
|
|
|
Name.Namespace: ('_teal_', '_turquoise_'),
|
|
|
|
Name.Class: ('_darkgreen_', '_green_'),
|
|
|
|
Name.Exception: ('teal', 'turquoise'),
|
|
|
|
Name.Decorator: ('darkgray', 'lightgray'),
|
|
|
|
Name.Variable: ('darkred', 'red'),
|
|
|
|
Name.Constant: ('darkred', 'red'),
|
|
|
|
Name.Attribute: ('teal', 'turquoise'),
|
|
|
|
Name.Tag: ('blue', 'blue'),
|
|
|
|
String: ('brown', 'brown'),
|
|
|
|
Number: ('darkblue', 'blue'),
|
|
|
|
|
|
|
|
Generic.Deleted: ('red', 'red'),
|
|
|
|
Generic.Inserted: ('darkgreen', 'green'),
|
|
|
|
Generic.Heading: ('**', '**'),
|
|
|
|
Generic.Subheading: ('*purple*', '*fuchsia*'),
|
2016-06-13 14:41:17 +00:00
|
|
|
Generic.Prompt: ('**', '**'),
|
2013-09-22 20:39:16 +00:00
|
|
|
Generic.Error: ('red', 'red'),
|
|
|
|
|
|
|
|
Error: ('_red_', '_red_'),
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
class TerminalFormatter(Formatter):
|
|
|
|
r"""
|
|
|
|
Format tokens with ANSI color sequences, for output in a text console.
|
|
|
|
Color sequences are terminated at newlines, so that paging the output
|
|
|
|
works correctly.
|
|
|
|
|
|
|
|
The `get_style_defs()` method doesn't do anything special since there is
|
|
|
|
no support for common styles.
|
|
|
|
|
|
|
|
Options accepted:
|
|
|
|
|
|
|
|
`bg`
|
|
|
|
Set to ``"light"`` or ``"dark"`` depending on the terminal's background
|
|
|
|
(default: ``"light"``).
|
|
|
|
|
|
|
|
`colorscheme`
|
|
|
|
A dictionary mapping token types to (lightbg, darkbg) color names or
|
|
|
|
``None`` (default: ``None`` = use builtin colorscheme).
|
2014-12-01 06:10:30 +00:00
|
|
|
|
|
|
|
`linenos`
|
|
|
|
Set to ``True`` to have line numbers on the terminal output as well
|
|
|
|
(default: ``False`` = no line numbers).
|
2013-09-22 20:39:16 +00:00
|
|
|
"""
|
|
|
|
name = 'Terminal'
|
|
|
|
aliases = ['terminal', 'console']
|
|
|
|
filenames = []
|
|
|
|
|
|
|
|
def __init__(self, **options):
|
|
|
|
Formatter.__init__(self, **options)
|
|
|
|
self.darkbg = get_choice_opt(options, 'bg',
|
|
|
|
['light', 'dark'], 'light') == 'dark'
|
|
|
|
self.colorscheme = options.get('colorscheme', None) or TERMINAL_COLORS
|
2014-12-01 06:10:30 +00:00
|
|
|
self.linenos = options.get('linenos', False)
|
|
|
|
self._lineno = 0
|
2013-09-22 20:39:16 +00:00
|
|
|
|
|
|
|
def format(self, tokensource, outfile):
|
|
|
|
# hack: if the output is a terminal and has an encoding set,
|
|
|
|
# use that to avoid unicode encode problems
|
|
|
|
if not self.encoding and hasattr(outfile, "encoding") and \
|
|
|
|
hasattr(outfile, "isatty") and outfile.isatty() and \
|
|
|
|
sys.version_info < (3,):
|
|
|
|
self.encoding = outfile.encoding
|
|
|
|
return Formatter.format(self, tokensource, outfile)
|
|
|
|
|
2014-12-01 06:10:30 +00:00
|
|
|
def _write_lineno(self, outfile):
|
|
|
|
self._lineno += 1
|
2016-06-13 14:41:17 +00:00
|
|
|
outfile.write("%s%04d: " % (self._lineno != 1 and '\n' or '', self._lineno))
|
|
|
|
|
|
|
|
def _get_color(self, ttype):
|
|
|
|
# self.colorscheme is a dict containing usually generic types, so we
|
|
|
|
# have to walk the tree of dots. The base Token type must be a key,
|
|
|
|
# even if it's empty string, as in the default above.
|
|
|
|
colors = self.colorscheme.get(ttype)
|
|
|
|
while colors is None:
|
|
|
|
ttype = ttype.parent
|
|
|
|
colors = self.colorscheme.get(ttype)
|
|
|
|
return colors[self.darkbg]
|
2014-12-01 06:10:30 +00:00
|
|
|
|
2013-09-22 20:39:16 +00:00
|
|
|
def format_unencoded(self, tokensource, outfile):
|
2014-12-01 06:10:30 +00:00
|
|
|
if self.linenos:
|
2016-06-13 14:41:17 +00:00
|
|
|
self._write_lineno(outfile)
|
2014-12-01 06:10:30 +00:00
|
|
|
|
2013-09-22 20:39:16 +00:00
|
|
|
for ttype, value in tokensource:
|
2016-06-13 14:41:17 +00:00
|
|
|
color = self._get_color(ttype)
|
|
|
|
|
|
|
|
for line in value.splitlines(True):
|
|
|
|
if color:
|
|
|
|
outfile.write(ansiformat(color, line.rstrip('\n')))
|
|
|
|
else:
|
|
|
|
outfile.write(line.rstrip('\n'))
|
|
|
|
if line.endswith('\n'):
|
|
|
|
if self.linenos:
|
|
|
|
self._write_lineno(outfile)
|
|
|
|
else:
|
|
|
|
outfile.write('\n')
|
|
|
|
|
|
|
|
if self.linenos:
|
|
|
|
outfile.write("\n")
|