관리-도구
편집 파일: legacy.cpython-311.pyc
� �܋f � �B � d Z ddlmZ d d�Zd� Zd� Zd� Zd� Zd � Zd � Z dS ) zhRoutines to handle adaption of legacy call signatures, generation of deprecation notes and docstrings. � )�utilNc � � ��� ��� fd�}|S )Nc �p �� t | d� � sg | _ | j � ���f� � | S )N�_legacy_signatures)�hasattrr �append)�fn�argnames� converter�sinces ����N/opt/cloudlinux/venv/lib64/python3.11/site-packages/sqlalchemy/event/legacy.py�legz _legacy_signature.<locals>.leg sA �� ��r�/�0�0� '�$&�B� !� � �$�$�e�X�y�%A�B�B�B�� � � )r r r r s ``` r �_legacy_signaturer s/ ���� �� � � � � � � �Jr c � � ����� � j D ]u\ }���d dk r d��dd� �nd�t �� � t |j � � k r/�t |j � � u r�r �rJ ���fd�}n�� ��fd�}|c S �v�S )N���z**kwT� Fc � �� � �| � � S �Nr )�args�convr s ��r �wrap_legz%_wrap_fn_for_legacy.<locals>.wrap_leg) s �� � �2�t�t�T�{�+�+r c � ��� t t �j | � � � � ��fd��D � � } �r �| i |��S �| � S )Nc � �� g | ] }�| �� S r r )�.0�name�argdicts �r � <listcomp>z9_wrap_fn_for_legacy.<locals>.wrap_leg.<locals>.<listcomp>0 s �� �?�?�?�d�G�D�M�?�?�?r )�dict�zip� arg_names)r �kwr r �dispatch_collectionr �has_kws @����r r z%_wrap_fn_for_legacy.<locals>.wrap_leg. s^ ��� � "�3�':�'D�d�#K�#K� L� L�G�?�?�?�?�h�?�?�?�D� � )� !�r�4��2���.� !�r�4�y�(r )�legacy_signatures�lenr �bool�varkw)r$ r �argspecr r r r r% s `` @@@r �_wrap_fn_for_legacyr+ s� ������ �!4�!F� � � ��x�� �B�<�6� !� !��F� ��"��~�H�H��F� �x�=�=�C�� � -� -� -� -�&�D� �M�= � = � 3 � 3 � � )�!�!�!�z�,� ,� ,� ,� ,� ,� ,� )� )� )� )� )� )� )� )� �O�O�O��� r c �l �� d� �fd�| � d� � D � � � � S )N� c 3 �" �K � | ] }�|z V � � d S r r )r �line�indents �r � <genexpr>z_indent.<locals>.<genexpr>< s' �� � � �@�@�t�V�d�]�@�@�@�@�@�@r )�join�split)�textr0 s `r �_indentr5 ; s6 �� � �9�9�@�@�@�@�t�z�z�$�/?�/?�@�@�@� @� @�@r c �z � t d� d� | j dd� D � � � � d� � }| j r t d� | j D � � � � }nd }d}t | j � � dk r|d z }||rd |z nd |j | j rd nd d � | j � � ||d�z }|S )Nr- c 3 �$ K � | ] }d d|iz V � � dS )z%(arg)s = kw['%(arg)s']�argNr )r r8 s r r1 z+_standard_listen_example.<locals>.<genexpr>A s? � � � � � �� &��� � 4� � � � � � r r r z c 3 �" K � | ] \ }}}|V � � d S r r )r r r r s r r1 z+_standard_listen_example.<locals>.<genexpr>H s< � � � � � �!��t�T� � � � � � � r 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)� �, **kw�, )� current_since� event_name�has_kw_arguments�named_event_arguments�example_kw_arg� sample_target)r5 r2 r" r& �maxr' �__name__r% )r$ rC r rB r> r4 s r �_standard_listen_examplerF ? s% � � � � � � � �*�4�Q�q�S�9� � � � � � � � �N� �,� �� � �%8�%J� � � � � � � � � � 3� � � � (�)�)�A�-�-� � 7� �� � ��0�=�@�@� ��k�(;�(B� J�H�H��!%���+>�+H�!I�!I�(�&� � � �D� �Kr c � � d}| j D ]5\ }}}|d||j | j rdndd� |� � |d�z z }�6|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 r? r@ rA rC )r& rE r% r2 )r$ rC r r4 r r r s r �_legacy_listen_examplesrH p ss � � �D� 0� B� � ���t�T� � 7� � �k�&�-�%�G�G��)-���4� � �!.�� � � ���$ �Kr c � � |j d \ }}}d|| j |j d� |j � � |j rdndd�z 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.r= r< r; )r �clsnamer? rA r@ )r& rE r r2 r" r% )�parent_dispatch_clsr$ r r r s r �_version_signature_changesrL � sb � �+�=�a�@��E�4�� +� �*�3�-�2�%)�Y�Y�/B�/L�%M�%M�,?�,F� N���B� � � �r c � � d}t |dd� � }|t t | ||� � d� � z }| j r5|t t | ||� � d� � z }|t || � � z }t j |j |d� � S )Nz@.. container:: event_signatures Example argument forms:: �_target_class_doc�objz � ) �getattrr5 rF r& rH rL r �inject_docstring_text�__doc__)r$ rK r �headerrC r4 s r �_augment_fn_docsrU � s� � � � � � /�1D�e�L�L�M� �G� �!4�m�R�H�H��� � �D� �,� � �� #�$7� �� K� K� � � � �� �*� �!4� � � �� � %�b�j�$�� :� :�:r r ) rS r; r r r+ r5 rF rH rL rU r r r �<module>rV s� ��� � � � � � � �� � � � � � �BA� A� A�.� .� .�b� � �0� � �&;� ;� ;� ;� ;r