o =a~@sNdZddlmZdddZddZdd Zd d Zd d ZddZddZ dS)zhRoutines to handle adaption of legacy call signatures, generation of deprecation notes and docstrings. )utilNcsfdd}|S)Ncs&t|dsg|_|jf|S)N_legacy_signatures)hasattrrappend)fnargnames convertersinceM/var/www/html/gps/gps/lib/python3.10/site-packages/sqlalchemy/event/legacy.pylegs z_legacy_signature..legr )r rr r r rr _legacy_signaturesrcsjD]b\ddkrdddndtt|jkret|juredjdjr5dnd f}d jj|frVrIJfd d }|Sfd d }|SqS)Nz**kwTFz def %s(%s%s), , **kwzThe 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"cstjd|S)Nversion)rwarn_deprecated)args)convrr warning_txtr r wrap_leg;s z%_wrap_fn_for_legacy..wrap_legcsJtjdttj|fddD}r!|i|S|S)Nrcsg|]}|qSr r ).0nameargdictr r Dsz9_wrap_fn_for_legacy..wrap_leg..)rrdictzip arg_names)rkw)rdispatch_collectionrhas_kwr rrr rAs ) legacy_signatureslenrboolvarkwrjoinr"clsname)r$rargspec formatted_defrr )rrr$rr%r rr _wrap_fn_for_legacys:     r.csdfdd|dDS)N c3s|]}|VqdSNr )rlineindentr r Psz_indent..)r*split)textr3r r2r _indentOsr7cCstddd|jddDd}|jr tdd|jD}nd}d}||r+d |nd |j|jr3d nd d |j||d ;}|S)Nr/css|] }dd|iVqdS)z%(arg)s = kw['%(arg)s']argNr )rr8r r r r4Us  z+_standard_listen_example..rrz css|]\}}}|VqdSr0r )rr rrr r r r4\s  zfrom 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) ... z (arguments as of %s)rrr) current_since event_namehas_kw_argumentsnamed_event_argumentsexample_kw_arg sample_target)r7r*r"r&max__name__r%)r$r>rr=r9r6r r r _standard_listen_exampleSs0        rAc CsDd}|jD]\}}}|d||j|jrdndd||d7}q|S)Nra& # 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;r<r>)r&r@r%r*)r$r>rr6r rrr r r _legacy_listen_examplesxsrBcCs@|jd\}}}d||j|jd|j|jrddSddS)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.rrr)r r+r:r<r;)r&r@rr*r"r%)parent_dispatch_clsr$r rrr r r _version_signature_changess  rDcCs`d}t|dd}|tt|||d}|jr(|tt|||d7}|t||7}t|j|dS)Nz@.. container:: event_signatures Example argument forms:: _target_class_docobjz ) getattrr7rAr&rBrDrinject_docstring_text__doc__)r$rCrheaderr>r6r r r _augment_fn_docss    rLr0) rJrrrr.r7rArBrDrLr r r r s   5%