U
|
¸ý°d ! ã @ sZ d Z ddlmZ ddlZddlmZ ddlmZ ddlmZ ddlmZ ddlmZ dd lm Z d
|
d l
|
m Z d
|
d l
|
m Z d dl mZ d dlmZ ejr®d
|
dlmZ d
|
dlmZ eeee eedef f Zd0dddddddZddd dd d d Zdddd d!d"Zdd#ddd$d%d&Zddddd$d'd(Z d)ddd*d+d,Z dd)ddd-d.d/Z dS )1zhRoutines to handle adaption of legacy call signatures,
|
generation of deprecation notes and docstrings.
|
|
é )Ú annotationsN)ÚAny)ÚCallable)ÚList)ÚOptional)ÚTuple)ÚTypeé )Ú_ET)Ú_ListenerFnTypeé )Úutil)Ú FullArgSpec)Ú_ClsLevelDispatch)Ú_HasEventsDispatch.Ústrz List[str]z Optional[Callable[..., Any]]z2Callable[[Callable[..., Any]], Callable[..., Any]])ÚsinceÚargnamesÚ converterÚreturnc s ddd fdd }|S )a_ legacy sig decorator
|
|
|
:param since: string version for deprecation warning
|
:param argnames: list of strings, which is *all* arguments that the legacy
|
version accepted, including arguments that are still there
|
:param converter: lambda that will accept tuple of this full arg signature
|
and return tuple of new arg signature.
|
|
zCallable[..., Any])Úfnr c s& t | dsg | _| j f¡ | S )NÚ_legacy_signatures)Úhasattrr Úappend)r ©r r r © úNd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\sqlalchemy/event/legacy.pyÚleg3 s
|
z _legacy_signature.<locals>.legr )r r r r r r r Ú_legacy_signature# s r z_ClsLevelDispatch[_ET]r r )Údispatch_collectionr Úargspecr c sâ j D ]Ö\ d dkr.d dd
ndt t|jkrt|jkrdjd j¡rjdnd f }d
|
jj|f d k r´rt d d d d fd d }n d d d d fdd }| S qS )Néÿÿÿÿz**kwTr Fz def %s(%s%s)ú, ú, **kwÚ zÁ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"r )ÚargsÚkwr c s& t jd d k st | S )N©Úversion)r Úwarn_deprecatedÚAssertionError)r% r& )Úconvr r Ú warning_txtr r Úwrap_lega s z%_wrap_fn_for_legacy.<locals>.wrap_legc sJ t jd ttj| fddD }r>||S | S d S )Nr' c s g | ] } | qS r r )Ú.0Úname©Zargdictr r Ú
|
<listcomp>k s z9_wrap_fn_for_legacy.<locals>.wrap_leg.<locals>.<listcomp>)r r) ÚdictÚzipÚ arg_names)r% r& Zargs_from_dict)r r r Úhas_kwr r, r0 r r- h s
|
)
|
Úlegacy_signaturesÚlenr% ÚboolÚvarkwr/ Újoinr4 Úclsnamer* )r r r Z formatted_defr- r )r r+ r r r5 r r, r Ú_wrap_fn_for_legacy< s6 ÿ
|
|
ýüüÿ
|
r< )ÚtextÚindentr c s d fdd| d¡D ¡S )NÚ
|
c 3 s | ]} | V qd S ©Nr )r. Úline©r> r r Ú <genexpr>w s z_indent.<locals>.<genexpr>)r: Úsplit)r= r> r rB r Ú_indentv s rE r )r Ú sample_targetr r c C s t d dd | jdd
D ¡d}| jr@tdd | jD }nd }d}||rVd | nd
|
|j| jrfd nd
|
d | j¡||d ; }|S )Nr? c s s | ]}d d|i V qdS )z%(arg)s = kw['%(arg)s']ÚargNr )r. rG r r r rC s ÿz+_standard_listen_example.<locals>.<genexpr>r r z c s s | ]\}}}|V qd S r@ r )r. r r% r+ r r r rC s ÿzô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) ...
|
z (arguments as of %s)r$ r# r" )Ú current_sinceÚ
|
event_nameÚhas_kw_argumentsÚnamed_event_argumentsÚexample_kw_argrF )rE r: r4 r6 ÚmaxÚ__name__r5 )r rF r rL rH r= r r r Ú_standard_listen_examplez s0
|
þûþ
|
ÿ ÿ
|
|
ø
|
rO c C sD d}| j D ]4\}}}|d||j| jr(dndd |¡|d 7 }q
|
|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 rI rJ rK rF )r6 rN r5 r: )r rF r r= r r% r+ r r r Ú_legacy_listen_examples£ s ÿùùÿrP z Type[_HasEventsDispatch[_ET]])Úparent_dispatch_clsr r c sJ j d \}}}d|j jd fdd jD ¡ jr@dndd S ) Nr a=
|
.. 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.r" c 3 s" | ]}d j j|d V qdS )z6:paramref:`.%(clsname)s.%(event_name)s.%(param_name)s`)r; rI Ú
|
param_nameN)rN r/ )r. rR ©r rQ r r rC Ï s úýÿz-_version_signature_changes.<locals>.<genexpr>r# r$ )r r; rI rK rJ )r6 rN r/ r: r4 r5 )rQ r r r% r+ r rS r Ú_version_signature_changes¿ s ù óúÿrT )r rQ r r c C s` d}t |dd}|tt| ||d }| jrP|tt| ||d7 }|t|| 7 }t |j|d¡S )Nz@.. container:: event_signatures
|
|
Example argument forms::
|
|
Z_target_class_docÚobjz r ) ÚgetattrrE rO r6 rP rT r Zinject_docstring_textÚ__doc__)r rQ r ÚheaderrF r= r r r Ú_augment_fn_docsÝ s" ÿ
|
þ
|
þ ÿrY )N) rW Ú
|
__future__r Útypingr r r r r r Úregistryr
|
r r$ r Z util.compatr Ú TYPE_CHECKINGÚattrr Úbaser r Z_LegacySignatureTyper r< rE rO rP rT rY r r r r Ú<module> s0 ý:)
|
