a jy @s|ddlmZmZddlZddlZddlmZdgZeZ ddddZ dd dZ Gd d d Z dd d Z dddddZdS)) Parameter signatureN) import_module _deprecated)correct_modulec CsR|durd|d|}n d|}||vrTtd|d|d|d|d|d tt||d}|durd|d |d |d|d }nBd|d|d|d |d|d |d|d|d|d|d}tj|tdd|D]j}z ttd|d||WStyJ} z*||dkr*| WYd} ~ qWYd} ~ qd} ~ 00qdS)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_modulesall attributerZcorrect_importattrmessageer.wrap..call) isinstancetyperrRuntimeWarning functoolswraps__doc__)rr rr )rrwrapPs z_deprecated..wrapr)rr r(rr'rrNsc@s(eZdZdZddZddZddZdS) _DeprecationHelperStrz3 Helper class used by deprecate_cython_api cCs||_||_dSN)_content_message)selfcontentrrrr__init__fsz_DeprecationHelperStr.__init__cCs t|jSr*)hashr+)r-rrr__hash__jsz_DeprecationHelperStr.__hash__cCs$|j|k}|r tj|jtdd|S)Nrr )r+rrr,r)r-otherresrrr__eq__ms   z_DeprecationHelperStr.__eq__N)__name__ __module__ __qualname__r&r/r1r4rrrrr)bsr)c Cs|jd|}|dur"d|}nd|d|d}|durH|d|7}|j}d}d }d ||} | |vrd }|| |t| |<|d 7}qVqqV|s|||t||<dS) 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! rFZ __pyx_fuse_T)r5Z __pyx_capi__popr)) rZ routine_namenew_namerZold_nameZdepdocdjZ has_fusedZ fused_namerrrdeprecate_cython_apius"!   r?versioncs4durd}t|fdd}|dur0||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]6\}}|jtjkr:|q|jtjkr|qt fdd}|S)Ncst|t}|dkr&|i|Sddtd||| dD}d|}tjd|ddtdd |tj|fi|S) NrcSsg|]\}}|d|qS)=r).0nameargrrr szi_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 )lenzipjoinrrrupdate parameters)rr extra_argsZargs_msg)all_argsf kwonly_argssigrArrinner_fs   zU_deprecate_positional_args.._inner_deprecate_positional_args..inner_f) rrKitemskindrPOSITIONAL_OR_KEYWORDappend KEYWORD_ONLYr$r%)rNrDparamrQr@)rMrNrOrPr _inner_deprecate_positional_argss    zD_deprecate_positional_args.._inner_deprecate_positional_args) ValueError)funcrArrXrr@r_deprecate_positional_argss  &r[)r)NN)N)inspectrrr$r importlibr__all__objectZ_NoValuerrr)r?r[rrrrs  @  @