U YyŒh_2ã@s„ddlZddlZddlZddlZddlmZddlmZdZddddd gZ d Z Gd d„de ƒZ Gd d „d e ƒZ ddd„Zdd„ZdS)éN)Úversion)Údatez2.1.0Ú deprecatedÚmessage_locationÚfail_if_not_removedÚDeprecatedWarningÚUnsupportedWarningÚbottomcs*eZdZdZd‡fdd„ Zdd„Z‡ZS)rawA warning class for deprecated methods This is a specialization of the built-in :class:`DeprecationWarning`, adding parameters that allow us to get information into the __str__ that ends up being sent through the :mod:`warnings` system. The attributes aren't able to be retrieved after the warning gets raised and passed through the system as only the class--not the instance--and message are what gets preserved. :param function: The function being deprecated. :param deprecated_in: The version that ``function`` is deprecated in :param removed_in: The version or :class:`datetime.date` specifying when ``function`` gets removed. :param details: Optional details about the deprecation. Most often this will include directions on what to use instead of the now deprecated code. Úcs2||_||_||_||_tt|ƒ ||||¡dS)N)ÚfunctionÚ deprecated_inÚ removed_inÚdetailsÚsuperrÚ__init__)Úselfr r r r©Ú __class__©ú5/usr/local/lib/python3.8/dist-packages/deprecation.pyr5sÿzDeprecatedWarning.__init__cCsˆt t¡}|j|d<|jr(d|j|d<|jrPd t|jtƒrBdnd|j¡|d<t |j|j|j gƒrld|d <|j r€d |j |d <d |S) Nr z as of %srz and will be removed {} {}ÚonÚinÚremovedÚ.Zperiodú %srzH%(function)s is deprecated%(deprecated)s%(removed)s%(period)s%(details)s) Ú collectionsÚ defaultdictÚstrr r r ÚformatÚ isinstancerÚanyr©rÚpartsrrrÚ__str__@s  ÿÿzDeprecatedWarning.__str__)r )Ú__name__Ú __module__Ú __qualname__Ú__doc__rr#Ú __classcell__rrrrr"s c@seZdZdZdd„ZdS)raƒA warning class for methods to be removed This is a subclass of :class:`~deprecation.DeprecatedWarning` and is used to output a proper message about a function being unsupported. Additionally, the :func:`~deprecation.fail_if_not_removed` decorator will handle this warning and cause any tests to fail if the system under test uses code that raises this warning. cCs:t t¡}|j|d<|j|d<|jr2d|j|d<d|S)Nr rrrz9%(function)s is unsupported as of %(removed)s.%(details)s)rrrr r rr!rrrr#^s   ÿzUnsupportedWarning.__str__N)r$r%r&r'r#rrrrrTs r cs¨ˆdkrˆdk rtdƒ‚d}d‰tˆtƒrBt ¡ˆkr._function_wrapper.._inner) r'rrrÚsplitÚlenÚtextwrapÚdedentÚinsertrÚjoinÚ functoolsÚwraps)r Zexisting_docstringr"Zdeprecation_noteÚlocZ string_listr8©r rr6r r7)r rÚ_function_wrapper»s4 ÿÿù ÿ       z%deprecated.._function_wrapper)Ú TypeErrorrrÚtodayrÚparser )r r Úcurrent_versionrZ is_deprecatedrCrrBrrjs,,    ÿ ÿ Kcst ˆ¡‡fdd„ƒ}|S)a¤Decorate a test method to track removal of deprecated code This decorator catches :class:`~deprecation.UnsupportedWarning` warnings that occur during testing and causes unittests to fail, making it easier to keep track of when code should be removed. :raises: :class:`AssertionError` if an :class:`~deprecation.UnsupportedWarning` is raised while running the test method. c sZtjdd}t d¡ˆ||Ž}W5QRX|D]$}|jtkr0tdˆt|jƒfƒ‚q0|S)NT)ÚrecordÚalwaysz-%s uses a function that should be removed: %s)r0Úcatch_warningsÚ simplefilterr.rÚAssertionErrorrÚmessage)r3r4Zcaught_warningsÚrvÚwarning©ÚmethodrrÚ test_inners   ÿÿz'fail_if_not_removed..test_inner)r?r@)rQrRrrPrr s  )NNNr )rr?r;r0Ú packagingrÚdatetimerÚ __version__Ú__all__rr2rrrrrrrrÚ s$  ÿ2ÿ