Current File : //opt/alt/python37/lib64/python3.7/site-packages/sqlalchemy/event/__pycache__/legacy.cpython-37.pyc
B
��4] � @ sN d Z ddlmZ ddd�Zdd� Zdd � Zd
d � Zd d
� Zdd� Zdd� Z dS )zhRoutines to handle adaption of legacy call signatures,
generation of deprecation notes and docstrings.
� )�utilNc s � ��fdd�}|S )Nc s& t | d�sg | _| j��� �f� | S )N�_legacy_signatures)�hasattrr �append)�fn)�argnames� converter�since� �J/opt/alt/python37/lib64/python3.7/site-packages/sqlalchemy/event/legacy.py�leg s
z _legacy_signature.<locals>.legr
)r r r r r
)r r r r �_legacy_signature s r
c s� x��j D ]~\}� �� d dkr0d�� dd� � nd�t� �t|j�kr�t|j�kr�rp�r`t���fdd�}n� ���fdd�}|S qW �S d S ) N���z**kwT� Fc s �� | � � S )Nr
)�args)�convr r
r �wrap_leg) s z%_wrap_fn_for_legacy.<locals>.wrap_legc s< t t�j| ��� � fdd��D �} �r0�| |�S �| � S d S )Nc s g | ] }� | �qS r
r
)�.0�name)�argdictr
r �
<listcomp>0 s z9_wrap_fn_for_legacy.<locals>.wrap_leg.<locals>.<listcomp>)�dict�zip� arg_names)r �kw)r �dispatch_collectionr �has_kw)r r r . s
)�legacy_signatures�lenr �boolZvarkw�AssertionError)r r Zargspecr r r
)r r r r r r �_wrap_fn_for_legacy s
r! c s d� � fdd�| �d�D ��S )N�
c 3 s | ]}� | V qd S )Nr
)r �line)�indentr
r � <genexpr>< s z_indent.<locals>.<genexpr>)�join�split)�textr$ r
)r$ r �_indent; s r) c C s� t d�dd� | jdd� D ��d�}| jr@tdd� | jD ��}nd }d}t| j�d kr^|d
7 }||rld | nd |j| jr|d
nd d�| j�||d�; }|S )Nr" c s s | ]}d d|i V qdS )z%(arg)s = kw['%(arg)s']�argNr
)r r* r
r
r r% B s z+_standard_listen_example.<locals>.<genexpr>r r z c s s | ]\}}}|V qd S )Nr
)r r r r r
r
r r% I s a from sqlalchemy import event
# standard decorator style%(current_since)s
@event.listens_for(%(sample_target)s, '%(event_name)s')
def receive_%(event_name)s(%(named_event_arguments)s%(has_kw_arguments)s):
"listen for the '%(event_name)s' event"
# ... (event handling logic) ...
� z�
# named argument style (new in 0.9)
@event.listens_for(%(sample_target)s, '%(event_name)s', named=True)
def receive_%(event_name)s(**kw):
"listen for the '%(event_name)s' event"
%(example_kw_arg)s
# ... (event handling logic) ...
z (arguments as of %s)� z, **kwz, )�
current_since�
event_name�has_kw_arguments�named_event_arguments�example_kw_arg�
sample_target)r) r& r r �maxr �__name__r )r r2 r r1 r- r( r
r
r �_standard_listen_example? s.
r5 c C sH d}x>| j D ]4\}}}|d||j| jr*dndd�|�|d� 7 }q W |S )Nr, a&
# DEPRECATED calling style (pre-%(since)s, will be removed in a future release)
@event.listens_for(%(sample_target)s, '%(event_name)s')
def receive_%(event_name)s(%(named_event_arguments)s%(has_kw_arguments)s):
"listen for the '%(event_name)s' event"
# ... (event handling logic) ...
z **kwz, )r r. r/ r0 r2 )r r4 r r& )r r2 r r( r r r r
r
r �_legacy_listen_examplesp s
r6 c C s: |j d \}}}d|| j|jd�|j�|jr0dndd� S )Nr a>
.. deprecated:: %(since)s
The :class:`.%(clsname)s.%(event_name)s` event now accepts the
arguments ``%(named_event_arguments)s%(has_kw_arguments)s``.
Support for listener functions which accept the previous
argument signature(s) listed above as "deprecated" will be
removed in a future release.z, z, **kwr, )r Zclsnamer. r0 r/ )r r4 r r& r r )�parent_dispatch_clsr r r r r
r
r �_version_signature_changes� s
r8 c C s` d}t |dd�}|tt| ||�d� }| jrP|tt| ||�d�7 }|t|| �7 }t�|j|d�S )Nz@.. container:: event_signatures
Example argument forms::
Z_target_class_doc�objz � ) �getattrr) r5 r r6 r8 r Zinject_docstring_text�__doc__)r r7 r �headerr2 r( r
r
r �_augment_fn_docs� s
r> )N)
r< r, r r
r! r) r5 r6 r8 r> r
r
r
r �<module> s
!1
Mini Shell