3
T'ícä
ã @ s¨ d Z ddlZddlZddlmZ ddlmZmZmZ G dd de Z
G dd de Z e
Z
i feeeef ee eeef dd d
d ZG d d
d
ZG dd deZdS )z)Sphinx deprecation classes and utilities.é N)Ú
import_module)ÚAnyÚDictÚTypec @ s e Zd ZdS )ÚRemovedInSphinx50WarningN)Ú__name__Ú
__module__Ú __qualname__© r
r
ú4/tmp/pip-build-gk9425m9/sphinx/sphinx/deprecation.pyr s r c @ s e Zd ZdS )ÚRemovedInSphinx60WarningN)r r r r
r
r
r r
s r )ÚmodnameÚobjectsÚwarningÚnamesÚreturnc C s" t | }t|| |||tj| < d S )N)r Ú_ModuleWrapperÚsysÚmodules)r
r r r Úmoduler
r
r Údeprecated_alias s r c @ sH e Zd Zeeeeef ee eeef ddddZ eedddZ
dS )r N)r r
r r r r c C s" || _ || _|| _|| _|| _d S )N)Ú_moduleÚ_modnameÚ_objectsÚ_warningÚ_names)Úselfr r
r r r r
r
r Ú__init__ s
z_ModuleWrapper.__init__)Únamer c C sr || j krt| j|S | jj|d }|d k rLtjdj| j||| j dd n tjdj| j|| j dd | j | S )Nz^The alias '{}.{}' is deprecated, use '{}' instead. Check CHANGES for Sphinx API modifications.é )Ú
stacklevelz@{}.{} is deprecated. Check CHANGES for Sphinx API modifications.)
r Úgetattrr r ÚgetÚwarningsÚwarnÚformatr r )r r Úcanonical_namer
r
r Ú __getattr__& s
z_ModuleWrapper.__getattr__) r r r r Ústrr Úobjectr ÚWarningr r' r
r
r
r r s
r c s e Zd ZdZeeee dd fdd Zee dd fdd Z
dee e d fd
d
Z edd fd
d Z dee e d fdd
Z
edd fdd Z ZS )ÚDeprecatedDictz-A deprecated dict which warns on each access.N)ÚdataÚmessager r c s || _ || _t j| d S )N)r- r Úsuperr )r r, r- r )Ú __class__r
r r : s zDeprecatedDict.__init__)ÚkeyÚvaluer c s& t j| j| jdd t j|| d S )Né )r )r# r$ r- r r. Ú __setitem__)r r0 r1 )r/ r
r r3 ? s zDeprecatedDict.__setitem__)r0 Údefaultr c s" t j| j| jdd t j||S )Nr2 )r )r# r$ r- r r. Ú
setdefault)r r0 r4 )r/ r
r r5 C s zDeprecatedDict.setdefault)r0 r c s t j| j| jdd t j|S )Nr2 )r )r# r$ r- r r. Ú __getitem__)r r0 )r/ r
r r6 G s zDeprecatedDict.__getitem__c s" t j| j| jdd t j||S )Nr2 )r )r# r$ r- r r. r" )r r0 r4 )r/ r
r r" K s zDeprecatedDict.get)Úotherr c s$ t j| j| jdd t j| d S )Nr2 )r )r# r$ r- r r. Úupdate)r r7 )r/ r
r r8 O s zDeprecatedDict.update)N)N)r r r Ú__doc__r r( r r* r r r3 r5 r6 r" r8 Ú
__classcell__r
r
)r/ r r+ 7 s r+ )r9 r r# Ú importlibr Útypingr r r ÚDeprecationWarningr ÚPendingDeprecationWarningr ZRemovedInNextVersionWarningr( r) r* r r Údictr+ r
r
r
r Ú<module> s .