�
� h3 � � � U d Z ddlmZ ddlmZmZmZ ddlmZ ddl m
Z
ddl m Z ddl
mZmZmZ G d � d
e� � Zej Ze
ed < ej Ze
ed < ej Ze
ed
< ej Ze
ed< ej Z e
ed< dS )z1
Tools for helping to test Twisted applications.
� )�pformat)�Union�Sequence�Callable)�TestCase)�
NamedConstant� )�compare)�globalLogPublisher� formatEvent�LogLevelc � � e Zd ZdZdeffdeeeef fd�Z d� Z
d� Z d� Z dd �d
e
fd �Zddededefd�Zddefd�Zedefd�� � ZdS )�
LogCapturea5
A helper for capturing stuff logged using Twisted's loggers.
:param fields:
A sequence of field names that :meth:`~LogCapture.check` will use to build
"actual" events to compare against the expected events passed in.
If items are strings, they will be treated as keys info the Twisted logging event.
If they are callable, they will be called with the event as their only parameter.
If only one field is specified, "actual" events will just be that one field;
otherwise they will be a tuple of the specified fields.
� log_level�fieldsc �" � g | _ || _ d S �N)�eventsr )�selfr s �e/builddir/build/BUILD/cloudlinux-venv-1.0.8/venv/lib/python3.11/site-packages/testfixtures/twisted.py�__init__zLogCapture.__init__ s � ��� � �� � � � c �: � | j � |� � d S r )r �append)r �events r �__call__zLogCapture.__call__ s � � � ���5�!�!�!�!�!r c �B � t j | _ | gt _ dS )zStart capturing.N)r �
_observers�original_observers�r s r �installzLogCapture.install# s � �"4�"?�� �)-���%�%�%r c �( � | j t _ dS )zStop capturing.N)r r r r s r � uninstallzLogCapture.uninstall( s � �(,�(?��%�%�%r T)�
order_mattersr$ c
�b � � g }| j D ]R� t � fd�| j D � � � � }t |� � dk r|d }|� |� � �S|rt ||�� � dS t
|� � }g }g }|D ]e} |� |� � }|� |� |� � � � �A# t $ r |� |� � Y �bw xY w|r?t dt |� � �dt |� � �dt |� � ��� � �dS ) aE
Check captured events against those supplied. Please see the ``fields`` parameter
to the constructor to see how "actual" events are built.
:param order_matters:
This defaults to ``True``. If ``False``, the order of expected logging versus
actual logging will be ignored.
c 3 �v �K � | ]3}t |� � r |�� � n�� |� � V � �4d S r )�callable�get)�.0�fieldr s �r � <genexpr>z#LogCapture.check.<locals>.<genexpr>7 s[ �� � � � !6� !6� %� 2:�%� � �!V���u� � � �e�i�i�PU�FV�FV� !6� !6� !6� !6� !6� !6r r r )�expected�actualz.entries not as expected:
expected and found:
z
expected but not found:
z
other entries:
N) r �tupler �lenr r
�list�index�pop�
ValueError�AssertionErrorr )
r r$ r, r- � actual_event�matched� unmatched�entryr1 r s
@r �checkzLogCapture.check, s� �� � ���[� (� (�E� � !6� !6� !6� !6�)-��!6� !6� !6� 6� 6�L��<� � �A�%�%� +�A�� � �M�M�,� '� '� '� '� � O� �X�f� 5� 5� 5� 5� 5� 5��H�~�~�H��G��I� �
8�
8��8� $�N�N�5� 1� 1�E� �N�N�8�<�<��#6�#6�7�7�7�7�� "� ,� ,� ,� �$�$�U�+�+�+�+�+�,���� �
O�$�n�
�W�%�%�%�%�w�x�'8�'8�'8�'8�'�)�:L�:L�:L� &N� O� O� O�
O�
Os � C � C+�*C+����valuer, r1 � attributec � � t |t t | j | d |� � � � �� � dS )ai
Check the string representation of an attribute of a logged ``Failure`` is as expected.
:param expected: The expected string representation.
:param index: The index into :attr:`events` where the failure should have been logged.
:param attribute: The attribute of the failure of which to find the string representation.
� log_failure)r- N)r
�str�getattrr )r r, r1 r< s r �check_failure_textz LogCapture.check_failure_textQ s< � � ���W�T�[��-?�
�-N�PY�%Z�%Z�![�![�\�\�\�\�\�\r r � start_indexc �\ � | j |d� D ]}|� d� � }|r|�� dS )z�
A debugging tool that raises the first failure encountered in captured logging.
:param start_index: The index into :attr:`events` from where to start looking for failures.
Nr> )r r( )r rB r �failures r �raise_logged_failurez LogCapture.raise_logged_failure[ sK � � �[�� � �.� � �E��i�i�
�.�.�G��
� �
�
� � r �testcasec �r � | di |��}|� � � |� |j � � |S )a]
Instantiate, install and add a cleanup for a :class:`LogCapture`.
:param testcase: This must be an instance of :class:`twisted.trial.unittest.TestCase`.
:param kw: Any other parameters are passed directly to the :class:`LogCapture` constructor.
:return: The :class:`LogCapture` instantiated by this method.
� )r! �
addCleanupr# )�clsrF �kw�captures r �makezLogCapture.makef sA � � �#�)�)��)�)�����������G� -�.�.�.��r N)r: r; )r )�__name__�
__module__� __qualname__�__doc__r r r r? r r r r! r# �boolr9 �intrA rE � classmethodr rM rH r r r r s7 � � � � � �
�
� BM�k�@[� � �x��c�8�m�(<� =� � � � �
"� "� "�/� /� /�
@� @� @� 6:� #O� #O� #O�d� #O� #O� #O� #O�J]� ]�3� ]�s� ]�C� ]� ]� ]� ]� � �� � � � � � �H� � � � �[� � � r r �DEBUG�INFO�WARN�ERROR�CRITICALN) rQ �pprintr �typingr r r �unittestr �
constantlyr � r
�twisted.loggerr r r
�objectr �debugrU �__annotations__�inforV �warnrW �errorrX �criticalrY rH r r �<module>rg s0 ��� � � � � � � � � ,� ,� ,� ,� ,� ,� ,� ,� ,� ,� � � � � � � $� $� $� $� $� $� � � � � � � D� D� D� D� D� D� D� D� D� D�d� d� d� d� d�� d� d� d�P �~��}� %� %� %� �m��m� #� #� #� �m��m� #� #� #� �~��}� %� %� %�"�+��-� +� +� +� +� +r |