Gecko [ tsuru-no-tsurugi.tokyo ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2024-11-28 06:27
filters	[ DIR ]	drwxr-xr-x	2024-11-28 06:27
formatters	[ DIR ]	drwxr-xr-x	2024-11-28 06:27
lexers	[ DIR ]	drwxr-xr-x	2024-11-28 06:27
styles	[ DIR ]	drwxr-xr-x	2024-11-28 06:27
__init__.py	2.93 KB	-rw-r--r--	2022-01-06 20:12
__main__.py	348 B	-rw-r--r--	2022-01-06 20:12
cmdline.py	22.71 KB	-rw-r--r--	2022-01-06 20:12
console.py	1.66 KB	-rw-r--r--	2022-01-06 20:12
filter.py	1.89 KB	-rw-r--r--	2022-01-06 20:12
formatter.py	2.83 KB	-rw-r--r--	2022-01-06 20:12
lexer.py	31.11 KB	-rw-r--r--	2022-01-06 20:12
modeline.py	986 B	-rw-r--r--	2022-01-06 20:12
plugin.py	1.67 KB	-rw-r--r--	2022-01-06 20:12
regexopt.py	3 KB	-rw-r--r--	2022-01-06 20:12
scanner.py	3.02 KB	-rw-r--r--	2022-01-06 20:12
sphinxext.py	4.49 KB	-rw-r--r--	2022-01-06 20:12
style.py	6.1 KB	-rw-r--r--	2022-01-06 20:12
token.py	6 KB	-rw-r--r--	2022-01-06 20:12
unistring.py	61.71 KB	-rw-r--r--	2022-01-06 20:12
util.py	8.91 KB	-rw-r--r--	2022-01-06 20:12

Rename

"""
    Pygments
    ~~~~~~~~

Pygments is a syntax highlighting package written in Python.

It is a generic syntax highlighter for general use in all kinds of software
    such as forum systems, wikis or other applications that need to prettify
    source code. Highlights are:

* a wide range of common languages and markup formats is supported
    * special attention is paid to details, increasing quality by a fair amount
    * support for new languages and formats are added easily
    * a number of output formats, presently HTML, LaTeX, RTF, SVG, all image
      formats that PIL supports, and ANSI sequences
    * it is usable as a command-line tool and as a library
    * ... and it highlights even Brainfuck!

The `Pygments master branch`_ is installable with ``easy_install Pygments==dev``.

.. _Pygments master branch:
       https://github.com/pygments/pygments/archive/master.zip#egg=Pygments-dev

:copyright: Copyright 2006-2021 by the Pygments team, see AUTHORS.
    :license: BSD, see LICENSE for details.
"""
from io import StringIO, BytesIO

__version__ = '2.11.2'
__docformat__ = 'restructuredtext'

__all__ = ['lex', 'format', 'highlight']

def lex(code, lexer):
    """
    Lex ``code`` with ``lexer`` and return an iterable of tokens.
    """
    try:
        return lexer.get_tokens(code)
    except TypeError as err:
        if (isinstance(err.args[0], str) and
            ('unbound method get_tokens' in err.args[0] or
             'missing 1 required positional argument' in err.args[0])):
            raise TypeError('lex() argument must be a lexer instance, '
                            'not a class')
        raise

def format(tokens, formatter, outfile=None):  # pylint: disable=redefined-builtin
    """
    Format a tokenlist ``tokens`` with the formatter ``formatter``.

If ``outfile`` is given and a valid file object (an object
    with a ``write`` method), the result will be written to it, otherwise
    it is returned as a string.
    """
    try:
        if not outfile:
            realoutfile = getattr(formatter, 'encoding', None) and BytesIO() or StringIO()
            formatter.format(tokens, realoutfile)
            return realoutfile.getvalue()
        else:
            formatter.format(tokens, outfile)
    except TypeError as err:
        if (isinstance(err.args[0], str) and
            ('unbound method format' in err.args[0] or
             'missing 1 required positional argument' in err.args[0])):
            raise TypeError('format() argument must be a formatter instance, '
                            'not a class')
        raise

def highlight(code, lexer, formatter, outfile=None):
    """
    Lex ``code`` with ``lexer`` and format it with the formatter ``formatter``.

If ``outfile`` is given and a valid file object (an object
    with a ``write`` method), the result will be written to it, otherwise
    it is returned as a string.
    """
    return format(lex(code, lexer), formatter, outfile)