%`iddlZddlZddlmZmZddlmZddlmZej e Z dZ dddddde d ee d ee d eeeefd ed df dZdddddZdS)N)OptionalUnion)log_once)_mark_annotated)helperror stackleveloldnewr r r returnc>d||rd|n|rd|nd}|rDt|ts t|tr ||t |t d|zdz|dS) a'Warns (via the `logger` object) or throws a deprecation warning/error. Args: old: A description of the "thing" that is to be deprecated. new: A description of the new "thing" that replaces it. help: An optional help text to tell the user, what to do instead of using `old`. error: Whether or which exception to raise. If True, raise ValueError. If False, just warn. If `error` is-a subclass of Exception, raise that Exception. stacklevel: The stacklevel to use for the warning message. Use 2 to point to where this function is called, 3+ to point further up the stack. Raises: ValueError: If `error=True`. Exception: Of type `error`, iff `error` is a sub-class of `Exception`. z`{}` has been deprecated.{}z Use `{}` instead. zDeprecationWarning: z( This will raise an error in the future!)r N)format isinstancebool issubclass Exception ValueErrorloggerwarning)r r r r r msgs k/home/jaya/work/projects/VOICE-AGENT/VIET/agent-env/lib/python3.11/site-packages/ray/_common/deprecation.pydeprecation_warningrs4 ( . . #U"))#...;U:t:::SU  C  %&& ":eY+G+G "%** S// ! "S (+U U!      )r r cfd}|S)aDecorator for documenting a deprecated class, method, or function. Automatically adds a `deprecation.deprecation_warning(old=..., error=False)` to not break existing code at this point to the decorated class' constructor, method, or function. In a next major release, this warning should then be made an error (by setting error=True), which means at this point that the class/method/function is no longer supported, but will still inform the user about the deprecation event. In a further major release, the class, method, function should be erased entirely from the codebase. .. testcode:: :skipif: True from ray._common.deprecation import Deprecated # Deprecated class: Patches the constructor to warn if the class is # used. @Deprecated(new="NewAndMuchCoolerClass", error=False) class OldAndUncoolClass: ... # Deprecated class method: Patches the method to warn if called. class StillCoolClass: ... @Deprecated(new="StillCoolClass.new_and_much_cooler_method()", error=False) def old_and_uncool_method(self, uncool_arg): ... # Deprecated function: Patches the function to warn if called. @Deprecated(new="new_and_much_cooler_function", error=False) def old_and_uncool_function(*uncool_args): ... ctjr)jfd}|_tSfd}|S)Ncvtpjrtpjd|i|SN)r r r r r r__name__r)argskwargsr r r objobj_initr s r patched_initz0Deprecated.._inner..patched_initjs^C/3<00'/3<!##$  x0000rcvtpjrtpjd|i|Sr!r#)r%r&r r r r'r s r_ctorz)Deprecated.._inner.._ctor}s^+s|,, #+s| 3''' 'r)inspectisclass__init__r)r'r)r+r(r r r r s` @r_innerzDeprecated.._innerds ?3   |H 1 1 1 1 1 1 1 1 1 1(CL C J ( ( ( ( ( ( ( ( ( r)r r r r r/s```` r Deprecatedr1<s7P&&&&&&&&R Mr)N)r,loggingtypingrrray.utilrray.util.annotationsr getLoggerr$rDEPRECATED_VALUEstrrrintrr1r0rrr:s#""""""""000000  8 $ $  ) .2 ) ) ) ) #)  3- ) E$ /* + )  )  ) ) ) ) XQ4QQQQQQQr