+
    <j{                        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                       ] tR t^tRtR# )PipDeprecationWarning N)__name__
__module____qualname____firstlineno____static_attributes__r       T/opt/headortail/venv/lib/python3.14/site-packages/pip/_internal/utils/deprecation.pyr
   r
      s    r   r
   c                    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   )formats   "r   __annotate__r       sm     O O7C< O7mO O 	O
 6
O 3-O 
Or   c                     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_showwarning
issubclassr
   logging	getLoggerwarning)r   r   r   r   r   r   loggers   &&&&&& r   _showwarningr(      sZ      ,!'XtR -	H3	4	4 ""#?@wg4Nr   c                    V ^8  d   QhRR/# )r   r   Nr   )r   s   "r   r    r    ,   s     , , ,r   c                      \         P                  ! R \        RR7       \        f"   \         P                  s\
        \         n        R# R# )defaultT)appendN)warningssimplefilterr
   r"   showwarningr(   r   r   r   install_warning_loggerr0   ,   s6    )%:4H $ ( 4 4+ %r   feature_flagissuec                    V ^8  d   QhR\         R\        \         ,          R\        \         ,          R\        \         ,          R\        \        ,          RR/# )r   reasonreplacementgone_inr1   r2   r   N)r   r   r   )r   s   "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                <   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/{} c              3   `   "   T F$  w  rVf   K  Vf   K  VP                  V4      x  K&  	  R # 5i)N)r   ).0value
format_strs   &  r   	<genexpr>deprecated.<locals>.<genexpr>r   s5      !.E 	!&+ 	!
%  !.s   ...)r   
stacklevel)r   current_versionDEPRECATION_MSG_PREFIXjoinr
   r-   warn)r4   r5   r6   r1   r2   is_gonemessage_partsr   s   $$$$$   r   
deprecatedrF   7   s    : T!NNeO&<g&NG 
*+401  =A	
 +	

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