| Current File : //lib/python3.9/site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-39.pyc |
a
[��f+ � @ s� U d Z ddlZddlZddlmZmZmZmZmZ ddl m
Z
ddl m Z
dZG dd� de�Zdaeed < deeef ee eeee ee dd
�d d �Zdd
�dd�Zddd�eee ee ee ee dd�dd�ZdS )zN
A module that implements tooling to enable easy warnings about deprecations.
� N)�Any�Optional�TextIO�Type�Union)�parse)� __version__z
DEPRECATION: c @ s e Zd ZdS )�PipDeprecationWarningN)�__name__�
__module__� __qualname__� r
r
�C/usr/lib/python3.9/site-packages/pip/_internal/utils/deprecation.pyr s r �_original_showwarning)�message�category�filename�lineno�file�line�returnc C sZ |d ur$t d urVt | |||||� n2t|t�rDt�d�}|�| � nt | |||||� d S )Nzpip._internal.deprecations)r �
issubclassr �loggingZ getLoggerZwarning)r r r r r r �loggerr
r
r � _showwarning s
r )r c C s( t jdtdd� td u r$t jatt _d S )N�defaultT)�append)�warnings� simplefilterr r � showwarningr r
r
r
r �install_warning_logger, s r )� feature_flag�issue)�reason� replacement�gone_inr! r" r c C s� |duot t�t |�k}| t� d�f||s.dndf|df||sBdndf|dfg}d�d d
� |D ��}|rpt|��tj|td 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 s s, | ]$\}}|d ur|d ur|� |�V qd S )N)�format)�.0�valueZ
format_strr
r
r � <genexpr>n s �z deprecated.<locals>.<genexpr>� )r �
stacklevel)r �current_version�DEPRECATION_MSG_PREFIX�joinr r �warn)r# r$ r% r! r" Zis_goneZ
message_partsr r
r
r �
deprecated7 s2 �������
�r1 )NN)�__doc__r r �typingr r r r r Z pip._vendor.packaging.versionr Zpipr r- r. �Warningr r �__annotations__�str�intr r r1 r
r
r
r �<module> s< �
� ��