+
     h{  c                   s   a  R t0 t R t^ RIt^ RIt^ RIHtHtHtHtH	t	 ^ RI
Ht ^ RIHt Rt ! R R]4      tRs] ^ k RR R	 lltR
 R ltRRRR/R R lltR# )zN
A module that implements tooling to enable easy warnings about deprecations.
N)AnyOptionalTextIOTypeUnion)parse)__version__zDEPRECATION: c                   s    ] tR t^tRtR# )PipDeprecationWarning N)Z__name__Z
__module__Z__qualname__Z__firstlineno__Z__static_attributes__r       D/usr/lib/python3.14/site-packages/pip/_internal/utils/deprecation.pyr   r      s    r	   r   c                s    V ^8  d   QhR\         \        \        3,          R\        \        ,          R\        R\        R\
        \        ,          R\
        \        ,          RR/# )	   messagecategoryfilenamelinenofilelinereturnN)r   Warningstrr   intr   r   Zformat   "r
   __annotate__r      sm     O O7C< O7mO O 	O
 6
O 3-O 
Or	   c                 s    Ve   \         e   \        WW#WE4       R # R # \        V\        4      '       d*   \        P                  ! R4      pVP                  V 4       R # \        WW#WE4       R # )Nzpip._internal.deprecations)_original_showwarningZ
issubclassr   loggingZ	getLoggerZwarning)r   r   r   r   r   r   Zloggers   &&&&&& r
   _showwarningr      sZ      ,!'XtR -	H3	4	4 ""#?@wg4Nr	   c                s    V ^8  d   QhRR/# )r   r   Nr   r   r   r
   r   r   ,   s     , , ,r	   c                  s    \         P                  ! R \        RR7       \        f"   \         P                  s\
        \         n        R# R# )ZdefaultT)ZappendN)warningsZsimplefilterr   r   Zshowwarningr   r   r	   r
   install_warning_loggerr   ,   s6    )%:4H $ ( 4 4+ %r	   feature_flagissuec                s    V ^8  d   QhR\         R\        \         ,          R\        \         ,          R\        \         ,          R\        \        ,          RR/# )r   reasonreplacementgone_inr   r   r   N)r   r   r   r   r   r
   r   r   7   sf     EI EIEI #EI c]	EI
 3-EI C=EI 
EIr	   c                s<   VRJ;'       d    \        \        4      \        V4      8  pV \         R23TV'       g   RMR3VR3TV'       g   RMR3VR3.pRP                  R	 V 4       4      pV'       d   \	        V4      h\
        P                  ! V\        ^R
7       R# )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/{}Z c              3   s`   "   T F$  w  rVf   K  Vf   K  VP                  V4      x  K&  	  R # 5i)Nr   )Z.0ZvalueZ
format_strs   &  r
   Z	<genexpr>Zdeprecated.<locals>.<genexpr>r   s5      !.E 	!&+ 	!
%  !.s   ...)r   Z
stacklevel)r   current_versionDEPRECATION_MSG_PREFIXZjoinr   r   Zwarn)r    r!   r"   r   r   Zis_goneZmessage_partsr   s   $$$$$   r
   
deprecatedr%   7   s    : T!NNeO&<g&NG 
*+401  =A	
 +	

   X	
 N	
-M8 hh !. G #G,,MM'$9aHr	   c                s@    V ^8  d   Qh/ ^ \         9   d
   \        ;R&   # )r   r   )__conditional_annotations__r    r   r   r
   r   r      s      & " !s !'r	   )NN)r&   Z__doc__r   r   Ztypingr    r   r   r   r   Zpip._vendor.packaging.versionr   Zpipr   r#   r$   r   r   r   r   r   r%   r   )r&   s   @r
   <module>r'      sm      5 5 / .( 	G 	 "  !O(,EI
 #'EI  EI EIr	   