U xž^ã@sNdZddlmZddd„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‡‡‡fdd„}|S)Ncs&t|dƒsg|_|j ˆˆˆf¡|S)NÚ_legacy_signatures)ÚhasattrrÚappend)Úfn©ÚargnamesÚ converterÚsince©ú?/tmp/pip-install-dq5v43_d/SQLAlchemy/sqlalchemy/event/legacy.pyÚlegs z_legacy_signature..legr )r rr r r rr Ú_legacy_signaturesrcsŽˆjD]‚\}‰‰ˆddkr.d‰ˆdd…‰nd‰tˆƒt|jƒkrˆt|jƒkrˆrnˆr^t‚‡‡fdd„}n‡‡‡‡fdd„}|SqˆS) Néÿÿÿÿz**kwTéFcs ˆˆ|ŽŽS©Nr )Úargs)Úconvrr r Úwrap_leg)sz%_wrap_fn_for_legacy..wrap_legcs<ttˆj|ƒƒ‰‡fdd„ˆDƒ}ˆr0ˆ||ŽSˆ|ŽSdS)Ncsg|] }ˆ|‘qSr r )Ú.0Úname©Zargdictr r Ú 0sz9_wrap_fn_for_legacy..wrap_leg..)ÚdictÚzipÚ arg_names)rÚkw)rÚdispatch_collectionrÚhas_kwrr r.s  )Úlegacy_signaturesÚlenrÚboolÚvarkwÚAssertionError)rrZargspecr rr )rrrrrr Ú_wrap_fn_for_legacys ÿ r$csd ‡fdd„| d¡Dƒ¡S)NÚ c3s|]}ˆ|VqdSrr )rÚline©Úindentr r Ú <sz_indent..)ÚjoinÚsplit)Útextr(r r'r Ú_indent;sr-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%css|]}dd|iVqdS)z%(arg)s = kw['%(arg)s']ÚargNr )rr.r r r r)Asÿz+_standard_listen_example..rrz css|]\}}}|VqdSrr )rr rrr r r r)Hsÿafrom 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_nameÚhas_kw_argumentsÚnamed_event_argumentsÚexample_kw_argÚ sample_target)r-r*rrÚmaxr Ú__name__r)rr8rr7r3r,r r r Ú_standard_listen_example?s8  þûþ ÿ ÿ ÿ   ø r;c CsDd}|jD]4\}}}|d||j|jr(dndd |¡|dœ7}q |S)Nr0a& # 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 **kwr2)r r4r5r6r8)rr:rr*)rr8rr,r rrr r r Ú_legacy_listen_examplespsÿùùÿr<cCs:|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.r2r1r0)r Zclsnamer4r6r5)rr:rr*rr)Úparent_dispatch_clsrr rrr r r Ú_version_signature_changesˆs  ûúÿr>cCs`d}t|ddƒ}|tt|||ƒdƒ}|jrP|tt|||ƒdƒ7}|t||ƒ7}t |j|d¡S)Nz@.. container:: event_signatures Example argument forms:: Z_target_class_docÚobjz é) Úgetattrr-r;rr<r>rZinject_docstring_textÚ__doc__)rr=rÚheaderr8r,r r r Ú_augment_fn_docs›s"ÿ  þ þÿrD)N) rBr0rrr$r-r;r<r>rDr r r r Ús  !1