unittest: do not use TestCase.debug() with --pdb

Fixes pytest-dev#5991
Fixes pytest-dev#3823

Ref: pytest-dev/pytest-django#772
Ref: pytest-dev#1890
Ref: pytest-dev/pytest-django#782

- inject wrapped testMethod

- adjust test_trial_error

- add test for `--trace` with unittests

Author: blueyed

changelog/3823.bugfix.rst

@@ -0,0 +1 @@
+``--trace`` now works with unittests.

changelog/5991.bugfix.rst

@@ -1 +1 @@
-Do not use ``TestCase.debug()`` for unittests with ``--pdb``.
+Fix interaction with ``--pdb`` and unittests: do not use unittest's ``TestCase.debug()``.

doc/en/unittest.rst

@@ -238,17 +238,6 @@ was executed ahead of the ``test_method``.
 
 .. _pdb-unittest-note:
 
-.. note::
-
-    Running tests from ``unittest.TestCase`` subclasses with ``--pdb`` will
-    disable tearDown and cleanup methods for the case that an Exception
-    occurs. This allows proper post mortem debugging for all applications
-    which have significant logic in their tearDown machinery. However,
-    supporting this feature has the following side effect: If people
-    overwrite ``unittest.TestCase`` ``__call__`` or ``run``, they need to
-    to overwrite ``debug`` in the same way  (this is also true for standard
-    unittest).
-
 .. note::
 
     Due to architectural differences between the two frameworks, setup and

src/_pytest/unittest.py

@@ -1,4 +1,5 @@
 """ discovery and running of std-library "unittest" style tests. """
+import functools
 import sys
 import traceback
 
@@ -188,6 +189,14 @@ def stopTest(self, testcase):
         pass
 
     def runtest(self):
+        testMethod = getattr(self._testcase, self._testcase._testMethodName)
+
+        @functools.wraps(testMethod)
+        def wrapped_testMethod(*args, **kwargs):
+            self.ihook.pytest_pyfunc_call(pyfuncitem=self)
+
+        self._testcase._wrapped_testMethod = wrapped_testMethod
+        self._testcase._testMethodName = "_wrapped_testMethod"
         self._testcase(result=self)
 
     def _prunetraceback(self, excinfo):

testing/test_pdb.py

@@ -177,25 +177,36 @@ def flush(child):
             child.wait()
         assert not child.isalive()
 
-    @pytest.mark.xfail(reason="running .debug() all the time is bad (#5991)")
     def test_pdb_unittest_postmortem(self, testdir):
         p1 = testdir.makepyfile(
             """
             import unittest
+
+            teardown_called = 0
+
             class Blub(unittest.TestCase):
                 def tearDown(self):
-                    self.filename = None
-                def test_false(self):
+                    global teardown_called
+                    teardown_called += 1
+
+                def test_error(self):
+                    assert teardown_called == 0
                     self.filename = 'debug' + '.me'
                     assert 0
+
+                def test_check(self):
+                    assert teardown_called == 1
         """
         )
-        child = testdir.spawn_pytest("--pdb %s" % p1)
+        child = testdir.spawn_pytest(
+            "--pdb {p1}::Blub::test_error {p1}::Blub::test_check".format(p1=p1)
+        )
         child.expect("Pdb")
-        child.sendline("p self.filename")
-        child.sendeof()
+        child.sendline("p 'filename=' + self.filename")
+        child.expect("'filename=debug.me'")
+        child.sendline("c")
         rest = child.read().decode("utf8")
-        assert "debug.me" in rest
+        assert "= 1 failed, 1 passed in" in rest
         self.flush(child)
 
     def test_pdb_unittest_skip(self, testdir):

testing/test_unittest.py

@@ -537,24 +537,28 @@ def f(_):
         )
         result.stdout.fnmatch_lines(
             [
-                "test_trial_error.py::TC::test_four FAILED",
+                "test_trial_error.py::TC::test_four SKIPPED",
                 "test_trial_error.py::TC::test_four ERROR",
                 "test_trial_error.py::TC::test_one FAILED",
                 "test_trial_error.py::TC::test_three FAILED",
-                "test_trial_error.py::TC::test_two FAILED",
+                "test_trial_error.py::TC::test_two SKIPPED",
+                "test_trial_error.py::TC::test_two ERROR",
                 "*ERRORS*",
                 "*_ ERROR at teardown of TC.test_four _*",
+                "NOTE: Incompatible Exception Representation, displaying natively:",
+                "*DelayedCalls*",
+                "*_ ERROR at teardown of TC.test_two _*",
+                "NOTE: Incompatible Exception Representation, displaying natively:",
                 "*DelayedCalls*",
                 "*= FAILURES =*",
-                "*_ TC.test_four _*",
-                "*NameError*crash*",
+                # "*_ TC.test_four _*",
+                # "*NameError*crash*",
                 "*_ TC.test_one _*",
                 "*NameError*crash*",
                 "*_ TC.test_three _*",
+                "NOTE: Incompatible Exception Representation, displaying natively:",
                 "*DelayedCalls*",
-                "*_ TC.test_two _*",
-                "*NameError*crash*",
-                "*= 4 failed, 1 error in *",
+                "*= 2 failed, 2 skipped, 2 errors in *",
             ]
         )
 
@@ -1096,3 +1100,26 @@ def test_should_not_run(self):
     )
     result = testdir.runpytest()
     result.stdout.fnmatch_lines(["*Exit: pytest_exit called*", "*= no tests ran in *"])
+
+
+def test_trace(testdir):
+    p1 = testdir.makepyfile(
+        """
+        import unittest
+
+        class MyTestCase(unittest.TestCase):
+            def test(self):
+                self.assertEqual('foo', 'foo')
+    """
+    )
+    result = testdir.runpytest("--trace", str(p1))
+    result.stdout.fnmatch_lines(
+        [
+            "self = <test_trace.MyTestCase testMethod=_wrapped_testMethod>",
+            "    def test(self):",
+            ">       self.assertEqual('foo', 'foo')",
+            "test_trace.py:5: ",
+            "* in trace_dispatch",
+        ]
+    )
+    assert result.ret == ExitCode.TESTS_FAILED