aDriv4 website!

Linux server64.web-hosting.com 4.18.0-513.18.1.lve.el8.x86_64 #1 SMP Thu Feb 22 12:55:50 UTC 2024 x86_64
LiteSpeed
198.54.116.248

File Name : twisted.py

"""
Tools for helping to test Twisted applications.
"""
from pprint import pformat
from typing import Union, Sequence, Callable
from unittest import TestCase

from constantly import NamedConstant

from . import compare
from twisted.logger import globalLogPublisher, formatEvent, LogLevel

class LogCapture(object):
    """
    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.
    """

def __init__(self, fields: Sequence[Union[str, Callable]] = ('log_level', formatEvent,)):
        #: The list of events captured.
        self.events = []
        self.fields = fields

def __call__(self, event):
        self.events.append(event)

def install(self):
        "Start capturing."
        self.original_observers = globalLogPublisher._observers
        globalLogPublisher._observers = [self]

def uninstall(self):
        "Stop capturing."
        globalLogPublisher._observers = self.original_observers

def check(self, *expected, order_matters: bool = True):
        """
        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.
        """
        actual = []
        for event in self.events:
            actual_event = tuple(field(event) if callable(field) else event.get(field)
                            for field in self.fields)
            if len(actual_event) == 1:
                actual_event = actual_event[0]
            actual.append(actual_event)
        if order_matters:
            compare(expected=expected, actual=actual)
        else:
            expected = list(expected)
            matched = []
            unmatched = []
            for entry in actual:
                try:
                    index = expected.index(entry)
                except ValueError:
                    unmatched.append(entry)
                else:
                    matched.append(expected.pop(index))
            if expected:
                raise AssertionError((
                    'entries not as expected:\n\n'
                    'expected and found:\n%s\n\n'
                    'expected but not found:\n%s\n\n'
                    'other entries:\n%s'
                ) % (pformat(matched), pformat(expected), pformat(unmatched)))

def check_failure_text(self, expected: str, index: int = -1, attribute: str = 'value'):
        """
        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.
        """
        compare(expected, actual=str(getattr(self.events[index]['log_failure'], attribute)))

def raise_logged_failure(self, start_index: int = 0):
        """
        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.
        """
        for event in self.events[start_index:]:
            failure = event.get('log_failure')
            if failure:
                raise failure

@classmethod
    def make(cls, testcase: TestCase, **kw):
        """
        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.
        """
        capture = cls(**kw)
        capture.install()
        testcase.addCleanup(capture.uninstall)
        return capture

#: Short reference to Twisted's ``LogLevel.debug``
DEBUG: NamedConstant = LogLevel.debug
#: Short reference to Twisted's ``LogLevel.info``
INFO: NamedConstant = LogLevel.info
#: Short reference to Twisted's ``LogLevel.warn``
WARN: NamedConstant = LogLevel.warn
#: Short reference to Twisted's ``LogLevel.error``
ERROR: NamedConstant = LogLevel.error
#: Short reference to Twisted's ``LogLevel.critical``
CRITICAL: NamedConstant = LogLevel.critical

Name	Type	Size	Owner/Group	Permission	Last Modified	Actions
.	dir	-	root/root	0755	2026-02-06 10:01:01
..	dir	-	root/root	0755	2026-05-04 07:16:41
__pycache__	dir	-	root/root	0755	2026-02-06 10:01:01
tests	dir	-	root/root	0755	2026-02-06 10:01:01
__init__.py	file	1.19 KB	root/root	0644	2026-01-20 01:01:47
comparison.py	file	39.14 KB	root/root	0644	2026-01-20 01:01:47
compat.py	file	224 B	root/root	0644	2026-01-20 01:01:47
components.py	file	1.31 KB	root/root	0644	2026-01-20 01:01:47
datetime.py	file	24.42 KB	root/root	0644	2026-01-20 01:01:47
django.py	file	2.88 KB	root/root	0644	2026-01-20 01:01:47
logcapture.py	file	10.75 KB	root/root	0644	2026-01-20 01:01:47
mock.py	file	1.21 KB	root/root	0644	2026-01-20 01:01:47
outputcapture.py	file	4.69 KB	root/root	0644	2026-01-20 01:01:47
popen.py	file	9.89 KB	root/root	0644	2026-01-20 01:01:47
replace.py	file	12.15 KB	root/root	0644	2026-01-20 01:01:47
resolve.py	file	2.05 KB	root/root	0644	2026-01-20 01:01:47
rmtree.py	file	2.52 KB	root/root	0644	2026-01-20 01:01:47
shouldraise.py	file	3.58 KB	root/root	0644	2026-01-20 01:01:47
shouldwarn.py	file	2.21 KB	root/root	0644	2026-01-20 01:01:47
sybil.py	file	2.28 KB	root/root	0644	2026-01-20 01:01:47
tempdirectory.py	file	12.89 KB	root/root	0644	2026-01-20 01:01:47
twisted.py	file	4.8 KB	root/root	0644	2026-01-20 01:01:47
utils.py	file	2.74 KB	root/root	0644	2026-01-20 01:01:47
version.txt	file	6 B	root/root	0644	2026-01-20 01:01:47

For more Private tool come to me!

https://t.me/aDriv4vz