
    Whp                        U d Z ddlmZ ddlZddlZddlmZmZ ddlm	Z	 ddl
mZ dZ G d d	e          Zdad
ed<   	 	 d$d%dZd&dZdddd'd#ZdS )(zN
A module that implements tooling to enable easy warnings about deprecations.
    )annotationsN)AnyTextIO)parse)__version__zDEPRECATION: c                      e Zd ZdS )PipDeprecationWarningN)__name__
__module____qualname__     q/var/www/tools.fuzzalab.pt/emblema-extractor/venv/lib/python3.11/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 )Nzpip._internal.deprecations)r   
issubclassr	   logging	getLoggerwarning)r   r   r   r   r   r   loggers          r   _showwarningr%      s      ,!'8XvtTRRRRR -,	H3	4	4 O "#?@@wgx64NNNNNr   c                     t          j        dt          d           t          t           j        at
          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.   
int | Nonec                2   |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                       }|rt	          |          t          j        |t          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              3  N   K   | ] \  }}||	|                     |          V  !d S )N)format).0value
format_strs      r   	<genexpr>zdeprecated.<locals>.<genexpr>t   sK        E:!e&7 	%  &7&7&7&7 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!NeO&<&<g&NG 
*0001 B<<A	
 +	

  WW	
 N	
-M8 hh  !.    G  -#G,,,M'$9a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(, , , ,   $EI EI EI EI EI EI EI EIr   