
    Qhp                        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y)zN
A module that implements tooling to enable easy warnings about deprecations.
    )annotationsN)AnyTextIO)parse)__version__zDEPRECATION: c                      e Zd Zy)PipDeprecationWarningN)__name__
__module____qualname__     [/var/www/teggl/fontify/venv/lib/python3.12/site-packages/pip/_internal/utils/deprecation.pyr	   r	      s    r   r	   r   _original_showwarningc                    |t         t        | |||||       y y t        |t              r't        j                  d      }|j                  |        y t        | |||||       y )Nzpip._internal.deprecations)r   
issubclassr	   logging	getLoggerwarning)messagecategoryfilenamelinenofilelineloggers          r   _showwarningr      sc      ,!'8XvtTR -	H3	4 ""#?@wgx64Nr   c                     t        j                  dt        d       t         t         j                  at
        t         _        y y )NdefaultT)append)warningssimplefilterr	   r   showwarningr   r   r   r   install_warning_loggerr$   .   s6    )%:4H $ ( 4 4+ %r   )feature_flagissuec                   |duxr t        t              t        |      k\  }| t         df||sdndf|df||sdndf|dfg}dj                  d	 |D              }|rt	        |      t        j                  |t        d
       y)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  L   K   | ]  \  }}|||j                  |        y w)N)format).0value
format_strs      r   	<genexpr>zdeprecated.<locals>.<genexpr>t   s2      E:!e&7 	% s   "$   )r   
stacklevel)r   current_versionDEPRECATION_MSG_PREFIXjoinr	   r!   warn)reasonreplacementgone_inr%   r&   is_gonemessage_partsr   s           r   
deprecatedr:   9   s    : T!NeO&<g&NG 
*+401  =A	
 +	

   X	
 N	
-M8 hh !. G #G,,MM'$9aHr   )NN)r   zWarning | strr   ztype[Warning]r   strr   intr   zTextIO | Noner   
str | NonereturnNone)r>   r?   )r5   r;   r6   r=   r7   r=   r%   r=   r&   z
int | Noner>   r?   )__doc__
__future__r   r   r!   typingr   r   pip._vendor.packaging.versionr   pipr   r1   r2   Warningr	   r   __annotations__r   r$   r:   r   r   r   <module>rG      s    #    / .( 	G 	 " s ! OOO O 	O
 O O 
O(,   $EIEI EI 	EI
 EI EI 
EIr   