�
��^i+ � �< � U d Z ddlZddlZddlmZmZmZmZmZ ddl m
Z
ddl m Z
dZ G d� de� � Zdaeed < dd
eeef d ee d ed
edee dee ddfd�Zdd�Zddd�dedee dee dee dee ddf d�ZdS ) zN
A module that implements tooling to enable easy warnings about deprecations.
� N)�Any�Optional�TextIO�Type�Union)�parse)� __version__z
DEPRECATION: c � � e Zd ZdS )�PipDeprecationWarningN)�__name__�
__module__� __qualname__� � ��/builddir/build/BUILDROOT/alt-python311-pip-21.3.1-4.el8.x86_64/opt/alt/python311/lib/python3.11/site-packages/pip/_internal/utils/deprecation.pyr r s � � � � � ��Dr r �_original_showwarning�message�category�filename�lineno�file�line�returnc �� � |� t �t | |||||� � d S d S t |t � � r+t j d� � }|� | � � d S t | |||||� � d S )Nzpip._internal.deprecations)r �
issubclassr �logging� getLogger�warning)r r r r r r �loggers r � _showwarningr s� � � �� � ,� !�'�8�X�v�t�T� R� R� R� R� R� -� ,� �H� 3� 4� 4� O� �"�#?�@�@�����w� � � � � � �g�x��6�4��N�N�N�N�Nr c � � t j dt d�� � t � t j at
t _ d S d S )N�defaultT)�append)�warnings� simplefilterr r � showwarningr r r r �install_warning_loggerr' , sB � � ��)�%:�4�H�H�H�H� �$� (� 4� � +�� � � � %�$r )� feature_flag�issue�reason� replacement�gone_inr( r) c �2 � |duo$t t � � t |� � k }| t � d�f||sdndf|df||sdndf|dfg}d� d � |D � � � � }|rt |� � �t j |t d
� � � dS ) a Helper to deprecate existing functionality.
reason:
Textual reason shown to the user about why this functionality has
been deprecated. Should be a complete sentence.
replacement:
Textual suggestion shown to the user about what alternative
functionality they can use.
gone_in:
The version of pip does this functionality should get removed in.
Raises an error if pip's current version is greater than or equal to
this.
feature_flag:
Command-line flag of the form --use-feature={feature_flag} for testing
upcoming functionality.
issue:
Issue number on the tracker that would serve as a useful place for
users to find related discussion and provide feedback.
Nz{}z*pip {} will enforce this behaviour change.z*Since pip {}, this is no longer supported.z A possible replacement is {}.zEYou can use the flag --use-feature={} to test the upcoming behaviour.z@Discussion can be found at https://github.com/pypa/pip/issues/{}� c 3 �N K � | ] \ }}|�|� |� |� � V � �!d S )N)�format)�.0�value�
format_strs r � z deprecated..n sK � � � � � � �E�:� � !�e�&7� ���%� � �&7�&7�&7�&7�� r � )r �
stacklevel)r �current_version�DEPRECATION_MSG_PREFIX�joinr r$ �warn)r* r+ r, r( r) �is_gone�
message_partsr s r �
deprecatedr= 7 s� � �: �T�!�N�e�O�&<�&<��g���&N�G�
�*�0�0�0�1� ��
>� 8� 8�=�
�
� +�
�
��
� S� S��
�
� N�
�%�M�0 �h�h� � �!.�� � � � �G� � -�#�G�,�,�,� �M�'�$9�a�H�H�H�H�H�Hr )NN)r N)�__doc__r r$ �typingr r r r r � pip._vendor.packaging.versionr �pipr r7 r8 �Warningr r �__annotations__�str�intr r' r= r r r �rF s� ��� � � ���� ���� 5� 5� 5� 5� 5� 5� 5� 5� 5� 5� 5� 5� 5� 5� /� /� /� /� /� /� .� .� .� .� .� .�(� � � � � � �G� � � � "� �s� !� !� !� "� �
O� O�
�7�C�<�
�O��7�m�O� �O�
� O�
�6�
� O� �3�-�
O�
�O� O� O� O�(,� ,� ,� ,� #'� �
AI� AI� AI� �AI� �#� �AI� �c�]� AI�
�3�-� AI� �C�=�
AI�
�AI� AI� AI� AI� AI� AIr