o EOf@s|ddlmZmZddlZddlZddlmZdgZeZ ddddZ dd dZ Gd d d Z dd d Z dddddZdS)) Parameter signatureN) import_module _deprecated)correct_modulec Cs@|dur d|d|}nd|}||vr*td|d|d|d|d|d tt||d}|durFd|d |d |d|d }n!d|d|d|d |d|d |d|d|d|d|d}tj|tdd|D],}zttd|d||WSty} z||dkr| WYd} ~ qqd} ~ wwdS)aHelper function for deprecating modules that are public but were intended to be private. Parameters ---------- sub_package : str Subpackage the module belongs to eg. stats module : str Public but intended private module to deprecate private_modules : list Private replacement(s) for `module`; should contain the content of ``all``, possibly spread over several modules. all : list ``__all__`` belonging to `module` attribute : str The attribute in `module` being accessed correct_module : str, optional Module in `sub_package` that `attribute` should be imported from. Default is that `attribute` should be imported from ``scipy.sub_package``. Nzscipy..z`scipy.z` has no attribute `z`; furthermore, `scipy.z3` is deprecated and will be removed in SciPy 2.0.0.zPlease import `z ` from the `z` namespace; the `scipy.z=` namespace is deprecated and will be removed in SciPy 2.0.0.z&` is deprecated along with the `scipy.z` namespace. `scipy.z2` will be removed in SciPy 1.14.0, and the `scipy.z+` namespace will be removed in SciPy 2.0.0.category stacklevel)AttributeErrorgetattrrwarningswarnDeprecationWarning) Z sub_packagemoduleZprivate_modulesallZ attributerZcorrect_importattrmessageer6lib/python3.10/site-packages/scipy/_lib/deprecation.py_sub_module_deprecations\    rcsfdd}|S)z2Deprecate a function by emitting a warning on use.csJttrtjdtddStfdd}j|_|S)NzTrying to deprecate class rr cstjtd|i|S)Nr )rrr)argskwargs)funmsgr rrcallWsz'_deprecated..wrap..call) isinstancetyperrRuntimeWarning functoolswraps__doc__)rrrr )rrwrapPs z_deprecated..wrapr)rr r'rr&rrNsc@s(eZdZdZddZddZddZdS) _DeprecationHelperStrz3 Helper class used by deprecate_cython_api cCs||_||_dSN)_content_message)selfZcontentrrrr__init__fs z_DeprecationHelperStr.__init__cCs t|jSr))hashr*)r,rrr__hash__js z_DeprecationHelperStr.__hash__cCs$|j|k}|rtj|jtdd|S)Nrr )r*rrr+r)r,otherresrrr__eq__ms  z_DeprecationHelperStr.__eq__N)__name__ __module__ __qualname__r%r-r/r2rrrrr(bs  r(c Cs|jd|}|durd|}n d|d|d}|dur$|d|7}|j}d}d } d ||} | |vrHd }|| |t| |<|d 7}nnq,|sX|||t||<dSdS) a> Deprecate an exported cdef function in a public Cython API module. Only functions can be deprecated; typedefs etc. cannot. Parameters ---------- module : module Public Cython API module (e.g. scipy.linalg.cython_blas). routine_name : str Name of the routine to deprecate. May also be a fused-type routine (in which case its all specializations are deprecated). new_name : str New name to include in the deprecation warning message message : str Additional text in the deprecation warning message Examples -------- Usually, this function would be used in the top-level of the module ``.pyx`` file: >>> from scipy._lib.deprecation import deprecate_cython_api >>> import scipy.linalg.cython_blas as mod >>> deprecate_cython_api(mod, "dgemm", "dgemm_new", ... message="Deprecated in Scipy 1.5.0") >>> del deprecate_cython_api, mod After this, Cython modules that use the deprecated function emit a deprecation warning when they are imported. rNz`%s` is deprecated!`z` is deprecated, use `z ` instead! rFTZ __pyx_fuse_)r3Z __pyx_capi__popr() rZ routine_namenew_namerZold_nameZdepdocdjZ has_fusedZ fused_namerrrdeprecate_cython_apius(!    r=versioncs4dur d}t|fdd}|dur||S|S)aDecorator for methods that issues warnings for positional arguments. Using the keyword-only argument syntax in pep 3102, arguments after the * will issue a warning when passed as a positional argument. Parameters ---------- func : callable, default=None Function to check arguments on. version : callable, default=None The version when positional arguments will result in error. Nz9Need to specify a version where signature will be changedcsttggjD]\}}|jtjkr|q |jtjkr(|q t fdd}|S)Ncst|t}|dkr|i|Sddtd||| dD}d|}tjd|ddtdd |tj|d i|S) NrcSsg|] \}}|d|qS)=r).0nameargrrr s zi_deprecate_positional_args.._inner_deprecate_positional_args..inner_f..z, zYou are passing z^ as a positional argument. Please change your invocation to use keyword arguments. From SciPy z@, passing these as positional arguments will result in an error.r)r r)lenzipjoinrrrupdate parameters)rr extra_argsZargs_msg)all_argsf kwonly_argssigr?rrinner_fs   zU_deprecate_positional_args.._inner_deprecate_positional_args..inner_f) rrIitemskindrZPOSITIONAL_OR_KEYWORDappendZ KEYWORD_ONLYr#r$)rLrBZparamrOr>)rKrLrMrNr _inner_deprecate_positional_argss    zD_deprecate_positional_args.._inner_deprecate_positional_args) ValueError)funcr?rrSrr>r_deprecate_positional_argss  &rV)r)NNr))inspectrrr#r importlibr__all__objectZ_NoValuerrr(r=rVrrrrs  @ @