OAi_2SSKrSSKrSSKrSSKrSSKJr SSKJr Sr/SQr Sr "SS\ 5r "S S \ 5r S S jrS rg)N)version)datez2.1.0) deprecatedmessage_locationfail_if_not_removedDeprecatedWarningUnsupportedWarningbottomc6^\rSrSrSrSU4SjjrSrSrU=r$)r"a?A 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. c^>XlX lX0lX@l[[ U]XX45 g)N)function deprecated_in removed_indetailssuperr__init__)selfrrrr __class__s G/var/www/html/land-ocr/venv/lib/python3.13/site-packages/deprecation.pyrDeprecatedWarning.__init__5s0! *$  /0: Ec[R"[5nURUS'UR(aSUR-US'UR (a@SR [UR [5(aSOSUR 5US'[URUR UR/5(aSUS 'UR(aS UR-US 'S U-$) Nrz as of %srz and will be removed {} {}oninremoved.period %srzH%(function)s is deprecated%(deprecated)s%(removed)s%(period)s%(details)s) collections defaultdictstrrrrformat isinstanceranyrrpartss r__str__DeprecatedWarning.__str__@s'', MMj   "-0B0B"BE,  ??;BB:VZVeVegkKlKl4rvCG?? TE)  ""DOOT\\B C C!E(O <<$t||3E) (+02 3r)rrrr)) __name__ __module__ __qualname____firstlineno____doc__rr(__static_attributes__ __classcell__)rs@rrr"s$ E33rrc\rSrSrSrSrSrg)r TakA 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. c[R"[5nURUS'URUS'UR (aSUR -US'SU-$)Nrrrrz9%(function)s is unsupported as of %(removed)s.%(details)s)r r!r"rrrr&s rr(UnsupportedWarning.__str__^sZ'', MMj??i <<$t||3E) !&( )rN)r+r,r-r.r/r(r0r6rrr r Ts  )rr c^^^^^TcTb [S5eSnSm[T[5(a[R"5T:aSmOjSnOgU(a^[R "U5nT(aU[R "T5:aSmO&T(aU[R "T5:aSnOSn[ UT/5mUUUUU4SjnU$)aQ Decorate a function to signify its deprecation This function wraps a method that will soon be removed and does two things: * The docstring of the method will be modified to include a notice about deprecation, e.g., "Deprecated since 0.9.11. Use foo instead." * Raises a :class:`~deprecation.DeprecatedWarning` via the :mod:`warnings` module, which is a subclass of the built-in :class:`DeprecationWarning`. Note that built-in :class:`DeprecationWarning`s are ignored by default, so for users to be informed of said warnings they will need to enable them--see the :mod:`warnings` module documentation for more details. :param deprecated_in: The version at which the decorated method is considered deprecated. This will usually be the next version to be released when the decorator is added. The default is **None**, which effectively means immediate deprecation. If this is not specified, then the `removed_in` and `current_version` arguments are ignored. :param removed_in: The version or :class:`datetime.date` when the decorated method will be removed. The default is **None**, specifying that the function is not currently planned to be removed. Note: This parameter cannot be set to a value if `deprecated_in=None`. :param current_version: The source of version information for the currently running code. This will usually be a `__version__` attribute on your library. The default is `None`. When `current_version=None` the automation to determine if the wrapped function is actually in a period of deprecation or time for removal does not work, causing a :class:`~deprecation.DeprecatedWarning` to be raised in all cases. :param details: Extra details to be added to the method docstring and warning. For example, the details may point users to a replacement method, such as "Use the foo_bar method instead". By default there are no details. zCCannot set removed_in to a value without also setting deprecated_inFTcx>^T (Ga TR=(d SnT(aST-OST (a)SR[T [5(aSOST 5OST(aST-OSS.nSR"S0UD6nSnUR S S5n[ U5S:a:[ R"US5US'URUS 5 [S :waS nURXC5 URUS 5 SRU5Tl[R"T5UUUU U U 4S j5nU$)Nr*rz This will be removed {} {}.rr)rrrz3.. deprecated::{deprecated_in}{removed_in}{details} topz c>T (aCT(a[nO[nU"TRTTT5n[R"U[ SS9 T"U0UD6$)N)category stacklevel)r rr+warningswarnDeprecationWarning) argskwargscls the_warningrrris_unsupportedr should_warns r_inner5deprecated.._function_wrapper.._innersR!,C+C!("3"3]",g7  k4F)*,T,V, ,rr6) r/r#r$rsplitlentextwrapdedentinsertrjoin functoolswraps) rexisting_docstringr'deprecation_noteloc string_listrJrrrHrrIs ` r_function_wrapper%deprecated.._function_wrappersB !)!1!1!7R .;EM)NX7==jQ[]aFbFbdhl>HJ]_'.EGOB8E!88>!?!HAF!H C-224;K;!#"*Q!@ A""3-$u,C   s 5   sF +!ww{3H   " - - # - r) TypeErrorr$rtodayrparser%)rrcurrent_versionr is_deprecatedrXrHrIs`` ` @@rrrjsX!7=> >MN *d## ::<: %!N M !--8 #w}}Z'@@!N!W]]=%AA M  }n56KJJV rcF^[R"T5U4Sj5nU$)aDecorate 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$>[R"SS9n[R"S5 T"U0UD6nSSS5 WH<nUR[:XdM[ T<S[ UR5<35e W$!,(df  NR=f)NT)recordalwaysz) uses a function that should be removed: )rAcatch_warnings simplefilterr?r AssertionErrorr"message)rDrEcaught_warningsrvwarningmethods r test_inner'fail_if_not_removed..test_inners  $ $D 1_  ! !( +((B2'G#55$c'//2466'  2 1s B B)rRrS)rjrks` rrr s(__V   r)NNNr*)r rRrNrA packagingrdatetimer __version____all__rrCrr rrr6rrrqs^  6/3*/3d)*),EI\~r