�
���ec@s\dZd
dl
mZ
d
d�
Zd�Zd�Zd�Zd�Zd�Z	d	�Z
d
S(shRoutines to handle adaption of legacy call signatures,
generation of deprecation notes and docstrings.

i(
tutilcs��
�fd
�}|S(Nc

s8t|d
�sg|_
n|j
j���
f�

|S(Nt_legacy_signatures(thasattrR
tappend(
tfn(targnamest	convertertsince(sH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pytlegs



((RRRR((RRRsH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pyt_legacy_signatures
cs
x
�jD]
\���
�d
dkr?t
��dd
!�nt�t��
t|j�
kr
�t|j�
kr
d�jdj�j	�
�r�dndf}d�j
�j�|f��
r��s�t�
�
���fd	�}n������fd
�}|Sq
W�SdS(Ni����s**kwisdef %s(%s%s)s, s, **kwts�The argument signature for the "%s.%s" event listener has changed as of version %s, and conversion for the old argument signature will be removed in a future release.  The new signature is "%s"c
s#tj
�d
��


�
�|��S(Ntversion(Rtwarn_deprecated(
targs(tconvRRtwarning_txt(sH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pytwrap_leg;s

csitj
�d
��


tt�
j|��
}g�D]}||^q2}�r[�||
�S�|�SdS(NR(RRtdicttzipt	arg_names(R
tkwtargdicttname(Rtdispatch_collectionRthas_kwRR(sH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pyRAs





(tlegacy_signaturestTruetFalsetlenR
tbooltvarkwRtjoinRtclsnametAssertionError(RRtargspect
formatted_defR((RRRRRRRsH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pyt_wrap_fn_for_legacys,



!









	cs&d
j�f
d�|j
d
�
D�
�
S(Ns

c
3s|]}
�|
V
qdS(
N((t.0tline(
tindent(sH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pys	<genexpr>Ps(Rtsplit(ttextR'((
R'sH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pyt_indentOs
cCs�td
j
d�|jdd!D�
�
d�}|jrQtd�|jD�
�
}nd}d}|i|rsd|nd	d
6|jd6|jr�dnd	d
6dj
|j�
d6|d6|
d6;}|S(Ns

c
ss |]}
di
|
d
6V
qdS(s%(arg)s = kw['%(arg)s']targN((R%R+((sH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pys	<genexpr>Vs
iis    c
ss|]\}
}}|
V
qdS(
N((R%RR
R((sH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pys	<genexpr>]s
s�from sqlalchemy import event


@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) ...
s (arguments as of %s)R
t
current_sincet
event_names, **kwthas_kw_argumentss, tnamed_event_argumentstexample_kw_argt
sample_target(R*RRRtmaxtNonet__name__R(RR1RR0R,R)((sH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pyt_standard_listen_exampleSs(



		









cCssd
}xf|jD][\}}}|di|d6|j
d6|jrHdnd
d6dj|�
d6|
d	67}qW|S(
NR
s&

# 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) ...
RR-s **kwR.s, R/R1(RR4RR(RR1RR)RR
R((sH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pyt_legacy_listen_examplesxs









csu�jd
\}}}di|d6�
j
d6�jd6dj��
fd��jD�
�
d6�jrld	nd
d6S(Nis=

.. versionchanged:: %(since)s
    The :meth:`.%(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.RR R-s, c
3s4|]*}
di�
jd
6�j
d6|
d6V
qdS(s6:paramref:`.%(clsname)s.%(event_name)s.%(param_name)s`R R-t
param_nameN(R4R(R%R7(Rtparent_dispatch_cls(sH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pys	<genexpr>�sR/s, **kwR
R.(RR4RRRR(R8RRR
R((RR8sH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pyt_version_signature_changes�s







cCs�d
}t|
dd�}|t
t|||�d�}|jru|t
t|||�d�7}|t|
|�7}ntj|j|d�S(	Ns@.. container:: event_signatures

     Example argument forms::

t_target_class_doctobjt
 ii
s        s        (	tgetattrR*R5RR6R9Rtinject_docstring_textt__doc__(RR8RtheaderR1R)((sH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pyt_augment_fn_docs�s



	




N(R?R
RR3R	R$R*R5R6R9RA(((sH/opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/event/legacy.pyt<module>s
	5		%