o c@s6UdZddlZddlZddlmZmZmZmZmZddl m Z ddl m Z dZGdddeZdaeed <  d+d eeefd eed ed edeedeeddfddZd,ddZddddedeedeedeedeeddf ddZGdddZedd d!d"d#d$Zed%d&d!d'd#d(Zed)d&d!d*d#d(ZdS)-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 L/opt/certbot/lib/python3.10/site-packages/pip/_internal/utils/deprecation.pyr sr _original_showwarningmessagecategoryfilenamelinenofilelinereturncCsb|durtdurt||||||dSdSt|tr&td}||dSt||||||dS)Nzpip._internal.deprecations)r issubclassr logging getLoggerwarning)rrrrrrloggerr r r _showwarnings  rcCs,tjdtddtdurtjatt_dSdS)NdefaultT)append)warnings simplefilterr r showwarningrr r r rinstall_warning_logger,s  r") feature_flagissuereason replacementgone_inr#r$cCs|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||VqdSN)format).0value format_strr r r ns zdeprecated..)r stacklevel)rcurrent_versionDEPRECATION_MSG_PREFIXjoinr rwarn)r%r&r'r#r$is_gone message_partsrr r r deprecated7s2  r7c@sbeZdZ      ddedeedeedeedeeded efd d Zd ed dfddZdS)LegacyInstallReasonNFr%r&r'r#r$emit_after_successemit_before_installcCs.||_||_||_||_||_||_||_dSr))_reason _replacement_gone_in _feature_flag_issuer9r:)selfr%r&r'r#r$r9r:r r r__init__|s  zLegacyInstallReason.__init__namercCs(t|jj|d|j|j|j|jddS)N)rB)r%r&r'r#r$)r7r;r*r<r=r>r?)r@rBr r remit_deprecations  z$LegacyInstallReason.emit_deprecation)NNNNFF) r r r strrintboolrArCr r r rr8{s. r8zk{name} was installed using the legacy 'setup.py install' method, because a wheel could not be built for it.z+to fix the wheel build issue reported abovez23.1i T)r%r&r'r$r9z{name} is being installed using the legacy 'setup.py install' method, because it does not have a 'pyproject.toml' and the 'wheel' package is not installed.z#to enable the '--use-pep517' optionio!)r%r&r'r$r:z{name} is being installed using the legacy 'setup.py install' method, because the '--no-binary' option was enabled for it and this currently disables local wheel building for projects that don't have a 'pyproject.toml' file.i,)NN)rN)__doc__rrtypingrrrrrpip._vendor.packaging.versionrpiprr1r2Warningr r__annotations__rDrErr"r7r8#LegacyInstallReasonFailedBdistWheel&LegacyInstallReasonMissingWheelPackage2LegacyInstallReasonNoBinaryForcesSetuptoolsInstallr r r rs       D