ó
    ¢'Ôip  ã                  óÖ   • % 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   ó    Ú^/var/www/surfInsights/venv3-11/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   € ð ÑÜ Ñ,Ü! '°XÀtÕ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Ð!×N¤e¬OÓ&<ÄÀgÃÑ&N€Gð 
Ô*Ð+¨4Ð0Ð1àö ñ =àAð	
ð Ø+ð	
ð
 ö ñ Xàð	
ð ØNð	
ð-€Mð8 �h‰hñ á!.óó €Gö Ü# GÓ,Ð,ä‡M‚M�'Ô$9ÀaÓ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   