File: D:/Python311/Lib/site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-311.pyc
�
�mip � � � U d Z ddlmZ ddlZddlZddlmZmZ ddlm Z ddl
m Z dZ
G d� d e� � Zdad
ed < d$d%d�Zd&d�Zddd �d'd#�ZdS )(zN
A module that implements tooling to enable easy warnings about deprecations.
� )� annotationsN)�Any�TextIO)�parse)� __version__z
DEPRECATION: c � � e Zd ZdS )�PipDeprecationWarningN)�__name__�
__module__� __qualname__� � �AD:\Python311\Lib\site-packages\pip/_internal/utils/deprecation.pyr r s � � � � � ��Dr r r �_original_showwarning�message�
Warning | str�category�
type[Warning]�filename�str�lineno�int�file�
TextIO | None�line�
str | None�return�Nonec �� � |� 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� � � � O� � S� !�'�8�X�v�t�T� R� R� R� R� R� S� S� �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, . sF � � ��)�%:�4�H�H�H�H� � ,� (� 4� � +�� � � �,� ,r )� feature_flag�issue�reason� replacement�gone_inr- r. �
int | Nonec �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 � <genexpr>z deprecated.<locals>.<genexpr>t sX � � � � � � �E�:� �� ',�����%� � �� � � � � r � )r �
stacklevel)r �current_version�DEPRECATION_MSG_PREFIX�joinr r) �warn)r/ r0 r1 r- r. �is_gone�
message_partsr s r �
deprecatedrC 9 s� � �: �T�!�N�e�O�&<�&<��g���&N�G�
�*�0�0�0�1� � �B�<�<�A�
�
� +�
�
� ��W�W��
�
� N�
�-�M�8 �h�h� � �!.�� � � � �G� � -�#�G�,�,�,� �M�'�$9�a�H�H�H�H�H�Hr )NN)r r r r r r r r r r r r r r )r r ) r/ r r0 r r1 r r- r r. r2 r r )�__doc__�
__future__r r! r) �typingr r � pip._vendor.packaging.versionr �pipr r= r> �Warningr r �__annotations__r% r, rC r
r r �<module>rK s4 ��� � � #� "� "� "� "� "� ���� ���� � � � � � � � � /� /� /� /� /� /� .� .� .� .� .� .�(� � � � � � �G� � � � "� � !� !� !� !� ��
O� O� O� O� O�(,� ,� ,� ,� $� �
EI� EI� EI� EI� EI� EI� EI� EIr