B

�WnT1�3i�@sNdZd
dl
mZ
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.

�)
�utilNcs��
�fd
d�}|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�legs




z_legacy_signature.<locals>.legr
)r	rrrr
)rrr	r�_legacy_signatures
r
cs�x��jD]~\}��
�d
dkr0d��dd
��nd�t
��
t
|j�
kr�t|j�
kr�
rp�r`t�
�
�fdd�}n����fdd�}|SqW�SdS)	N���z**kwT�Fc
s�
�|��S)
Nr
)
�args)�convrr
r�wrap_leg)s
z%_wrap_fn_for_legacy.<locals>.wrap_legcs<tt
�j|��
��f
d
d��
D�
}�r0�||
�
S�|�SdS)Nc
sg|]}
�|
�qSr
r
)�.0�name)
�argdictr
r�
<listcomp>0sz9_wrap_fn_for_legacy.<locals>.wrap_leg.<locals>.<listcomp>)�dict�zip�	arg_names)r�kw)r�dispatch_collectionr�has_kw)
rrr.s





)�legacy_signatures�lenr�bool�varkw�AssertionError)rrZargspecr	rr
)rrrrrr�_wrap_fn_for_legacys






r"csd
��f
dd�|�
d
�
D�
�
S)N�

c
3s|]}
�|
V
qdS)
Nr
)r�line)
�indentr
r�	<genexpr><sz_indent.<locals>.<genexpr>)�join�split)�textr%r
)
r%r�_indent;s
r*cCs�td
�
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
ss|]}
dd
|
i
V
qdS)z%(arg)s = kw['%(arg)s']�argNr
)rr+r
r
rr&Bs
z+_standard_listen_example.<locals>.<genexpr>rr
z    c
ss|]\}
}}|
V
qdS)
Nr
)rr	rrr
r
rr&Is
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'rr�maxr�__name__r)rr3rr2r.r)r
r
r�_standard_listen_example?s.






	

	







r6c	CsHd
}x>|jD]4\}}}|d||j
|jr*dnd
d�|�
|
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/r0r1r3)rr5rr')rr3rr)r	rrr
r
r�_legacy_listen_examplesps








r7cCs:|
jd
\}}}d||j
|
jd�|
j�
|
jr0dndd�S)Nra>

.. 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/r1r0)rr5rr'rr)�parent_dispatch_clsrr	rrr
r
r�_version_signature_changes�s





r9cCs`d
}t|
dd�}|t
t|||�d�}|jrP|t
t|||�d�7}|t|
|�7}t�|j|d�S)Nz@.. container:: event_signatures

     Example argument forms::

Z_target_class_doc�objz        �
)	�getattrr*r6rr7r9rZinject_docstring_text�__doc__)rr8r�headerr3r)r
r
r�_augment_fn_docs�s









r?)
N)
r=r-rr
r"r*r6r7r9r?r
r
r
r�<module>s

!1