o }oi/@sddlmZddlZddlZddlmZddlmZddlmZddlZddl m Z ddl m Z ddl m Z erPdd lmZdd lmZed Zed Zed ZdZdZd$ddZd%ddZ  d&d'dd Z  d&d(d"d#ZdS))) annotationsN)Any) TYPE_CHECKING)TypeVar)version)_get_docstring_indent)_validate_version)Callable) ParamSpecFTFPCTa .. warning:: Deprecated in v{d_ver}. This feature will be removed in the future. The removal of this feature is currently scheduled for v{r_ver}, but this schedule is subject to change. See https://github.com/optuna/optuna/releases/tag/v{d_ver}. z{name} has been deprecated in v{d_ver}. This feature will be removed in v{r_ver}. See https://github.com/optuna/optuna/releases/tag/v{d_ver}. old_versionstr new_versionreturnNonecCs(t|t|krtd||dS)NzInvalid version relationship. The deprecated version must be smaller than the removed version, but (deprecated version, removed version) = ({}, {}) are specified.)rparse ValueErrorformat)rrrF/home/ubuntu/.local/lib/python3.10/site-packages/optuna/_deprecated.py_validate_two_version*s rtextcCsdt|ddS)Nz z  )textwrapindentstrip)rrrr _format_text3srdeprecated_versionremoved_versionname str | None0'Callable[[Callable[FP, FT]], Callable[FP, FT]]'c2tttdfdd }|S)a5Decorate function as deprecated. Args: deprecated_version: The version in which the target feature is deprecated. removed_version: The version in which the target feature will be removed. name: The name of the feature. Defaults to the function name. Optional. text: The additional text for the deprecation note. The default note is build using specified ``deprecated_version`` and ``removed_version``. If you want to provide additional information, please specify this argument yourself. .. note:: The default deprecation note is as follows: "Deprecated in v{d_ver}. This feature will be removed in the future. The removal of this feature is currently scheduled for v{r_ver}, but this schedule is subject to change. See https://github.com/optuna/optuna/releases/tag/v{d_ver}." .. note:: The specified text is concatenated after the default deprecation note. func'Callable[FP, FT]'rcs|jdurd_tjd}dur|t7}tj}jt|||_t d fdd }|S) Nd_verr_verargsrkwargsr'FT'csPtjdurnjd}dur|d7}tj|tdd|i|S)zDecorates a function as deprecated. This decorator is supposed to be applied to the deprecated function. Nr!r)r*  stacklevel)_DEPRECATION_WARNING_TEMPLATEr__name__warningswarn FutureWarning)r+r,message)rr%r!r rrrwrappercs z3deprecated_func..decorator..wrapper)r+rr,rrr-) __doc___DEPRECATION_NOTE_TEMPLATErrrrrr functoolswraps)r%noterr9rr!r r)r%r decoratorYs   z"deprecated_func..decoratorN)r%r&rr&rrrr r!rr@rr?rdeprecated_func7s  rC'Callable[[CT], CT]'cr$)a/Decorate class as deprecated. Args: deprecated_version: The version in which the target feature is deprecated. removed_version: The version in which the target feature will be removed. name: The name of the feature. Defaults to the class name. Optional. text: The additional text for the deprecation note. The default note is build using specified ``deprecated_version`` and ``removed_version``. If you want to provide additional information, please specify this argument yourself. .. note:: The default deprecation note is as follows: "Deprecated in v{d_ver}. This feature will be removed in the future. The removal of this feature is currently scheduled for v{r_ver}, but this schedule is subject to change. See https://github.com/optuna/optuna/releases/tag/v{d_ver}." .. note:: The specified text is concatenated after the default deprecation note. cls'CT'rcsdfdd }||S)NrErFrcst|dt|dtdfd d }t|d||jd ur)d |_tjd }d ur:|t7}t|j}|j t ||||_|S)z|Decorates a class as deprecated. This decorator is supposed to be applied to the deprecated class. __init__r4selfrr+r,rrcsZtjdurnd}dur|d7}tj|tdd|g|Ri|dS)Nr.r/r0r1)r3rr5r6r7)rHr+r,r8)_original_init_original_namerr!r rrr wrapped_inits zJdeprecated_class..decorator..wrapper..wrapped_initNr'r()rHrr+rr,rrr) getattrr<r=setattrr:r;rrrrrr)rErKr>rr?)rIrJrr9s      z4deprecated_class..decorator..wrapperrErFrrFr)rEr9r?rrr@s(z#deprecated_class..decoratorNrNrArBrr?rdeprecated_classzs  +rO)rrrrrr)rrrr)NN) rrr rr!r"rr"rr#) rrr rr!r"rr"rrD) __future__rr<rtypingrrrr5 packagingroptuna._experimentalrrcollections.abcr typing_extensionsr r r r r;r3rrrCrOrrrrs6             F