Edit File: legacy.cpython-37.pyc
B ��4] � @ sN d Z ddlmZ ddd�Zdd� Zdd � Zd d � Zd d � Zdd� Zdd� Z dS )zhRoutines to handle adaption of legacy call signatures, generation of deprecation notes and docstrings. � )�utilNc s � ��fdd�}|S )Nc s& t | d�sg | _| j��� �f� | S )N�_legacy_signatures)�hasattrr �append)�fn)�argnames� converter�since� �J/opt/alt/python37/lib64/python3.7/site-packages/sqlalchemy/event/legacy.py�leg s z _legacy_signature.<locals>.legr )r r r r r )r r r r �_legacy_signature s r c s� x��j D ]~\}� �� d dkr0d�� dd� � nd�t� �t|j�kr�t|j�kr�rp�r`t���fdd�}n� ���fdd�}|S qW �S d S ) N���z**kwT� Fc s �� | � � S )Nr )�args)�convr r r �wrap_leg) s z%_wrap_fn_for_legacy.<locals>.wrap_legc s< t t�j| ��� � fdd��D �} �r0�| |�S �| � S d S )Nc s g | ] }� | �qS r r )�.0�name)�argdictr r � <listcomp>0 s z9_wrap_fn_for_legacy.<locals>.wrap_leg.<locals>.<listcomp>)�dict�zip� arg_names)r �kw)r �dispatch_collectionr �has_kw)r r r . s )�legacy_signatures�lenr �bool�varkw�AssertionError)r r Zargspecr r r )r r r r r r �_wrap_fn_for_legacy s r" c s d� � fdd�| �d�D ��S )N� c 3 s | ]}� | V qd S )Nr )r �line)�indentr r � <genexpr>< s z_indent.<locals>.<genexpr>)�join�split)�textr% r )r% r �_indent; s r* c C s� t d�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# c s s | ]}d d|i V qdS )z%(arg)s = kw['%(arg)s']�argNr )r r+ r r r r& B s z+_standard_listen_example.<locals>.<genexpr>r r z c s s | ]\}}}|V qd S )Nr )r r r r r r r r& I s 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)� z, **kwz, )� current_since� event_name�has_kw_arguments�named_event_arguments�example_kw_arg� sample_target)r* r' r r �maxr �__name__r )r r3 r r2 r. r) r r r �_standard_listen_example? s. r6 c C sH d}x>| j D ]4\}}}|d||j| jr*dndd�|�|d� 7 }q W |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 **kwz, )r r/ r0 r1 r3 )r r5 r r' )r r3 r r) r r r r r r �_legacy_listen_examplesp s r7 c C s: |j d \}}}d|| j|jd�|j�|jr0dndd� 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.z, z, **kwr- )r Zclsnamer/ r1 r0 )r r5 r r' r r )�parent_dispatch_clsr r r r r r r �_version_signature_changes� s r9 c C s` 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* r6 r r7 r9 r Zinject_docstring_text�__doc__)r r8 r �headerr3 r) r r r �_augment_fn_docs� s r? )N) r= r- r r r" r* r6 r7 r9 r? r r r r �<module> s !1