B Uvg @sdZddlmZddlZddlZddlmZddlmZ ddl m Z e rXddl m Z mZGdd d eZdadd d Zd d ZdddZdS)zN A module that implements tooling to enable easy warnings about deprecations. )absolute_importN)parse) __version__)MYPY_CHECK_RUNNING)AnyOptionalc@s eZdZdS)PipDeprecationWarningN)__name__ __module__ __qualname__r r @/tmp/pip-install-r_9ig3yj/pip/pip/_internal/utils/deprecation.pyrsrcCsZ|dk r$tdk rVt||||||n2t|trDtd}||nt||||||dS)Nzpip._internal.deprecations)_original_showwarning issubclassrlogging getLoggerwarning)messagecategoryfilenamelinenofilelineloggerr r r _showwarnings   rcCs(tjdtddtdkr$tjatt_dS)NdefaultT)append)warnings simplefilterrr showwarningrr r r r install_warning_logger+sr cCstd|}|dk r|d|7}|dk r@dt|}|d|7}|dk r`ttt|kr`t|tj|tdddS)aHelper to deprecate existing functionality. reason: Textual reason shown to the user about why this functionality has been deprecated. 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 errors if pip's current version is greater than or equal to this. issue: Issue number on the tracker that would serve as a useful place for users to find related discussion and provide feedback. Always pass replacement, gone_in and issue as keyword arguments for clarity at the call site. z DEPRECATION: Nz A possible replacement is {}.z#https://github.com/pypa/pip/issues/z. You can find discussion regarding this at {}.)r stacklevel)formatstrrcurrent_versionrrwarn)reason replacementgone_inissuerurlr r r deprecated6s r,)NN)N)__doc__ __future__rrrZpip._vendor.packaging.versionrpiprr%pip._internal.utils.typingrtypingrrWarningrrrr r,r r r r s