Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
local
/
lib
/
python3.10
/
dist-packages
/
sqlalchemy
/
util
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: deprecations.cpython-310.pyc
o [�h� � @ 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� Z d#dd�Zdd� Zdd � Z d$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 � t j| tj|d� d S �N�� stacklevel��warnings�warnr �SADeprecationWarning��msgr � r �G/usr/local/lib/python3.10/dist-packages/sqlalchemy/util/deprecations.py�warn_deprecated � r c C r r )r r r �SAPendingDeprecationWarningr r r r �warn_pending_deprecation r r �__init__c s$ d| �pdf �� ��fdd�}|S )N�.. 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 �deprecated_cls s r) Tc �8 |r d| �pdf � nd� �du rd�� �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. r r N�$Call to deprecated function %(func)sc � t | tj�t| jd� � �S r )�_decorate_with_warningr r r! �__name__��fn�r% r& r r r' E � �z deprecated.<locals>.decorater �r( r& � add_deprecation_to_docstringr' r r1 r � deprecated, s r5 c s8 i � �� � D ] \}\}}t|�� |< q� �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 ur.tt|jt|j�t|j� d � |j���t������ t��� ���nd� t���t � ���fdd��}| j d urG| j pHd}|rWt |dd� �� � D ��}|| �}||_ |S )Nr c sf � D ]}|| �| krt j�| tjdd� q�D ]}||v r+t j�| tjdd� q| |i |��S �Nr r r )r0 �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 )r r r )�.0�paramr( r& r r r � <dictcomp>� s ��z7deprecated_params.<locals>.decorate.<locals>.<dictcomp>)r �inspect_getfullargspecr< r! �zipr7 �len�set� intersection� differencer �__doc__r �items)r0 �specr> �doc� decorated�r= �specs)r: r; r< r r' d s2 ����z#deprecated_params.<locals>.decorate)rI �_sanitize_restructured_text)rN r@ r( r& r' r rM r �deprecated_paramsP s +rP c r* )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 Nr+ c r, r )r- r r r! r. r/ r1 r r r' � r2 z%pending_deprecation.<locals>.decorater r3 r r1 r �pending_deprecation� s rQ c C s | d u r|S t |� | S �N)r )�parameter_value� default_value� warning_textr r r �deprecated_option_value� s rV c C s dd� }t �d|| �S )Nc S s$ | � dd�\}}|dv r|d7 }|S )Nr r )r �methz())�group)r9 �type_�namer r r �repl� s z)_sanitize_restructured_text.<locals>.replz\:(\w+)\:`~?\.?(.+?)`)�re�sub)�textr[ r r r rO � s rO c C s� | j d ur| j p d}|d ur?|t|d�; }t||d�}t| �tu r7t| j�}||d< t| j| j|�} || }n|| _ t| |�}t| |t |||d �� | S )Nr r r rH ) rH r! r �type�__dict__r. � __bases__�getattr�setattrr- )r" r$ �wtyper& �docstring_headerrK �clsdict�constructor_fnr r r r � s" �r c st t � �� t� �fdd��}| jdur| jpd}|dur)|t| jd�; }t||d�}|| �}||_� �fdd�|_|S ) z=Wrap a function with a warnings.warn and augmented docstring.c s t j� �dd� | |i |��S r6 �r r )r0 r7 r8 �r& rd r r r> � s z&_decorate_with_warning.<locals>.warnedNr r r c s t j� �dd�S r6 rh r ri r r �<lambda>� s z(_decorate_with_warning.<locals>.<lambda>)rO r rH r! r. r �_sa_warn)r rd r& re r> rK rL r ri r r- � s r- )r )r )NTrR )rH r\ r r r � langhelpersr r r r r r r) r5 rP rQ rV rO r r- r r r r �<module> s( $C �& �
Save
Cancel