test_pyunitcompat.py

# Copyright (c) Twisted Matrix Laboratories.
# See LICENSE for details.
from __future__ import annotations

import sys
import traceback
import unittest as pyunit
from unittest import skipIf

from zope.interface import implementer

from twisted.python.failure import Failure
from twisted.trial.itrial import IReporter, ITestCase
from twisted.trial.test import pyunitcases
from twisted.trial.unittest import PyUnitResultAdapter, SynchronousTestCase

class PyUnitTestTests(SynchronousTestCase):
    def setUp(self) -> None:
        self.original = pyunitcases.PyUnitTest("test_pass")
        self.test = ITestCase(self.original)

def test_callable(self) -> None:
        """
        Tests must be callable in order to be used with Python's unittest.py.
        """
        self.assertTrue(callable(self.test), f"{self.test!r} is not callable.")

class PyUnitResultTests(SynchronousTestCase):
    """
    Tests to show that PyUnitResultAdapter wraps TestResult objects from the
    standard library 'unittest' module in such a way as to make them usable and
    useful from Trial.
    """

# Once erroneous is ported to Python 3 this can be replaced with
    # erroneous.ErrorTest:
    class ErrorTest(SynchronousTestCase):
        """
        A test case which has a L{test_foo} which will raise an error.

@ivar ran: boolean indicating whether L{test_foo} has been run.
        """

ran = False

def test_foo(self) -> None:
            """
            Set C{self.ran} to True and raise a C{ZeroDivisionError}
            """
            self.ran = True
            1 / 0

def test_dontUseAdapterWhenReporterProvidesIReporter(self) -> None:
        """
        The L{PyUnitResultAdapter} is only used when the result passed to
        C{run} does *not* provide L{IReporter}.
        """

@implementer(IReporter)
        class StubReporter:  # type: ignore[misc]
            """
            A reporter which records data about calls made to it.

@ivar errors: Errors passed to L{addError}.
            @ivar failures: Failures passed to L{addFailure}.
            """

def __init__(self) -> None:
                self.errors: list[Failure] = []
                self.failures: list[None] = []

def startTest(self, test: object) -> None:
                """
                Do nothing.
                """

def stopTest(self, test: object) -> None:
                """
                Do nothing.
                """

def addError(self, test: object, error: Failure) -> None:
                """
                Record the error.
                """
                self.errors.append(error)

test = self.ErrorTest("test_foo")
        result = StubReporter()
        test.run(result)
        self.assertIsInstance(result.errors[0], Failure)

def test_success(self) -> None:
        class SuccessTest(SynchronousTestCase):
            ran = False

def test_foo(s) -> None:
                s.ran = True

test = SuccessTest("test_foo")
        result = pyunit.TestResult()
        test.run(result)

self.assertTrue(test.ran)
        self.assertEqual(1, result.testsRun)
        self.assertTrue(result.wasSuccessful())

def test_failure(self) -> None:
        class FailureTest(SynchronousTestCase):
            ran = False

def test_foo(s) -> None:
                s.ran = True
                s.fail("boom!")

test = FailureTest("test_foo")
        result = pyunit.TestResult()
        test.run(result)

self.assertTrue(test.ran)
        self.assertEqual(1, result.testsRun)
        self.assertEqual(1, len(result.failures))
        self.assertFalse(result.wasSuccessful())

def test_error(self) -> None:
        test = self.ErrorTest("test_foo")
        result = pyunit.TestResult()
        test.run(result)

self.assertTrue(test.ran)
        self.assertEqual(1, result.testsRun)
        self.assertEqual(1, len(result.errors))
        self.assertFalse(result.wasSuccessful())

def test_setUpError(self) -> None:
        class ErrorTest(SynchronousTestCase):
            ran = False

def setUp(self) -> None:
                1 / 0

def test_foo(s) -> None:
                s.ran = True

test = ErrorTest("test_foo")
        result = pyunit.TestResult()
        test.run(result)

self.assertFalse(test.ran)
        self.assertEqual(1, result.testsRun)
        self.assertEqual(1, len(result.errors))
        self.assertFalse(result.wasSuccessful())

def test_tracebackFromFailure(self) -> None:
        """
        Errors added through the L{PyUnitResultAdapter} have the same traceback
        information as if there were no adapter at all.
        """
        try:
            1 / 0
        except ZeroDivisionError:
            exc_info = sys.exc_info()
            f = Failure()
        pyresult = pyunit.TestResult()
        result = PyUnitResultAdapter(pyresult)
        result.addError(self, f)
        self.assertEqual(
            pyresult.errors[0][1], "".join(traceback.format_exception(*exc_info))
        )

def test_traceback(self) -> None:
        """
        As test_tracebackFromFailure, but covering more code.
        """

class ErrorTest(SynchronousTestCase):
            exc_info = None

def test_foo(self) -> None:
                try:
                    1 / 0
                except ZeroDivisionError:
                    self.exc_info = sys.exc_info()
                    raise

test = ErrorTest("test_foo")
        result = pyunit.TestResult()
        test.run(result)

# We can't test that the tracebacks are equal, because Trial's
        # machinery inserts a few extra frames on the top and we don't really
        # want to trim them off without an extremely good reason.
        #
        # So, we just test that the result's stack ends with the
        # exception's stack.
        assert test.exc_info is not None
        expected_stack = "".join(traceback.format_tb(test.exc_info[2]))
        observed_stack = "\n".join(result.errors[0][1].splitlines()[:-1])

self.assertEqual(
            expected_stack.strip(), observed_stack[-len(expected_stack) :].strip()
        )

def test_tracebackFromCleanFailure(self) -> None:
        """
        Errors added through the L{PyUnitResultAdapter} have the same
        traceback information as if there were no adapter at all, even
        if the Failure that held the information has been cleaned.
        """
        try:
            1 / 0
        except ZeroDivisionError:
            exc_info = sys.exc_info()
            f = Failure()
        f.cleanFailure()
        pyresult = pyunit.TestResult()
        result = PyUnitResultAdapter(pyresult)
        result.addError(self, f)
        tback = "".join(traceback.format_exception(*exc_info))
        self.assertEqual(
            pyresult.errors[0][1].endswith("ZeroDivisionError: division by zero\n"),
            tback.endswith("ZeroDivisionError: division by zero\n"),
        )

def test_trialSkip(self) -> None:
        """
        Skips using trial's skipping functionality are reported as skips in
        the L{pyunit.TestResult}.
        """

class SkipTest(SynchronousTestCase):
            @skipIf(True, "Let's skip!")
            def test_skip(self) -> None:
                1 / 0

test = SkipTest("test_skip")
        result = pyunit.TestResult()
        test.run(result)
        self.assertEqual(result.skipped, [(test, "Let's skip!")])

def test_pyunitSkip(self) -> None:
        """
        Skips using pyunit's skipping functionality are reported as skips in
        the L{pyunit.TestResult}.
        """

class SkipTest(SynchronousTestCase):
            @pyunit.skip("skippy")
            def test_skip(self) -> None:
                1 / 0

test = SkipTest("test_skip")
        result = pyunit.TestResult()
        test.run(result)
        self.assertEqual(result.skipped, [(test, "skippy")])

docroot: /var/www/469ed2f6-4d4b-4a8a-9f5e-ee4ef04d3bc8/public_html

curdir: /usr/lib/python3/dist-packages/twisted/trial/test

	.	4096
	..	4096
X	__init__.py	1716
	__pycache__	4096
X	detests.py	5760
X	erroneous.py	6593
X	matchers.py	2953
X	mockcustomsuite.py	544
X	mockcustomsuite2.py	541
X	mockcustomsuite3.py	684
X	mockdoctest.py	2421
X	moduleself.py	178
X	moduletest.py	302
X	novars.py	182
X	ordertests.py	912
X	packages.py	4651
X	pyunitcases.py	3173
X	sample.py	2180
X	scripttest.py	457
X	skipping.py	6134
X	suppression.py	2499
X	test_assertions.py	60813
X	test_asyncassertions.py	2552
X	test_deferred.py	9864
X	test_doctest.py	1803
X	test_keyboard.py	4054
X	test_loader.py	24522
X	test_log.py	8040
X	test_matchers.py	3037
X	test_output.py	5384
X	test_plugins.py	1468
X	test_pyunitcompat.py	8067
X	test_reporter.py	57793
X	test_runner.py	32255
X	test_script.py	33191
X	test_skip.py	2755
X	test_suppression.py	5911
X	test_testcase.py	1985
X	test_tests.py	49997
X	test_util.py	22166
X	test_warning.py	18842
X	weird.py	675