L`gJ[ B d Z ddlmZ d dZd Zd Zd Zd Zd Zd
Z dS ) zhRoutines to handle adaption of legacy call signatures,
generation of deprecation notes and docstrings.
)utilNc fd}|S )Nc p t | d sg | _ | j f | S )N_legacy_signatures)hasattrr append)fnargnames convertersinces k/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib64/python3.11/site-packages/sqlalchemy/event/legacy.pylegz _legacy_signature..leg sA r/00 '$&B !
$$eXy%ABBB )r r
r r s ``` r
_legacy_signaturer s/ Jr c
j D ]u\ }d dk r
ddd ndt t |j k r/t |j u rr rJ fd}n fd}|c S vS )Nz**kwT Fc | S Nr )argsconvr s r
wrap_legz%_wrap_fn_for_legacy..wrap_leg) s 2ttT{++r c t t j | fdD } r | i |S | S )Nc g | ]
}| S r r ).0nameargdicts r
z9_wrap_fn_for_legacy..wrap_leg..0 s ???dGDM???r )dictzip arg_names)r kwr r
dispatch_collectionr has_kws @r
r z%_wrap_fn_for_legacy..wrap_leg. s^ "3':'Dd#K#K L LG????h???D ) !r42. !r4y(r )legacy_signatureslenr boolvarkw)r$ r argspecr r r
r r% s `` @@@r
_wrap_fn_for_legacyr+ s !4!F x B<6 ! !F "~HHF x==C - - - -&D M=
=
3
3
)!!!z, , , , , , ,
) ) ) ) ) ) ) ) OOO r c l d fd| d D S )N
c 3 " K | ] }|z V
d S r r )r lineindents r
z_indent..< s' @@tVd]@@@@@@r )joinsplit)textr0 s `r
_indentr5 ; s6 99@@@@tzz$/?/?@@@ @ @@r c z t d d | j dd D d }| j r t d | j D }nd }d}t | j dk r|d z
}||rd
|z nd |j | j rd nd d
| j ||dz }|S )Nr- c 3 $ K | ] }d d|iz V dS )z%(arg)s = kw['%(arg)s']argNr )r r8 s r
r1 z+_standard_listen_example..A s?
& 4
r r r z c 3 " K | ]
\ }}}|V d S r r )r r r r s r
r1 z+_standard_listen_example..H s<
!tT
r 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) , **kw, )
current_since
event_namehas_kw_argumentsnamed_event_argumentsexample_kw_arg
sample_target)r5 r2 r" r& maxr' __name__r% )r$ rC r rB r> r4 s r
_standard_listen_examplerF ? s%
*4QqS9
N ,
%8%J
3 ())A--
7
0=@@
k(;(B JHH!%+>+H!I!I(&
D Kr c d}| j D ]5\ }}}|d||j | j rdndd | |dz z
}6|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 **kwr= )r r? r@ rA rC )r& rE r% r2 )r$ rC r r4 r r r s r
_legacy_listen_examplesrH p ss
D 0 B
tT
7 k&-%GG)-4 !.
$ Kr c |j d \ }}}d|| j |j d |j |j rdnddz 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.r= r< r; )r clsnamer? rA r@ )r& rE r r2 r" r% )parent_dispatch_clsr$ r r r s r
_version_signature_changesrL sb +=a@E4 + *3-2%)YY/B/L%M%M,?,F NB
r c d}t |dd }|t t | || d z }| j r5|t t | || d z
}|t || z
}t
j |j |d S )Nz@.. container:: event_signatures
Example argument forms::
_target_class_docobjz ) getattrr5 rF r& rH rL r inject_docstring_text__doc__)r$ rK r headerrC r4 s r
_augment_fn_docsrU s
/1DeLLM G !4mRHH D ,
#$7 K K
* !4
%bj$ : ::r r )
rS r; r r r+ r5 rF rH rL rU r r r
rV s
BA A A. . .b 0 &; ; ; ; ;r