Admin

name	type	size	perms	modified	actions
[parent directory]
__pycache__/	dir	-	0755	2026-08-19 08:39:33
filters/	dir	-	0755	2026-08-19 08:39:33
formatters/	dir	-	0755	2026-08-19 08:39:33
lexers/	dir	-	0755	2026-08-19 08:39:33
styles/	dir	-	0755	2026-08-19 08:39:33
__init__.py	file	2,983 B	0644	2026-07-20 00:00:00	edit
__main__.py	file	353 B	0644	2026-07-20 00:00:00	edit
console.py	file	1,718 B	0644	2026-07-20 00:00:00	edit
filter.py	file	1,910 B	0644	2026-07-20 00:00:00	edit
formatter.py	file	4,390 B	0644	2026-07-20 00:00:00	edit
lexer.py	file	35,349 B	0644	2026-07-20 00:00:00	edit
LICENSE	file	1,331 B	0644	2026-07-20 00:00:00	edit
modeline.py	file	1,005 B	0644	2026-07-20 00:00:00	edit
plugin.py	file	1,891 B	0644	2026-07-20 00:00:00	edit
regexopt.py	file	3,072 B	0644	2026-07-20 00:00:00	edit
scanner.py	file	3,092 B	0644	2026-07-20 00:00:00	edit
sphinxext.py	file	7,981 B	0644	2026-07-20 00:00:00	edit
style.py	file	6,420 B	0644	2026-07-20 00:00:00	edit
token.py	file	6,226 B	0644	2026-07-20 00:00:00	edit
unistring.py	file	63,208 B	0644	2026-07-20 00:00:00	edit
util.py	file	10,031 B	0644	2026-07-20 00:00:00	edit

editing: init.py

"""
    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-2025 by the Pygments team, see AUTHORS.
    :license: BSD, see LICENSE for details.
"""
from io import StringIO, BytesIO

__version__ = '2.19.2'
__docformat__ = 'restructuredtext'

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

def lex(code, lexer):
    """
    Lex `code` with the `lexer` (must be a `Lexer` instance)
    and return an iterable of tokens. Currently, this only calls
    `lexer.get_tokens()`.
    """
    try:
        return lexer.get_tokens(code)
    except TypeError:
        # Heuristic to catch a common mistake.
        from pip._vendor.pygments.lexer import RegexLexer
        if isinstance(lexer, type) and issubclass(lexer, RegexLexer):
            raise TypeError('lex() argument must be a lexer instance, '
                            'not a class')
        raise

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

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:
        # Heuristic to catch a common mistake.
        from pip._vendor.pygments.formatter import Formatter
        if isinstance(formatter, type) and issubclass(formatter, Formatter):
            raise TypeError('format() argument must be a formatter instance, '
                            'not a class')
        raise

def highlight(code, lexer, formatter, outfile=None):
    """
    This is the most high-level highlighting function. It combines `lex` and
    `format` in one function.
    """
    return format(lex(code, lexer), formatter, outfile)

cancel

Admin

editing: __init__.py

editing: init.py