ó
    Eñi~&  ã                   óž   • S SK JrJr  S SKrS SKrS SKJr  S SKJr  S/r	\
" 5       rSSS.S jrSS	 jr " S
 S5      rSS jrSSSSS.S jjrg)é    )Ú	ParameterÚ	signatureN)Úimport_module)ÚFunctionDocÚ_deprecatedz1.16.0)Úcorrect_moduleÚdep_versionc                 óÂ  • Ub	  SU  SU 3nOSU  3nXC;  a  [        SU  SU SU SU  SU S35      e[        [        U5      US5      nUb  SU S	U S
U  SU S3	n	O$SU  SU SU SU  SU SU  SU SU SU SU  SU S3n	[        R                  " U	[
        SS9  U H  n [        [        SU  SU 35      U5      s  $    g! [          a  n
XS   :X  a  U
e Sn
A
M>  Sn
A
ff = f)aý  Helper 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``.
dep_version : str, optional
    Version in which deprecated attributes will be removed.
Nzscipy.Ú.z`scipy.z` has no attribute `z`; furthermore, `scipy.z3` is deprecated and will be removed in SciPy 2.0.0.zPlease 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.z` will be removed in SciPy z, and the `scipy.z+` namespace will be removed in SciPy 2.0.0.é   ©ÚcategoryÚ
stackleveléÿÿÿÿ)ÚAttributeErrorÚgetattrr   ÚwarningsÚwarnÚDeprecationWarning)Úsub_packageÚmoduleÚprivate_modulesÚallÚ	attributer   r	   Úcorrect_importÚattrÚmessageÚes              ÚS/home/mande/repo/quber/.venv/lib/python3.13/site-packages/scipy/_lib/deprecation.pyÚ_sub_module_deprecationr       s~  € ð0 Ñ!Ø! + ¨a°Ð/?Ð@‰à! + Ð/ˆàÓÜØ�k�] ! F 8Ð+?À	¸{ð K#Ø#. -¨q°°ð 92ð3ó
ð 	
ô ”= Ó0°)¸TÓB€DàÑà˜i˜[¨°^Ð4Dð EØ%˜ a¨ xð 02ð3ñ 	ð �k�] ! F 8¨1¨Y¨Kð 8Ø%˜ a¨ xð 0Ø!�] ! F 8¨1¨Y¨Kð 8Ø#�}Ð$5°k°]À!ÀFÀ8ð L.ð/ð 	ô ‡M‚M�'Ô$6À1ÒEã!ˆð	Üœ=¨6°+°¸aÀ¸xÐ)HÓIÈ9ÓUÒUò "øô ó 	ð ¨Ñ,Ó,Ø�Ýûð	ús   ÂB?Â?
CÃ	
CÃCc                 ó   ^ ^• U U4S jnU$ )z2Deprecate a function by emitting a warning on use.c                 óØ   >^ • [        T [        5      (       a   [        R                  " ST < 3[        SS9  T $ [
        R                  " T 5      U UU4S j5       nT R                  Ul        U$ )NzTrying to deprecate class é   r   c                  óH   >• [         R                  " T[        TS9  T" U 0 UD6$ )Nr   )r   r   r   )ÚargsÚkwargsÚfunÚmsgr   s     €€€r   ÚcallÚ'_deprecated.<locals>.wrap.<locals>.callZ   s'   ø€ ä�MŠM˜#Ô(:Ø%/ò1á˜Ð' Ñ'Ð'ó    )Ú
isinstanceÚtyper   r   ÚRuntimeWarningÚ	functoolsÚwrapsÚ__doc__)r'   r)   r(   r   s   ` €€r   ÚwrapÚ_deprecated.<locals>.wrapS   s_   ù€ Ü�cœ4× Ñ Ü�MŠMØ,¨S©GÐ4Ü'°Aò7ð ˆJä	�Š˜Ó	ö	(ó 
ð	(ð —{‘{ˆŒØˆr+   © )r(   r   r2   s   `` r   r   r   Q   s   ù€ öð €Kr+   c                   ó*   • \ rS rSrSrS rS rS rSrg)Ú_DeprecationHelperStrée   z+
Helper class used by deprecate_cython_api
c                 ó   • Xl         X l        g ©N©Ú_contentÚ_message)ÚselfÚcontentr   s      r   Ú__init__Ú_DeprecationHelperStr.__init__i   s   € ØŒØ�r+   c                 ó,   • [        U R                  5      $ r9   )Úhashr;   )r=   s    r   Ú__hash__Ú_DeprecationHelperStr.__hash__m   s   € Ü�D—M‘MÓ"Ð"r+   c                 óz   • U R                   U:H  nU(       a$  [        R                  " U R                  [        SS9  U$ )Nr#   r   )r;   r   r   r<   r   )r=   ÚotherÚress      r   Ú__eq__Ú_DeprecationHelperStr.__eq__p   s0   € Ø�}‰} Ñ%ˆÞÜ�MŠM˜$Ÿ-™-Ô2DØ%&ò(àˆ
r+   r:   N)	Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__r1   r?   rC   rH   Ú__static_attributes__r4   r+   r   r6   r6   e   s   † ñò ò#õr+   r6   c                 ó6  • U R                    SU 3nUc  SU S3nO	SU SU S3nUb  USU-   -  nU R                  nSnS	n SU U 3n	X–;   a%  S
nUR                  U	5      U[        X•5      '   US-  nOOM4  U(       d  UR                  U5      U[        X5      '   gg)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   NÚ`z` is deprecated!z` is deprecated, use `z
` instead!Ú
r   FTÚ__pyx_fuse_é   )rJ   Ú__pyx_capi__Úpopr6   )
r   Úroutine_nameÚnew_namer   Úold_nameÚdepdocÚdÚjÚ	has_fusedÚ
fused_names
             r   Údeprecate_cython_apir^   x   sÙ   € ðB —/‘/Ð" ! L >Ð2€HàÑØ�X�JÐ.Ð/‰à�X�JÐ4°X°J¸jÐIˆàÑØ�$˜‘.Ñ ˆà×Ñ€Að 	
€AØ€IØ
Ø" 1 # l ^Ð4ˆ
Ø‹?ØˆIØ;<¿5¹5ÀÓ;LˆAÔ# JÓ7Ñ8Ø�‰F‰Aàñ ö Ø9:¿¹¸|Ó9LˆÔ
 Ó
5Ò6ð r+   Ú )ÚversionÚdeprecated_argsÚcustom_messagec                ó‚   ^^^• Tc  Sn[        U5      eTc
  [        5       O
[        T5      mUUU4S jnU b  U" U 5      $ U$ )aS  Decorator 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.
deprecated_args : set of str, optional
    Arguments to deprecate - whether passed by position or keyword.
custom_message : str, optional
    Custom message to add to deprecation warning and documentation.
z9Need to specify a version where signature will be changedc                 ó¤  >^ ^^^	^
• [        T 5      m	/ m/ mT	R                  R                  5        Hg  u  pUR                  [        R
                  :X  a  TR                  U5        M6  UR                  [        R                  :X  d  MV  TR                  U5        Mi     UUU4S jm
[        R                  " T 5      UUU UU	UU
4S j5       n[        U5      n[        T5      T-
  nST SU ST S3nT(       a  UST ST S	3-  nUT-  nUS
==   U/-  ss'   [        U5      R                  SS5      S   R                  S5      n[        U5      Ul        U$ )Nc                 óˆ   >• TR                  U 5      nU(       a)  SU ST S3nUT-  n[        R                  " U[        SS9  g g )Nz
Arguments zV are deprecated, whether passed by position or keyword. They will be removed in SciPy ú. r   r   )Úintersectionr   r   r   )r&   rg   r   rb   ra   r`   s      €€€r   Úwarn_deprecated_argsÚb_deprecate_positional_args.<locals>._inner_deprecate_positional_args.<locals>.warn_deprecated_argsÛ   sS   ø€ Ø*×7Ñ7¸Ó?ˆLÞØ'¨ ~ð 6Tà%˜Y bð*�ð ˜>Ñ)�Ü—’˜gÔ0BÈqÓQð r+   c                  óN  >• [        U 5      [        T5      -
  nUS::  a  T" U5        T" U 0 UD6$ [        TS U 5      T-
  nSR                  U5      n[        R                  " SU ST
 S3[
        SS9  UR                  [        T	R                  U 5      5        T" U5        T" S0 UD6$ )	Nr   z, z)You are passing as positional arguments: zE. Please change your invocation to use keyword arguments. From SciPy z@, passing these as positional arguments will result in an error.r#   )r   r4   )	ÚlenÚsetÚjoinr   r   r   ÚupdateÚzipÚ
parameters)r%   r&   Ú
extra_argsÚkwonly_extra_argsÚargs_msgÚall_argsra   ÚfÚkwonly_argsÚsigr`   rh   s        €€€€€€€r   Úinner_fÚU_deprecate_positional_args.<locals>._inner_deprecate_positional_args.<locals>.inner_fä   s»   ø€ ô ˜T›¤S¨£]Ñ2ˆJØ˜Q‹Ù$ VÔ,Ù˜$Ð) &Ñ)Ð)ô !$ K°°Ð$<Ó =ÀÑ OÐØ—y‘yÐ!2Ó3ˆHÜ�MŠMà?À¸zð J"à") ð +9ð9ô
 #Øò	ð �M‰Mœ#˜cŸn™n¨dÓ3Ô4Ù  Ô(Ù‘;�v‘;Ðr+   z
.. deprecated:: z
    Use of argument(s) ``z6`` by position is deprecated; beginning in 
    SciPy z, these will be keyword-only. zArgument(s) ``zX`` are deprecated, whether passed by position or keyword; they will be removed in SciPy rf   zExtended SummaryrQ   rS   z 
)r   rp   ÚitemsÚkindr   ÚPOSITIONAL_OR_KEYWORDÚappendÚKEYWORD_ONLYr/   r0   r   rl   ÚstrÚsplitÚlstripr1   )ru   ÚnameÚparamrx   Údocrr   Ú
admonitionrt   rv   rw   rh   rb   ra   r`   s   `      @@@@€€€r   Ú _inner_deprecate_positional_argsÚD_deprecate_positional_args.<locals>._inner_deprecate_positional_argsÐ   sT  ý€ Ü˜‹lˆØˆØˆàŸ>™>×/Ñ/Ö1‰KˆDØ�z‰zœY×<Ñ<Ó<Ø—‘ Ö%Ø—‘œy×5Ñ5Õ5Ø×"Ñ" 4Ö(ñ	 2÷	Rô 
�Š˜Ó	÷	ò 	ó 
ð	ô0 ˜'Ó"ˆÜ Ó,¨Ñ>ÐðØ�	ð Ø+Ð,ð -Øˆ)Ð1ð5ˆ
ö Ø˜^¨OÐ+<ð =$à$+ 9¨Bð0ñ 1ˆJð 	�nÑ$ˆ
ØÐÓ J <Ñ/Óä�#‹h�n‰n˜T 1Ó% aÑ(×/Ñ/°Ó6ˆÜ˜c›(ˆŒàˆr+   )Ú
ValueErrorrl   )Úfuncr`   ra   rb   r(   r†   s    ```  r   Ú_deprecate_positional_argsrŠ   ¸   sK   ú€ ð$ �ØIˆÜ˜‹oÐà.Ñ6”c”e¼CÀÓ<P€O÷=ð~ ÑÙ/°Ó5Ð5à+Ð+r+   )r#   )NNr9   )Úinspectr   r   r/   r   Ú	importlibr   Úscipy._lib._docscraper   Ú__all__ÚobjectÚ_NoValuer    r   r6   r^   rŠ   r4   r+   r   Ú<module>r‘      s\   ðß (Û Û Ý #Ý -ð ˆ/€ñ
 ‹8€ð 7;Èõ?ôD÷(ñ ô&;Mð@Z,°TØ/3ÀB÷Z,r+   