Changes between Version 11 and Version 12 of HowToWriteTests

Timestamp:

2020-07-14T15:39:01Z (4 years ago)

Author:

exarkun

Comment:

trivially modernize these instructions

HowToWriteTests

@@ -8 +8 @@
 
 {{{
-python setup.py trial -s allmydata.test.test_fname
+python -m twisted.trial trial allmydata.test.test_fname
 }}}
 
-Okay, so it didn't work, because there is no file by that name. Create such a file, with these contents:
+Okay, so that was boring because there are no tests in the file.  Add these contents:
 
 {{{
-from twisted.trial import unittest
+from testtools.matchers import (
+    Never,
+)
+from .common import (
+    TestCase,
+)
 
-class T(unittest.TestCase):
+class T(TestCase):
     def test_a(self):
-        pass
+        self.assertThat("a", Never())
 }}}
 
@@ -28 +33 @@
 
 {{{
-python setup.py trial --coverage -s allmydata.test.test_fname
+python -m coverage run -m twisted.trial allmydata.test.test_fname
 }}}
 
-This does the same as running the tests without coverage -- print a list of what happened when each test was run. It also writes out a file named {{{.coverage}}} into the current directory. Run the following command to read that file and produce nice HTML pages:
+This does the same as running the tests without coverage -- print a list of what happened when each test was run. It also writes out a file named {{{.coverage.<something>}}} into the current directory. Run the following command to read that file and produce nice HTML pages:
 
 {{{
-coverage html
-}}}
-
-If you installed coverage from Debian or Ubuntu then you have to name it {{{python-coverage}}}, like this:
-{{{
-python-coverage html
+python -m coverage combine
+python -m coverage html
 }}}