a s hp @sUdZddlmZddlZddlZddlmZmZddlm Z ddl m Z dZ Gdd d eZdad ed <dd d ddddddddZddddZddddddddddddZdS)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 [/var/www/html/assistant/venv/lib/python3.9/site-packages/pip/_internal/utils/deprecation.pyrsrr_original_showwarningz Warning | strz type[Warning]strintz TextIO | Nonez str | NoneNone)messagecategoryfilenamelinenofilelinereturncCsZ|dur$tdurVt||||||n2t|trDtd}||nt||||||dS)Nzpip._internal.deprecations)r issubclassrlogging getLoggerwarning)rrrrrrloggerr r r _showwarnings   r)rcCs(tjdtddtdur$tjatt_dS)NdefaultT)append)warnings simplefilterrr showwarningrr r r r install_warning_logger.sr#) feature_flagissuez int | None)reason replacementgone_inr$r%rcCs|duottt|k}|tdf||s.dndf|df||sBdndf|dfg}dd 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,|]$\}}|dur|dur||VqdS)N)format).0valueZ format_strr r r tszdeprecated..)r stacklevel)rcurrent_versionDEPRECATION_MSG_PREFIXjoinrr warn)r&r'r(r$r%Zis_goneZ message_partsrr r r deprecated9s2    r4)NN)__doc__ __future__rrr typingrrZpip._vendor.packaging.versionrpiprr0r1Warningrr __annotations__rr#r4r r r r s