o Eb` @s<ddlZddlZdgZd ddZGdddZd ddZdS) N _deprecatedcsfdd}|S)z2Deprecate a function by emitting a warning on use.csHttrtjdtddStfdd}|_|S)NzTrying to deprecate class {!r}rcategory stacklevelcstjtd|i|S)Nr)warningswarnDeprecationWarning)argskwargs)funmsgr8/usr/lib/python3/dist-packages/scipy/_lib/deprecation.pycallsz'_deprecated..wrap..call) isinstancetyperrformatRuntimeWarning functoolswraps__doc__)r rr r)r rwrap s z_deprecated..wrapr)r rrrrrrsc@s(eZdZdZddZddZddZdS) _DeprecationHelperStrz3 Helper class used by deprecate_cython_api cCs||_||_dSN)_content_message)selfZcontentmessagerrr__init__s z_DeprecationHelperStr.__init__cCs t|jSr)hashr)rrrr__hash__#s z_DeprecationHelperStr.__hash__cCs$|j|k}|rtj|jtdd|S)Nrr)rrrrr )rotherresrrr__eq__&s  z_DeprecationHelperStr.__eq__N)__name__ __module__ __qualname__rr r"r%rrrrrs  rc Csd|j|}|durd|}nd||f}|dur |d|7}|j}d}d} d ||} | |vrCd}|| |t| |<|d 7}nnq(|sS|||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. z{}.{}Nz`%s` is deprecated!z%`%s` is deprecated, use `%s` instead! rFTz__pyx_fuse_{}{})rr&Z __pyx_capi__popr) moduleZ routine_namenew_namerZold_nameZdepdocdjZ has_fusedZ fused_namerrrdeprecate_cython_api.s,!     r0)r)NN)rr__all__rrr0rrrrs