From 0d4aaca53738dab5229b1319d15cc9e4c9cbf977 Mon Sep 17 00:00:00 2001
From: daira <>
Date: Wed, 25 Feb 2015 13:34:10 +0000
Subject: [PATCH] simplify commands to run tests with coverage

[Imported from Trac: page HowToWriteTests, version 9]
---
 HowToWriteTests.md | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/HowToWriteTests.md b/HowToWriteTests.md
index 65d8f14..2284b93 100644
--- a/HowToWriteTests.md
+++ b/HowToWriteTests.md
@@ -7,7 +7,7 @@ touch src/allmydata/test/test_fname.py
 ```
 
 ```
-./bin/tahoe debug trial --rterrors allmydata.test.test_fname
+python setup.py trial -s 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:
@@ -27,19 +27,24 @@ Now run it!
 Now install Ned Batchelder's "[coverage"](http://nedbatchelder.com/code/coverage/) tool and run your with code coverage, like this:
 
 ```
-./bin/tahoe @coverage run --branch --include='src/allmydata/*' @tahoe debug trial --rterrors allmydata.test.test_fname
+python setup.py trial --coverage -s allmydata.test.test_fname
 ```
 
-If you installed coverage from Debian or Ubuntu then you have to name it `python-coverage`, like this:
+
 
 ```
-./bin/tahoe @python-coverage run --branch --include='src/allmydata/*' @tahoe debug trial --rterrors allmydata.test.test_fname
+python setup.py trial --coverage -s 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:
 
 ```
-./bin/tahoe @coverage html
+coverage html
+```
+
+If you installed coverage from Debian or Ubuntu then you have to name it `python-coverage`, like this:
+```
+python-coverage html
 ```
 
 That will product a directory named `htmlcov`. View its contents with a web browser.