U
|
Z ±dT ã @ sª d dl Z d dlmZ d dlmZ d dlZd dlZG dd deZdd Z dd Z
|
d
|
d d d Z ddddZ dd Z ejddG dd dZG dd deZdd ZdS )é N)Úwraps)Ú
|
ModuleTypec @ s e Zd ZdZdS )ÚTrioDeprecationWarningaÿ Warning emitted if you use deprecated Trio functionality.
|
|
As a young project, Trio is currently quite aggressive about deprecating
|
and/or removing functionality that we realize was a bad idea. If you use
|
Trio, you should subscribe to `issue #1
|
<https://github.com/python-trio/trio/issues/1>`__ to get information about
|
upcoming deprecations and other backwards compatibility breaking changes.
|
|
Despite the name, this class currently inherits from
|
:class:`FutureWarning`, not :class:`DeprecationWarning`, because while
|
we're in young-and-aggressive mode we want these warnings to be visible by
|
default. You can hide them by installing a filter or with the ``-W``
|
switch: see the :mod:`warnings` documentation for details.
|
|
N)Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__© r r úFd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\trio/_deprecate.pyr s r c C s
|
d | ¡S )Nz-https://github.com/python-trio/trio/issues/{})Úformat)Úissuer r r
|
Ú_url_for_issue s r c C s, t | dr$t | dr$d | j| j¡S t| S )Nr r ú{}.{})Úhasattrr r r Ústr©Úthingr r r
|
Ú
|
_stringify$ s r é ©Ú
|
stacklevelc C sl |d7 }d t| |¡}|d kr*|d7 }n|d t|¡7 }|d k rV|d t|¡7 }tjt||d d S )Né z {} is deprecated since Trio {}z with no replacementz; use {} insteadz ({})r )r r r ÚwarningsÚwarnr )r Úversionr Úinsteadr Úmsgr r r
|
Úwarn_deprecated* s
|
r r c s fdd}|S )Nc s t fdd}d kr(||jd k r|j}| ¡ }|d7 }|d ¡7 }d k rp|d t¡7 }d k r|d t¡7 }|d7 }||_|S )Nc s t d | |S )N)r r )r ©ÚargsÚkwargs)Úfnr r r r r r
|
Úwrapper< s z,deprecated.<locals>.do_wrap.<locals>.wrapperz
|
|
z.. deprecated:: {}
|
z Use {} instead.
|
z( For details, see `issue #{} <{}>`__.
|
Ú
|
)r r Úrstripr r r )r! r" Údoc©r r r r )r! r
|
Údo_wrap9 s&
|
ÿzdeprecated.<locals>.do_wrapr )r r r r r' r r& r
|
Ú
|
deprecated8 s r( c s@ t || dt dd fdd}| |_| d¡d |_|S )N©r r )r Ú__annotations__)Úassignedc s
|
| |S )zDeprecated alias.r r ©Únew_fnr r
|
r" [ s z!deprecated_alias.<locals>.wrapperÚ.éÿÿÿÿ)r( r r Ú
|
rpartitionr )Z old_qualnamer- r r r" r r, r
|
Údeprecated_aliasZ s
|
r1 T)Úfrozenc @ s6 e Zd Ze Ze ¡ Ze ¡ Ze ¡ Z ejedZ
|
dS )ÚDeprecatedAttribute)ÚdefaultN) r r r ÚobjectÚ_not_setÚattrÚibÚvaluer r r r r r r
|
r3 f s
|
r3 c @ s e Zd Zdd ZdS )Ú_ModuleWithDeprecationsc C sl || j krR| j | }|j}|tjkr*|j}d | j|¡}t||j|j |d |jS d}t
|
| | j|¡d S )Nr r) z!module '{}' has no attribute '{}') Ú__deprecated_attributes__r r3 r6 r9 r r r r r ÚAttributeError)ÚselfÚnameÚinfor r r r r r
|
Ú __getattr__q s
|
|
|
z#_ModuleWithDeprecations.__getattr__N)r r r r@ r r r r
|
r: p s r: c C s t j| }t|_i |_d S )N)ÚsysÚmodulesr: Ú __class__r; )Ú module_nameÚmoduler r r
|
Ú enable_attribute_deprecations s
|
rF )rA Ú functoolsr Útypesr r r7 Ú FutureWarningr r r r r( r1 Úsr3 r: rF r r r r
|
Ú<module> s "
|
|
