B KLc~@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)fn)argnames convertersince6lib/python3.7/site-packages/sqlalchemy/event/legacy.pylegs z_legacy_signature..legr )r rrr r )rrr r _legacy_signaturesr csxȈjD]\ddkr0dddndtt|jkrt|jkrdjdjrldnd f}d jj|frrt fd d }nfd d }|SqWSdS)Nz**kwTFz def %s(%s%s)z, z, **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)N)version)rwarn_deprecated)args)convrr warning_txtr r wrap_leg;sz%_wrap_fn_for_legacy..wrap_legcsJtjdttj|fddD}r>||S|SdS)N)rcsg|] }|qSr r ).0name)argdictr r Dsz9_wrap_fn_for_legacy..wrap_leg..)rrdictzip arg_names)rkw)rdispatch_collectionrhas_kwr r)rr rAs  ) legacy_signatureslenrboolZvarkwrjoinrclsnameAssertionError)rrZargspecZ formatted_defrr )rrrrr r rr _wrap_fn_for_legacys,    r'csdfdd|dDS)N c3s|]}|VqdS)Nr )rline)indentr r Psz_indent..)r$split)textr*r )r*r _indentOsr.cCstddd|jddDd}|jr@tdd|jD}nd}d}||rVd |nd |j|jrfd nd d |j||d ;}|S)Nr(css|]}dd|iVqdS)z%(arg)s = kw['%(arg)s']argNr )rr/r r r r+Vsz+_standard_listen_example..rrz css|]\}}}|VqdS)Nr )rr rrr r r r+]szfrom 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)rz, **kwz, ) current_since event_namehas_kw_argumentsnamed_event_argumentsexample_kw_arg sample_target)r.r$rr!max__name__r )rr5rr4r0r-r r r _standard_listen_exampleSs(    r8c CsHd}x>|jD]4\}}}|d||j|jr*dndd||d7}q W|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 **kwz, )r r1r2r3r5)r!r7r r$)rr5rr-r rrr r r _legacy_listen_examplesxs r9cCs:|jd\}}}d||j|jd|j|jr0dnddS)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 r%r1r3r2)r!r7rr$rr )parent_dispatch_clsrr rrr r r _version_signature_changess r;cCs`d}t|dd}|tt|||d}|jrP|tt|||d7}|t||7}t|j|dS)Nz@.. container:: event_signatures Example argument forms:: Z_target_class_docobjz ) getattrr.r8r!r9r;rZinject_docstring_text__doc__)rr:rheaderr5r-r r r _augment_fn_docss    rA)N) r?rrr r'r.r8r9r;rAr r r r  s  5%