�

��h+��
�UdZd
dl
Z
d
dlZd
dlmZmZmZmZmZ
d
dl	m
Z

d
dlmZ

dZGd�de�Zdaeed	<		dd
eeefdeeded
edeedeeddfd�Zdd�Zddd�dedeedeedeedeeddfd�Zy)zN
A module that implements tooling to enable easy warnings about deprecations.
�N)�Any�Optional�TextIO�Type�Union)
�parse)
�__version__z
DEPRECATION: c
��eZ
dZy
)�PipDeprecationWarningN)�__name__�
__module__�__qualname__���A/usr/lib/python3/dist-packages/pip/_internal/utils/deprecation.pyrrs��rr�_original_showwarning�message�category�filename�lineno�file�line�returnc���|�t�t
||
||||�
yyt|
t�r'tjd
�
}|j|�

yt
||
||||�
y)Nzpip._internal.deprecations)r�
issubclassr�logging�	getLogger�warning)rrrrrr�loggers       r�_showwarningr sc���� �,�!�'�8�X�v�t�T�R�-�	�H�3�	4��"�"�#?�@�����w���g�x��6�4��Nrc��t
jd
td��
t� tjat
t_yy)N�defaultT)
�append)�warnings�simplefilterrr�showwarningr rrr�install_warning_loggerr',s6�����)�%:�4�H��$� (� 4� 4��+���%r)�feature_flag�issue�reason�replacement�gone_inr(r)c�
�|d
u
x
r
t
t�
t
|�
k\}|t�d�f||sdn
df|
df||sdn
d
f|dfg}djd	�|D��
}|rt	|�
�
tj|td
��
y
)aHelper 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.zA 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�LK
�|]\}
}|�|
�|j
|
�
�
�

�y�w
)
N)
�format)�.0�value�
format_strs   r�	<genexpr>zdeprecated.<locals>.<genexpr>ns2������E�:��!�e�&7�	���%� ��s�"$
�)r�
stacklevel)r�current_version�DEPRECATION_MSG_PREFIX�joinrr$�warn)r*r+r,r(r)�is_gone�
message_partsrs        r�
deprecatedr=7s���:�T�!�N�e�O�&<��g��&N�G�
�*�+�4�0�1���
9�=�		
�
�+�	
�

��
T
��		
�
�N�	
�%�M�0�h�h��!.���G��#�G�,�,��M�M�'�$9�a�Hr)NN)rN)�__doc__rr$�typingrrrrr�pip._vendor.packaging.versionr�pipr	r7r8�Warningrr�__annotations__�str�intr r'r=rrr�<module>rF
s
�


�
�
��5�5�/�.�(��

	�G�

	�"��s�!�"��

O
�
�7�C�<�
 �
O
��7�m�
O
��
O
�
�	
O
�
�6�
�
O
��3�-�

O
�
�
O
�(
,� #'��
A

I
��A

I
��#��A

I
��c�]�	A

I
�
�3�-�A

I
��C�=�
A

I
�
�A

I
r