
    4Քhp                        % S r SSKJr  SSKrSSKrSSKJrJr  SSKJ	r	  SSK
Jr  Sr " S S	\5      rSqS
\S'     S             SS jjrSS jrSSS.           SS jjrg)zN
A module that implements tooling to enable easy warnings about deprecations.
    )annotationsN)AnyTextIO)parse)__version__zDEPRECATION: c                      \ rS rSrSrg)PipDeprecationWarning    N)__name__
__module____qualname____firstlineno____static_attributes__r       W/var/www/auris/envauris/lib/python3.13/site-packages/pip/_internal/utils/deprecation.pyr	   r	      s    r   r	   r   _original_showwarningc                    Ub  [         b  [        XX#XE5        g g [        U[        5      (       a(  [        R                  " S5      nUR                  U 5        g [        XX#XE5        g )Nzpip._internal.deprecations)r   
issubclassr	   logging	getLoggerwarning)messagecategoryfilenamelinenofilelineloggers          r   _showwarningr       sZ      ,!'XtR -	H3	4	4 ""#?@wg4Nr   c                     [         R                  " S[        SS9  [        c   [         R                  q[
        [         l        g g )NdefaultT)append)warningssimplefilterr	   r   showwarningr    r   r   r   install_warning_loggerr'   .   s6    )%:4H $ ( 4 4+ %r   )feature_flagissuec                ,   USL=(       a    [        [        5      [        U5      :  nU [         S34UU(       d  SOS4US4UU(       d  SOS4US4/nSR                  S	 U 5       5      nU(       a  [	        U5      e[
        R                  " U[        S
S9  g)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  \   #    U  H"  u  pUc  M
  Uc  M  UR                  U5      v   M$     g 7f)N)format).0value
format_strs      r   	<genexpr>deprecated.<locals>.<genexpr>t   s5      !.E 	!&+ 	!
%  !.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)rB   rC   )r9   r?   r:   rA   r;   rA   r(   rA   r)   z
int | NonerB   rC   )__doc__
__future__r   r   r$   typingr   r   pip._vendor.packaging.versionr   pipr   r5   r6   Warningr	   r   __annotations__r    r'   r>   r   r   r   <module>rK      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   