o hp@sUdZddlmZddlZddlZddlmZmZddlm Z ddl m Z dZ Gdd d eZdad ed <  d'd(ddZd)ddZdddd*d%d&ZdS)+zN A module that implements tooling to enable easy warnings about deprecations. ) annotationsN)AnyTextIO)parse) __version__z DEPRECATION: c@s eZdZdS)PipDeprecationWarningN)__name__ __module__ __qualname__r r R/var/www/html/venv/lib/python3.10/site-packages/pip/_internal/utils/deprecation.pyrsrr_original_showwarningmessage Warning | strcategory type[Warning]filenamestrlinenointfile TextIO | Noneline str | NonereturnNonecCsb|durtdurt||||||dSdSt|tr&td}||dSt||||||dS)Nzpip._internal.deprecations)r issubclassrlogging getLoggerwarning)rrrrrrloggerr r r _showwarnings  r!cCs,tjdtddtdurtjatt_dSdS)NdefaultT)append)warnings simplefilterrr showwarningr!r r r r install_warning_logger.s  r') feature_flagissuereason replacementgone_inr(r) int | NonecCs|duo ttt|k}|tdf||sdndf|df||s!dndf|dfg}dd d |D}|r8t|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.|]\}}|dur|dur||VqdS)N)format).0value format_strr r r tszdeprecated..)r stacklevel)rcurrent_versionDEPRECATION_MSG_PREFIXjoinrr$warn)r*r+r,r(r)is_gone message_partsrr r r deprecated9s2    r<)NN)rrrrrrrrrrrrrr)rr) r*rr+rr,rr(rr)r-rr)__doc__ __future__rrr$typingrrpip._vendor.packaging.versionrpiprr6r7Warningrr __annotations__r!r'r<r r r r s"