o
    Ëý°j+  ã                   @   sò   U d Z ddlZddlZddlmZmZmZmZmZ ddl	m
Z
 ddlmZ dZG dd„ deƒZdaeed	< 		dd
eeef dee dededee dee ddfdd„Zddd„Zdddœdedee dee dee dee ddfdd„ZdS )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 Zd ZdS )ÚPipDeprecationWarningN)Ú__name__Ú
__module__Ú__qualname__© r   r   ú’/root/aizidognhua/tmp/workspace/projects/ec89d86c-575f-41c9-af57-ac45cbdbf775/venv/lib/python3.10/site-packages/pip/_internal/utils/deprecation.pyr	      s    r	   Ú_original_showwarningÚmessageÚcategoryÚfilenameÚlinenoÚfileÚlineÚreturnc                 C   sb   |d urt d urt | |||||ƒ d S d S t|tƒr&t d¡}| | ¡ d S t | |||||ƒ d S )Nzpip._internal.deprecations)r   Ú
issubclassr	   ÚloggingÚ	getLoggerÚwarning)r   r   r   r   r   r   Úloggerr   r   r   Ú_showwarning   s   ÿ

r   c                   C   s,   t jdtdd� td u rt jatt _d S 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$   c                 C   s„   |duot tƒt |ƒk}| t› d�f||sdndf|df||s!dndf|dfg}d d	d
„ |D ƒ¡}|r8t|ƒ‚tj|tdd� dS )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 ur|d ur|  |¡V  qd S )N)Úformat)Ú.0ÚvalueÚ
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$   Úis_goneÚmessage_partsr   r   r   r   Ú
deprecated7   s2   ÿüþÿüþî
þr6   )NN)r   N)Ú__doc__r   r   Útypingr   r   r   r   r   Úpip._vendor.packaging.versionr   Úpipr   r0   r1   ÚWarningr	   r   Ú__annotations__ÚstrÚintr   r"   r6   r   r   r   r   Ú<module>   sT    	ú
ÿþýüûú
ù
úþýüûúù