3 de+ @sUdZddlZddlZddlmZmZmZmZmZddl m Z ddl m Z dZGdddeZdaedeeefeeeeeeeedd d d Zdd d dZdddeeeeeeeeeddddZdS)zN A module that implements tooling to enable easy warnings about deprecations. N)AnyOptionalTextIOTypeUnion)parse) __version__z DEPRECATION: c@s eZdZdS)PipDeprecationWarningN)__name__ __module__ __qualname__r r >/tmp/pip-build-red6nood/pip/pip/_internal/utils/deprecation.pyr sr )messagecategoryfilenamelinenofilelinereturncCsZ|dk r$tdk rVt||||||n2t|trDtjd}|j|nt||||||dS)Nzpip._internal.deprecations)_original_showwarning issubclassr logging getLoggerwarning)rrrrrrloggerr r r _showwarnings   r)rcCs(tjdtddtdkr$tjatt_dS)NdefaultT)append)warnings simplefilterr r showwarningrr r r rinstall_warning_logger,sr") feature_flagissue)reason replacementgone_inr#r$rcCs|dk ottt|k}|tdf||s.dndf|df||sBdndf|dfg}djd d |D}|rpt|tj|td d dS) aHelper 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.zA 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/{} css,|]$\}}|dk r|dk r|j|VqdS)N)format).0valueZ format_strr r r oszdeprecated..)r stacklevel)rcurrent_versionDEPRECATION_MSG_PREFIXjoinr rwarn)r%r&r'r#r$Zis_goneZ message_partsrr r r deprecated7s$  r3)NN)__doc__rrtypingrrrrrZpip._vendor.packaging.versionrpiprr/r0Warningr rstrintrr"r3r r r rs   "