UgddlmZmZddlZddlZddlmZdgZeZ dddZ ddZ Gd d Z dd Z ddd d ZdS)) Parameter signatureN) import_module _deprecated)correct_modulec| d|d|}nd|}||vrtd|d|d|d|d|d tt||d}|d|d |d |d|d }n!d|d|d|d |d|d |d|d|d|d|d}tj|t d|D]L} ttd|d||cS#t$r} ||dkr| Yd} ~ Ed} ~ wwxYwdS)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) sub_packagemoduleprivate_modulesall attributercorrect_importattrmessagees U/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/scipy/_lib/deprecation.py_sub_module_deprecationrs2,!@+@@@@/+// 3k 3 3F 3 3  3 3#. 3 317 3 3 3   =00)T B BD  3i 3 3^ 3 3% 3 3(. 3 3 3  /k / /F / /Y / /% / /(. / /! / /$* / /-6 / /0; / />D / / /  M'$61EEEE! =)H+)H)H)H)HII9UU U U U   ,,, HHHH  s&"C  C-C((C-cfd}|S)z2Deprecate a function by emitting a warning on use.cttr!tjdtdSt jfd}j|_|S)NzTrying to deprecate class rr cLtjt|i|S)Nr )rrr)argskwargsfunmsgr s rcallz'_deprecated..wrap..callWs9 M#(:%/ 1 1 1 13''' ') isinstancetyperrRuntimeWarning functoolswraps__doc__)r%r'r&r s` rwrapz_deprecated..wrapPs c4   M4S44'A 7 7 7 7J    ( ( ( ( ( (   ({  r()r&r r/s`` rrrNs)       Kr(c$eZdZdZdZdZdZdS)_DeprecationHelperStrz3 Helper class used by deprecate_cython_api c"||_||_dSN)_content_message)selfcontentrs r__init__z_DeprecationHelperStr.__init__fs  r(c*t|jSr4)hashr5)r7s r__hash__z_DeprecationHelperStr.__hash__jsDM"""r(cb|j|k}|r!tj|jtd|S)Nrr )r5rrr6r)r7otherress r__eq__z_DeprecationHelperStr.__eq__ms>}%  ( M$-2D%& ( ( ( ( r(N)__name__ __module__ __qualname__r.r9r<r@r0r(rr2r2bsK   ###r(r2c6|jd|}|d|z}n d|d|d}||d|zz }|j}d}d } d ||} | |vr.d }|| |t| |<|d z }nn;|s(|||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. r Nz`%s` is deprecated!`z` is deprecated, use `z ` instead! rFT __pyx_fuse_)rA __pyx_capi__popr2) r routine_namenew_namerold_namedepdocdj has_fused fused_names rdeprecate_cython_apirSusB/22L22H&1IXIIXIII$. A AI414l44 ??I;<55;L;LA#J77 8 FAA  M9:|9L9L  f 5 5666MMr()versioncRd}t|fd}| ||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 changedcdtggjD]Z\}}|jtjkr|0|jtjkr|[tj fd}|S)Nct|tz }|dkr|i|Sdtd||| dD}d|}tjd|ddt d|tj|d i|S) Nrc"g|] \}}|d| S)=r0).0nameargs r zi_deprecate_positional_args.._inner_deprecate_positional_args..inner_f..s6D##r(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 r0)lenzipjoinrrrupdate parameters) r#r$ extra_argsargs_msgall_argsf kwonly_argssigrTs rinner_fzU_deprecate_positional_args.._inner_deprecate_positional_args..inner_fsTS]]2JQq$)&)))!$[*%=tZKLL?Q!R!RHyy**H M9x99")999 #     MM#cnd33 4 4 41;;v;; r() rrbitemskindrPOSITIONAL_OR_KEYWORDappend KEYWORD_ONLYr,r-)rfr[paramrirergrhrTs` @@@r _inner_deprecate_positional_argszD_deprecate_positional_args.._inner_deprecate_positional_argssll >//11 ) )KD%zY<<<%%%%y555""4(((              0r() ValueError)funcrTr&rps ` r_deprecate_positional_argsrssTIoo$$$$$L //555 ++r()r)NNr4)inspectrrr,r importlibr__all__object_NoValuerrr2rSrsr0r(rrys((((((((###### / 6887;=====@(&;M;M;M;M@:,T:,:,:,:,:,:,:,r(