o /wi@sddlmZddlZddlZddlmZddlmZddlmZddlZddl m Z erDddl m Z ddl mZed Zed Zed Zd Zd!ddZd"ddZd#ddZ d$d%ddZ d$d&dd ZdS)') annotationsN)Any) TYPE_CHECKING)TypeVar)ExperimentalWarning)Callable) ParamSpecFTFPCTz .. note:: Added in v{ver} as an experimental feature. The interface may change in newer versions without prior notice. See https://github.com/optuna/optuna/releases/tag/v{ver}. option_namestrreturnNonecCstd|dtdS)Nz Argument ``zF`` is an experimental feature. The interface can change in the future.)warningswarnr)r rQ/home/ubuntu/sommelier/.venv/lib/python3.10/site-packages/optuna/_experimental.pywarn_experimental_arguments rversioncCs.t|trt|ddkrtd|dS)N.zKInvalid version specification. Must follow `x.y.z` format but `{}` is given) isinstancer lensplit ValueErrorformat)rrrr_validate_version'sr docstringcCsd|vr |ddSdS)N )r)rrrr_get_docstring_indent0sr"name str | None.Callable[[Callable[FP, FT]], Callable[FP, FT]]ctdfdd }|S)zDecorate function as experimental. Args: version: The first version that supports the target feature. name: The name of the feature. Defaults to the function name. Optional. funcCallable[FP, FT]rcsbjdurd_tjd}tj}jt|||_td fdd }|S) Nr!verargsrkwargsrr cs4tjddur njtdd|i|SNzP{} is experimental (supported from v{}). The interface can change in the future.) stacklevel)rrr__name__r)r+r,)r'r#rrrwrapperIs z5experimental_func..decorator..wrapper)r+rr,rrr ) __doc___EXPERIMENTAL_NOTE_TEMPLATErr"striptextwrapindent functoolswraps)r'noter6r1r#r)r'r decoratorAs    z$experimental_func..decoratorN)r'r(rr(rrr#r;rr:rexperimental_func4s r>Callable[[CT], CT]cr&)zDecorate class as experimental. Args: version: The first version that supports the target feature. name: The name of the feature. Defaults to the class name. Optional. clsr rcsdfdd }||S)Nr@r rcst|dt|dtdfd d }t|d||jd ur'd |_tjd }t|j}|jt ||||_|S)zDecorates a class as experimental. This decorator is supposed to be applied to the experimental class. __init__r0selfrr+r,rrcs>tjddur ntdd|g|Ri|dSr-)rrrr)rBr+r,)_original_init_original_namer#rrr wrapped_initqs zLexperimental_class..decorator..wrapper..wrapped_initNr!r))rBrr+rr,rrr) getattrr7r8setattrr2r3rr"r4r5r6)r@rEr9r6r:)rCrDrr1is     z6experimental_class..decorator..wrapperr@r rr r)r@r1r:rrr;hs z%experimental_class..decoratorNrHr<r=rr:rexperimental_class[s #rI)r r rr)rr rr)rr rr )N)rr r#r$rr%)rr r#r$rr?) __future__rr7r5typingrrrroptuna.exceptionsrcollections.abcrtyping_extensionsrr r r r3rrr"r>rIrrrrs,           )