+
    Ui                       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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]R&   RtR# )PipDeprecationWarningFboolinclude_source N)__name__
__module____qualname____firstlineno__r
   __annotations____static_attributes__r       ]/var/www/html/photoedit/myenv/lib/python3.14/site-packages/pip/_internal/utils/deprecation.pyr   r      s     ND 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                R   Ve   \         e   \        WW#WE4       R # R # \        V\        4      '       dg   \        P                  ! R4      p\        V \        4      '       d(   V P                  '       d   VP                  RWV4       R # VP                  V 4       R # \        WW#WE4       R # )Nzpip._internal.deprecationsz
%s (%s:%s))r   
issubclassr   logging	getLogger
isinstancer
   warning)r   r   r   r   r   r   loggers   &&&&&& r   _showwarningr+      s      ,!'XtR -	H3	4	4 ""#?@g455':P:P:PNN<FCNN7#g4Nr   c                   V ^8  d   QhRR/# )r   r    r!   r   )r"   s   "r   r#   r#   1   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_loggerr3   1   s6    )%:4H $ ( 4 4+ %r   feature_flagissue
stacklevelr
   Fc               8    V ^8  d   QhRRRRRRRRRRR	R
RRRR/# )r   reasonr   replacementr   gone_inr4   r5   z
int | Noner6   r   r
   r	   r    r!   r   )r"   s   "r   r#   r#   <   sd     O2 O2O2 O2 	O2
 O2 O2 O2 O2 
O2r   c                R   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\	        V	4      p
Wjn        \        P                  ! WR
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.
stacklevel:
    How many frames up the call stack to attribute the warning to.
    Defaults to 2 (the caller of deprecated()).
include_source:
    If True, include the source filename and line number in the warning
    output. Useful when the warning originates from external code.
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>   s5      !.E 	!&+ 	!
%  !.s   ...)r6   )r   current_versionDEPRECATION_MSG_PREFIXjoinr   r
   r0   warn)r8   r9   r:   r4   r5   r6   r
   is_gonemessage_partsr   r)   s   $$$$$$$    r   
deprecatedrI   <   s    J T!NNeO&<g&NG 
*+401  =A	
 +	

   X	
 N	
-M8 hh !. G #G,,#G,G+MM'1r   )NN)__conditional_annotations____doc__
__future__r   r&   r0   typingr   r   pip._vendor.packaging.versionr   pipr   rC   rD   Warningr   r   r   r+   r3   rI   )rJ   s   @r   <module>rQ      s    #    / .( !G ! " s !O.,O2
  $O2 O2 O2 !O2 O2r   