File: D:/Python311/Lib/site-packages/pip/_vendor/pygments/__pycache__/formatter.cpython-311.pyc
�
�mi& � �P � d Z ddlZddlmZ ddlmZ dgZd� Z G d� d� � ZdS )z�
pygments.formatter
~~~~~~~~~~~~~~~~~~
Base formatter class.
:copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)� get_bool_opt)�get_style_by_name� Formatterc �N � t | t � � rt | � � S | S �N)�
isinstance�strr )�styles �@D:\Python311\Lib\site-packages\pip/_vendor/pygments/formatter.py�
_lookup_styler s' � ��%�� � � (� ��'�'�'� �L� c �< � e Zd ZdZdZg Zg ZdZd� Zd d�Z d� Z
d� Z dS )
r a
Converts a token stream to text.
Formatters should have attributes to help selecting them. These
are similar to the corresponding :class:`~pygments.lexer.Lexer`
attributes.
.. autoattribute:: name
:no-value:
.. autoattribute:: aliases
:no-value:
.. autoattribute:: filenames
:no-value:
You can pass options as keyword arguments to the constructor.
All formatters accept these basic options:
``style``
The style to use, can be a string or a Style subclass
(default: "default"). Not used by e.g. the
TerminalFormatter.
``full``
Tells the formatter to output a "full" document, i.e.
a complete self-contained document. This doesn't have
any effect for some formatters (default: false).
``title``
If ``full`` is true, the title that should be used to
caption the document (default: '').
``encoding``
If given, must be an encoding name. This will be used to
convert the Unicode token strings to byte strings in the
output. If it is "" or None, Unicode strings will be written
to the output file, which most file-like objects do not
support (default: None).
``outencoding``
Overrides ``encoding`` if given.
NTc �b � t |� dd� � � � | _ t |dd� � | _ |� dd� � | _ |� dd� � pd| _ | j d v rd
| _ |� d � � p| j | _ || _ dS ) z�
As with lexers, this constructor takes arbitrary optional arguments,
and if you override it, you should first process your own options, then
call the base class implementation.
r
�default�fullF�title� �encodingN)�guess�chardetzutf-8� outencoding)r �getr
r r r r �options)�selfr s r �__init__zFormatter.__init__S s� � � #�7�;�;�w� �#B�#B�C�C��
� ��&�%�8�8�� � �[�[��"�-�-��
� � � �J��5�5�=���
� �=� 0� 0� $� #�D�M� � � �M�2�2�C�d�m��
� �� � � r
r c � � dS )a
This method must return statements or declarations suitable to define
the current style for subsequent highlighted text (e.g. CSS classes
in the `HTMLFormatter`).
The optional argument `arg` can be used to modify the generation and
is formatter dependent (it is standardized because it can be given on
the command line).
This method is called by the ``-S`` :doc:`command-line option <cmdline>`,
the `arg` is then given by the ``-a`` option.
r � )r �args r �get_style_defszFormatter.get_style_defsc s � � �rr
c � � | j r( t j | j � � d |� � }| � ||� � S )z�
This method must format the tokens from the `tokensource` iterable and
write the formatted version to the file object `outfile`.
Formatter options can control how exactly the tokens are converted.
� )r �codecs�lookup�format_unencoded)r � tokensource�outfiles r �formatzFormatter.formatr sD � � �=� ?�5�f�m�D�M�2�2�1�5�g�>�>�G��$�$�[�'�:�:�:r
c � � | S r r )�cls�names r �__class_getitem__zFormatter.__class_getitem__� s � ��
r
)r ) �__name__�
__module__� __qualname__�__doc__r* �aliases� filenames�
unicodeoutputr r r' r+ r r
r r r s| � � � � � �'� '�T �D� �G�
�I� �M� � � �
�
�
�
�
;�
;�
;� � � � � r
) r/ r" �pip._vendor.pygments.utilr �pip._vendor.pygments.stylesr �__all__r r r r
r �<module>r6 s� ��� � �
�
�
� 2� 2� 2� 2� 2� 2� 9� 9� 9� 9� 9� 9� �-��� � � h� h� h� h� h� h� h� h� h� hr