Edit File: deprecations.cpython-37.pyc
B ��4]� � @ s� d Z ddlZddlZddlmZ ddlmZ ddlmZ ddlmZ dd lm Z d!d d �Z d"d d�Z d#dd�Z d$dd�Z dd� Zd%dd�Zdd� Zdd � Zd&d d �Zd'd d �ZdS )(zSHelpers related to deprecation of functions, methods, classes, other functionality.� N� )�compat)� decorator)�inject_docstring_text)�inject_param_text� )�exc� c C s t j| tj|d� d S )N)� stacklevel)�warnings�warnr �SADeprecationWarning)�msgr � r �O/opt/alt/python37/lib64/python3.7/site-packages/sqlalchemy/util/deprecations.py�warn_deprecated s r c C s t j| tj|d� d S )N)r )r r r �SAPendingDeprecationWarning)r r r r r �warn_pending_deprecation s r �__init__c s$ d| �p df �� ��fdd�}|S )Nz.. deprecated:: %s %s� c s t | � tj�t� d� ��S )N)�func)�_decorate_cls_with_warningr r �dict)�cls)� constructor�header�messager r �decorate s z deprecated_cls.<locals>.decorater )�versionr r r r )r r r r �deprecated_cls s r Tc s8 |rd| �pdf � nd� �dkr&d�� �fdd�}|S )a� Decorates a function and issues a deprecation warning on use. :param version: Issue version in the warning. :param message: If provided, issue message in the warning. A sensible default is used if not provided. :param add_deprecation_to_docstring: Default True. If False, the wrapped function's __doc__ is left as-is. If True, the 'message' is prepended to the docs if provided, or sensible default if message is omitted. z.. deprecated:: %s %sr Nz$Call to deprecated function %(func)sc s t | tj�t| jd� � �S )N)r )�_decorate_with_warningr r r �__name__)�fn)r r r r r E s z deprecated.<locals>.decorater )r r � add_deprecation_to_docstringr r )r r r � deprecated, s r$ c s< i � x$�� � D ]\}\}}t|�� |< qW � �fdd�}|S )a" Decorates a function to warn on use of certain parameters. e.g. :: @deprecated_params( weak_identity_map=( "0.7", "the :paramref:`.Session.weak_identity_map parameter " "is deprecated." ) ) c s� t �| �}|jd k r\tt|jt|j�t|j� d � |j���t������ t��� ���n d� t���t � ���fdd��}| j d k r�| j p�d}|r�t |dd� �� � D ��}|| �}||_ |S )Nr c sj x2� D ]*}|| �| krt j�| tjdd� qW x*�D ]"}||kr:t j�| tjdd� q:W | ||�S )Nr )r )r r r r )r" �args�kwargs�m)�check_defaults�check_kw�defaults�messagesr r �warneds s z3deprecated_params.<locals>.decorate.<locals>.warnedr c S s& i | ] \}\}}d ||pdf |�qS )z.. deprecated:: %s %sr r )�.0�paramr r r r r � <dictcomp>� s z7deprecated_params.<locals>.decorate.<locals>.<dictcomp>)r Zinspect_getfullargspecr* r �zipr% �len�set� intersection� differencer �__doc__r �items)r" �specr, �doc� decorated)r+ �specs)r( r) r* r r d s( z#deprecated_params.<locals>.decorate)r6 �_sanitize_restructured_text)r: r. r r r r )r+ r: r �deprecated_paramsP s +r< c s8 |rd| �pdf � nd� �dkr&d�� �fdd�}|S )aE Decorates a function and issues a pending deprecation warning on use. :param version: An approximate future version at which point the pending deprecation will become deprecated. Not used in messaging. :param message: If provided, issue message in the warning. A sensible default is used if not provided. :param add_deprecation_to_docstring: Default True. If False, the wrapped function's __doc__ is left as-is. If True, the 'message' is prepended to the docs if provided, or sensible default if message is omitted. z .. deprecated:: %s (pending) %sr Nz$Call to deprecated function %(func)sc s t | tj�t| jd� � �S )N)r )r r r r r! )r" )r r r r r � s z%pending_deprecation.<locals>.decorater )r r r# r r )r r r �pending_deprecation� s r= c C s | d kr |S t |� | S d S )N)r )Zparameter_value� default_valueZ warning_textr r r �deprecated_option_value� s r? c C s dd� }t �d|| �S )Nc S s$ | � dd�\}}|dkr |d7 }|S )Nr r )r �methz())�group)r' �type_�namer r r �repl� s z)_sanitize_restructured_text.<locals>.replz\:(\w+)\:`~?\.?(.+?)`)�re�sub)�textrD r r r r; � s r; c C s� | j d k r| j pd}|d k r~|t|d�; }t||d�}t| �tkrnt| j�}||d< t| j| j|�} || }n|| _ t| |�}t| |t |||d �� | S )Nr )r r r5 ) r5 r r �type�__dict__r! � __bases__�getattr�setattrr )r r �wtyper �docstring_headerr8 ZclsdictZconstructor_fnr r r r � s r c st t � �� t� �fdd��}| jdk r*| jp,d}|dk rR|t| jd�; }t||d�}|| �}||_� �fdd�|_|S ) z=Wrap a function with a warnings.warn and augmented docstring.c s t j� �dd� | ||�S )Nr )r )r r )r" r% r& )r rM r r r, � s z&_decorate_with_warning.<locals>.warnedNr )r r c s t j� �dd�S )Nr )r )r r r )r rM r r �<lambda>� � z(_decorate_with_warning.<locals>.<lambda>)r; r r5 r r! r Z_sa_warn)r rM r rN r, r8 r9 r )r rM r r � s r )r )r )r )NT)NT)N)N)r5 rE r r r Z langhelpersr r r r r r r r$ r< r= r? r; r r r r r r �<module> s" $C %