"""
pygments.formatters.html
~~~~~~~~~~~~~~~~~~~~~~~~
Formatter for HTML output.
:copyright: Copyright 2006-2023 by the Pygments team, see AUTHORS.
:license: BSD, see LICENSE for details.
"""
import functools
import os
import sys
import os.path
from io import StringIO
from pipenv.patched.pip._vendor.pygments.formatter import Formatter
from pipenv.patched.pip._vendor.pygments.token import Token, Text, STANDARD_TYPES
from pipenv.patched.pip._vendor.pygments.util import get_bool_opt, get_int_opt, get_list_opt
try:
import ctags
except ImportError:
ctags = None
__all__ = ['HtmlFormatter']
_escape_html_table = {
ord('&'): '&',
ord('<'): '<',
ord('>'): '>',
ord('"'): '"',
ord("'"): ''',
}
def escape_html(text, table=_escape_html_table):
"""Escape &, <, > as well as single and double quotes for HTML."""
return text.translate(table)
def webify(color):
if color.startswith('calc') or color.startswith('var'):
return color
else:
return '#' + color
def _get_ttype_class(ttype):
fname = STANDARD_TYPES.get(ttype)
if fname:
return fname
aname = ''
while fname is None:
aname = '-' + ttype[-1] + aname
ttype = ttype.parent
fname = STANDARD_TYPES.get(ttype)
return fname + aname
CSSFILE_TEMPLATE = '''\
/*
generated by Pygments
Copyright 2006-2023 by the Pygments team.
Licensed under the BSD license, see LICENSE for details.
*/
%(styledefs)s
'''
DOC_HEADER = '''\
%(title)s
%(title)s
'''
DOC_HEADER_EXTERNALCSS = '''\
%(title)s
%(title)s
'''
DOC_FOOTER = '''\
'''
class HtmlFormatter(Formatter):
r"""
Format tokens as HTML 4 ```` tags. By default, the content is enclosed
in a ``
`` tag, itself wrapped in a ``
`` tag (but see the `nowrap` option).
The ``
``'s CSS class can be set by the `cssclass` option.
If the `linenos` option is set to ``"table"``, the ``
`` is
additionally wrapped inside a ``
`` which has one row and two
cells: one containing the line numbers and one containing the code.
Example:
.. sourcecode:: html
1
2
def foo(bar):
pass
(whitespace added to improve clarity).
A list of lines can be specified using the `hl_lines` option to make these
lines highlighted (as of Pygments 0.11).
With the `full` option, a complete HTML 4 document is output, including
the style definitions inside a ``