U |eh @s<ddlZddlZdgZd ddZGdddZd ddZdS) N _deprecatedcsfdd}|S)z2Deprecate a function by emitting a warning on use.csJttr$tjdtddStfdd}j|_|S)NzTrying to deprecate class {!r}rcategory stacklevelcstjtd||S)Nr)warningswarnDeprecationWarning)argskwargs)funmsgrS/var/www/website-v5/atlas_env/lib/python3.8/site-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)selfcontentmessagerrr__init__sz_DeprecationHelperStr.__init__cCs t|jSr)hashr)rrrr__hash__#sz_DeprecationHelperStr.__hash__cCs$|j|k}|r tj|jtdd|S)Nrr)rrrrr )rotherresrrr__eq__&s   z_DeprecationHelperStr.__eq__N)__name__ __module__ __qualname__rr!r#r&rrrrrsrc Csd|j|}|dkr d|}n d||f}|dk r@|d|7}|j}d}d}d||} | |krd }|| |t| |<|d 7}qNqqN|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. z{}.{}Nz`%s` is deprecated!z%`%s` is deprecated, use `%s` instead! rFz__pyx_fuse_{}{}T)rr' __pyx_capi__popr) moduleZ routine_namenew_namer old_namedepdocdjZ has_fusedZ fused_namerrrdeprecate_cython_api.s&!    r4)r)NN)rr__all__rrr4rrrrs