U
ʗRe6 @ s U d Z ddlZddlZddlmZmZmZmZmZ ddl m
Z
ddl m Z
dZG dd deZdaeed < deeef ee eeee ee dd
d d Zdd
ddZdddeee ee ee ee ddddZdS )zN
A module that implements tooling to enable easy warnings about deprecations.
N)AnyOptionalTextIOTypeUnion)parse) __version__z
DEPRECATION: c @ s e Zd ZdS )PipDeprecationWarningN)__name__
__module__ __qualname__ r
r
/builddir/build/BUILDROOT/alt-python38-pip-22.2.1-2.el8.x86_64/opt/alt/python38/lib/python3.8/site-packages/pip/_internal/utils/deprecation.pyr s r _original_showwarning)messagecategoryfilenamelinenofilelinereturnc C sZ |d k r$t d k rVt | ||||| n2t|trDtd}|| nt | ||||| d S )Nzpip._internal.deprecations)r
issubclassr logging getLoggerwarning)r r r r r r loggerr
r
r _showwarning s
r )r c C s( t jdtdd td kr$t jatt _d S )NdefaultT)append)warnings simplefilterr r showwarningr r
r
r
r install_warning_logger, s r" ) feature_flagissue)reason replacementgone_inr# r$ r c C s |dk ot tt |k}| t df||s.dndf|df||sBdndf|dfg}dd d
|D }|rpt|tj|td d dS )
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 s s, | ]$\}}|d k r|d k r| |V qd S )N)format).0value
format_strr
r
r n s z deprecated.. )r
stacklevel)r current_versionDEPRECATION_MSG_PREFIXjoinr r warn)r% r& r' r# r$ is_gone
message_partsr r
r
r
deprecated7 s2
r6 )NN)__doc__r r typingr r r r r Z pip._vendor.packaging.versionr pipr r0 r1 DeprecationWarningr r __annotations__Warningstrintr r" r6 r
r
r
r s<