관리-도구
편집 파일: deprecations.cpython-38.pyc
U -?�f�. � @ s d Z ddlmZ ddlZddlmZ ddlmZ ddlmZ ddlmZ ddlm Z dd lm Z dd lm Z dd lm Z dd lm Z dd lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ eded�Zeddd�ZdNd d d d d d d!�d"d#�ZdOd d d d d d%�d&d'�Z dPd d(d d d d d)�d*d+�Z dQd d d d-d.�d/d0�Z dRd d d2d3d2d4d5�d6d7�Z d d8d9d:�d;d<�Z dSd d d8d4d=�d>d?�Z!d@d4dA�dBdC�Z"d d dD�dEdF�Z#dTdGd d d d d dGdH�dIdJ�Z$dUdd d d d d2ddK�dLdM�Z%dS )VzSHelpers related to deprecation of functions, methods, classes, other functionality.� )� annotationsN)�Any)�Callable)�Dict)�Match)�Optional)�Sequence)�Set)�Tuple)�Type)�TypeVar)�Union� )�compat)�_hash_limit_string)�_warnings_warn)� decorator)�inject_docstring_text)�inject_param_text� )�exc�_T)�bound�_FzCallable[..., Any]�strz Type[exc.SADeprecationWarning]�intz Optional[str]�None)�msg�version�type_� stacklevel�code�returnc C s& || |d�}||_ t||d d� d S )N�r! r �r )Zdeprecated_sincer )r r r r r! �warn� r& �L/opt/hc_python/lib64/python3.8/site-packages/sqlalchemy/util/deprecations.py�_warn_with_version* s r( � )r r r r! r" c C s t | |tj||d� d S )Nr# )r( r �SADeprecationWarning)r r r r! r& r& r' �warn_deprecated7 s �r+ z Sequence[Any])r �argsr r r! r" c C s( |rt | d|�} t| |tj||d� dS )zhIssue a deprecation warning with a parameterized string, limiting the number of registrations. � r# N)r r( r r* )r r, r r r! r& r& r' �warn_deprecated_limited? s �r. �__init__z Callable[[Type[_T]], Type[_T]])r �message� constructorr" c s. d��p df �ddd�� ���fdd� }|S )N�.. deprecated:: %s %s� �Type[_T])�clsr" c s t | � tj�t� d� ���S )N��func)�_decorate_cls_with_warningr r* �dict)r5 �r1 �headerr0 r r& r' �decorateV s �z deprecated_cls.<locals>.decorater& )r r0 r1 r< r& r: r' �deprecated_clsQ s r= T�boolz(Optional[Type[exc.SADeprecationWarning]]zCallable[[_F], _F])r r0 � add_deprecation_to_docstring�warning�enable_warningsr" c s` |rd��pdf �nd��dkr&d��dkr4t j��d� 7 �ddd�� ����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. r2 r3 Nz$Call to deprecated function %(func)sz (deprecated since: %s)r ��fnr" c s8 �d k s t ��d k st �t| ��t| jd� ��� d�S )Nr6 )rA )�AssertionError�_decorate_with_warningr9 �__name__)rC �rA r; r0 r r@ r& r' r< � s �z deprecated.<locals>.decorate)r r* )r r0 r? r@ rA r< r& rG r' � deprecatedc s � rH r z0Callable[[Callable[..., _T]], Callable[..., _T]])r0 �kwr" c K s t d| tjd�|��S )N�2.0�r0 r@ )rJ )rH r ZMovedIn20Warning)r0 rI r& r& r' �moved_20� s � ��rL )�api_name� alternativerI r" c K s� t �d| �}|r(dddd�|�d� }nd}d| |d f }d | krl|�d d �}|sl|�d �d ksltd| ��|r||d| 7 }tj}td||d�|��S )Nz^:(attr|func|meth):� attribute�function�method)�attrr7 �methr Z constructzPThe %s %s is considered legacy as of the 1.x series of SQLAlchemy and %s in 2.0.zbecomes a legacy constructz:attr:Zwarn_on_attribute_accessFrA z�attribute %s will emit a warning on read access. If you *really* want this, add warn_on_attribute_access=True. Otherwise please add enable_warnings=False.� rJ rK )rJ ) �re�match�group�pop�getrD r ZLegacyAPIWarningrH )rM rN rI Ztype_regr r0 Z attribute_okZ warning_clsr& r& r' �became_legacy_20� s2 ���� �� rZ zTuple[str, str])�specsr" c s^ i � i �i ��� � D ]*\}\}}|�|< t|�� |< tj�|< qddd�� ���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." ) ) r rB c s t �| �}|jd k r\tt|jt|j�t|j� d � |j���t������t��� ���n:|j d k r�|j �t������t��� ���n d�t���|j � t ddddd�� ������fdd� �}| j d k r�| j p�d}|r�t|dd � ��� D ��}|| �}||_ |S ) Nr& r r �rC r, �kwargsr" c s� �D ]T}�| d kr || d k s<�| d k r|| �| krt �| �| �| dd� q� �kr�t|����r�� d k s|t�t �� �� �� dd� �D ](}||kr�t �| �| �| dd� q�| ||�S �Nr) r$ )r( �set� differencerD )rC r, r] �m)� check_any_kw�check_defaults�check_kw�defaults�messages�version_warnings�versionsr& r' �warned� s> ���� ��z3deprecated_params.<locals>.decorate.<locals>.warnedr3 c S s2 i | ]*\}\}}|d |dkr dn||p(df �qS )r2 rJ z1.4r3 r& )�.0�paramr r0 r& r& r' � <dictcomp> s � �z7deprecated_params.<locals>.decorate.<locals>.<dictcomp>)r Zinspect_getfullargspecre r9 �zipr, �lenr_ � intersectionr` �kwonlydefaults�varkwr �__doc__r �items)rC �specri �doc� decorated�rf r[ rg rh )rb rc rd re r' r< � s< �� &!��z#deprecated_params.<locals>.decorate)rs �_sanitize_restructured_textr r* )r[ rk r r0 r< r& rw r' �deprecated_params� s Iry )�textr" c C s0 ddd�dd�}t �ddd� | �} t �d || �S ) Nz Match[str]r )ra r" c S s$ | � dd�\}}|dkr |d7 }|S )Nr r )r7 rS z()�rW )ra r �namer& r& r' �repl- s z)_sanitize_restructured_text.<locals>.replz:ref:`(.+) <.*>`c S s d| � d� S )Nz"%s"r r{ )ra r& r& r' �<lambda>3 � z-_sanitize_restructured_text.<locals>.<lambda>z \:(\w+)\:`~?(?:_\w+)?\.?(.+?)`)rU �sub)rz r} r& r& r' rx , s rx r4 )r5 r1 �wtyper0 r �docstring_headerr" c C s | j d k r| j pd}|d k r�|d k r2|t|d�; }t|tj�rF|d7 }t||d�}d }t| �tkr�t| j�}||d< |�dd � |�dd � t| j | j |�} |d k r�|| }n|| _ |d k r�t | |�}|d k r�|d k s�t �|d k s�t �t | |t||||d �� | S )Nr3 r6 �@ (Background on SQLAlchemy 2.0 at: :ref:`migration_20_toplevel`)r rr �__dict__� __weakref__)rr r9 � issubclassr �Base20DeprecationWarningr �typer� rX rF � __bases__�getattrrD �setattrrE ) r5 r1 r� r0 r r� ru Zconstructor_fnZclsdictr& r& r' r8 7 sH � ��r8 )r7 r� r0 r r� rA r" c s� t ���t�tj�rd}nd}tddddd�� ���fdd� �}| jdk rP| jpRd}|dk r�|t| jd �; }||7 }t||d �}|| �} || _���fd d �| _ | S ) z=Wrap a function with a warnings.warn and augmented docstring.r� r3 r r r\ c s0 � p|� dd�}|s&t���dd� | ||�S )NZ_sa_skip_warningFr) r$ )rX r( )rC r, r] Z skip_warning�rA r0 r r� r& r' ri { s �z&_decorate_with_warning.<locals>.warnedNr6 r c s t � ��dd�S r^ )r( r& )r0 r r� r& r' r~ � s �z(_decorate_with_warning.<locals>.<lambda>) rx r� r r� r rr r9 rF r Z_sa_warn) r7 r� r0 r r� rA Zdoc_onlyri ru rv r& r� r' rE g s � rE )N)r) N)r) N)r/ )NTNT)N)N)NT)&rr � __future__r rU �typingr r r r r r r r r r r r3 r Z langhelpersr r r r r r r r r( r+ r. r= rH rL rZ ry rx r8 rE r& r& r& r' �<module> s^ � � � � �6 �&e � 5 �