+
    Îip                       a  0 t $ R t^ RIHt ^ RIt^ RIt^ RIHtHt ^ RI	H
t
 ^ RIHt Rt ! R R]4      tRsR	]R
&   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.
)annotationsN)AnyTextIO)parse)__version__zDEPRECATION: c                      ] tR t^tRtR# )PipDeprecationWarning N)__name__
__module____qualname____firstlineno____static_attributes__r	       n/Users/ahmad/.openclaw/workspace/scripts/.venv/lib/python3.14/site-packages/pip/_internal/utils/deprecation.pyr   r      s    r   r   r   _original_showwarningc               4    V ^8  d   QhRRRRRRRRR	R
RRRR/# )   messagezWarning | strcategoryztype[Warning]filenamestrlinenointfilezTextIO | Noneline
str | NonereturnNoner	   )formats   "r   __annotate__r       sW     O OOO O 	O
 O 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)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                   V ^8  d   QhRR/# )r   r   r   r	   )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_loggerr/   .   s6    )%:4H $ ( 4 4+ %r   feature_flagissuec               0    V ^8  d   QhRRRRRRRRRRR	R
/# )r   reasonr   replacementr   gone_inr0   r1   z
int | Noner   r   r	   )r   s   "r   r    r    9   sV     EI EIEI EI 	EI
 EI 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>t   s5      !.E 	!&+ 	!
%  !.s   ...)r   
stacklevel)r   current_versionDEPRECATION_MSG_PREFIXjoinr   r,   warn)r3   r4   r5   r0   r1   is_gonemessage_partsr   s   $$$$$   r   
deprecatedrE   9   s    : T!NNeO&<g&NG 
*+401  =A	
 +	

   X	
 N	
-M8 hh !. G #G,,MM'$9aHr   )NN)__conditional_annotations____doc__
__future__r   r#   r,   typingr   r   pip._vendor.packaging.versionr   pipr   r?   r@   Warningr   r   __annotations__r'   r/   rE   )rF   s   @r   <module>rN      so    #    / .( 	G 	 " s !O(,EI
  $EI EI EIr   