
    q"h{                        % S r SSKrSSKrSSKJrJrJr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
\\\4   S\\   S\S\S\\   S\\   SS4S jjrSS jrSSS.S\S\\   S\\   S\\   S\\   SS4S jjrg)zN
A module that implements tooling to enable easy warnings about deprecations.
    N)AnyOptionalTextIOTypeUnion)parse)__version__zDEPRECATION: c                       \ rS rSrSrg)PipDeprecationWarning    N)__name__
__module____qualname____firstlineno____static_attributes__r       Q/var/www/html/env/lib/python3.13/site-packages/pip/_internal/utils/deprecation.pyr   r      s    r   r   _original_showwarningmessagecategoryfilenamelinenofilelinereturnc                     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)r   r   r   r   r   r   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issuereasonreplacementgone_inr+   r,   c                 ,   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>r   s5      !.E 	!&+ 	!
%  !.s   	,,,   )r   
stacklevel)r   current_versionDEPRECATION_MSG_PREFIXjoinr   r'   warn)r-   r.   r/   r+   r,   is_gonemessage_partsr   s           r   
deprecatedrA   7   s    : T!NeO&<g&NG 
*+401  =A	
 +	

   X	
 N	
-M8 hh !. G #G,,MM'$9aHr   )NN)r   N)__doc__r   r'   typingr   r   r   r   r   pip._vendor.packaging.versionr   pipr	   r;   r<   Warningr   r   __annotations__strintr#   r*   rA   r   r   r   <module>rJ      s     5 5 / .( 	G 	 " s ! "O7C< O7mO O 	O
 6
O 3-O 
O(,  #'EIEI #EI c]	EI
 3-EI C=EI 
EIr   