R`i+ U d Z ddlZddlZddlmZmZmZmZmZ ddl m
Z
ddl m Z
dZ G d de Zdaeed < dd
eeef d ee d ed
edee dee ddfdZddZddddedee dee dee dee ddf dZy) zN
A module that implements tooling to enable easy warnings about deprecations.
N)AnyOptionalTextIOTypeUnion)parse) __version__z
DEPRECATION: c e Zd Zy)PipDeprecationWarningN)__name__
__module__ __qualname__ /builddir/build/BUILDROOT/alt-python312-pip-23.3.1-3.el8.x86_64/opt/alt/python312/lib/python3.12/site-packages/pip/_internal/utils/deprecation.pyr r s r r _original_showwarningmessagecategoryfilenamelinenofilelinereturnc |t t | ||||| y y t |t r't j d }|j | y t | ||||| y )Nzpip._internal.deprecations)r
issubclassr logging getLoggerwarning)r r r r r r loggers r _showwarningr sc , !'8XvtT R - H 3 4 ""#?@w gx64Nr c t j dt d t t j at
t _ y y )NdefaultT)append)warnings simplefilterr r showwarningr r r r install_warning_loggerr' , s6 )%:4H $ ( 4 4 + %r ) feature_flagissuereason replacementgone_inr( r) c |duxr t t t | k\ }| t df||sdndf|df||sdndf|dfg}dj d |D }|r t | t j |t d
y) 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 L K | ] \ }}|||j | y w)N)format).0value
format_strs r z deprecated..n s3 !. E: !e&7 % !.s "$ )r
stacklevel)r current_versionDEPRECATION_MSG_PREFIXjoinr r$ warn)r* r+ r, r( r) is_gone
message_partsr s r
deprecatedr= 7 s : T!NeO&<g&NG
*+401
9=
+
T
N
%M0 hh !. G #G,, MM'$9aHr )NN)r N)__doc__r r$ typingr r r r r pip._vendor.packaging.versionr pipr r7 r8 Warningr r __annotations__strintr r' r= r r r rF s 5 5 / .( G " s ! "
O
7C<
O7mO O
O
6
O 3-
O
O(, #'
AI AI # AI c] AI
3- AI C=
AI
AIr