Rev 5062: (robertc) Add a testrepository config file for bzr testing, in file:///home/pqm/archives/thelove/bzr/%2Btrunk/

[Canonical.com Patch Queue Manager]

At file:///home/pqm/archives/thelove/bzr/%2Btrunk/

------------------------------------------------------------
revno: 5062 [merge]
revision-id: pqm at pqm.ubuntu.com-20100228195348-6fjfmwnorpb1eu05
parent: pqm at pqm.ubuntu.com-20100228185031-155sw5ndgh3tkl3w
parent: robertc at robertcollins.net-20100228100829-nroa3qp8zi8jwxke
committer: Canonical.com Patch Queue Manager <pqm at pqm.ubuntu.com>
branch nick: +trunk
timestamp: Sun 2010-02-28 19:53:48 +0000
message:
  (robertc) Add a testrepository config file for bzr testing,
  	improve the testing docs about subunit. (Robert Collins)
added:
  .testr.conf                    testr.conf-20100228092111-z02a13qrv22mn7up-1
modified:
  NEWS                           NEWS-20050323055033-4e00b5db738777ff
  doc/developers/testing.txt     testing.txt-20080812140359-i70zzh6v2z7grqex-1
=== added file '.testr.conf'
--- a/.testr.conf	1970-01-01 00:00:00 +0000
+++ b/.testr.conf	2010-02-28 10:08:29 +0000
@@ -0,0 +1,3 @@
+[DEFAULT]
+test_command=./bzr selftest --subunit $IDOPTION
+test_id_option=--load-list $IDFILE

=== modified file 'NEWS'
--- a/NEWS	2010-02-27 12:27:33 +0000
+++ b/NEWS	2010-02-28 19:53:48 +0000
@@ -121,7 +121,14 @@
 Testing
 *******
 
-* New `bzrlib.tests.test_import_tariff` can make assertions about what
+* bzr now has a ``.testr.conf`` file in its source tree configured
+  appropriately for running tests with Testrepository
+  (``https://launchpad.net/testrepository``). (Robert Collins)
+
+* Documentation about testing with ``subunit`` has been tweaked.
+  (Robert Collins)
+
+* New ``bzrlib.tests.test_import_tariff`` can make assertions about what
   Python modules are loaded, to guard against startup time or library
   dependency regressions.
   (Martin Pool)

=== modified file 'doc/developers/testing.txt'
--- a/doc/developers/testing.txt	2010-02-10 02:03:20 +0000
+++ b/doc/developers/testing.txt	2010-02-28 10:08:29 +0000
@@ -144,11 +144,44 @@
 -------------
 
 Bazaar can optionally produce output in the machine-readable subunit_
-format, so that test output can be post-processed by various tools.
+format, so that test output can be post-processed by various tools. To
+generate a subunit test stream::
+
+ $ ./bzr selftest --subunit
+
+Processing such a stream can be done using a variety of tools including:
+
+* The builtin ``subunit2pyunit``, ``subunit-filter``, ``subunit-ls``,
+  ``subunit2junitxml`` from the subunit project.
+
+* tribunal_, a GUI for showing test results.
+
+* testrepository_, a tool for gathering and managing test runs.
 
 .. _subunit: https://launchpad.net/subunit/
-
-
+.. _tribunal: https://launchpad.net/tribunal/
+
+
+Using testrepository
+--------------------
+
+Bazaar ships with a config file for testrepository_. This can be very
+useful for keeping track of failing tests and doing general workflow
+support. To run tests using testrepository::
+
+  $ testr run
+
+To run only failing tests::
+
+  $ testr run --failing
+
+To run only some tests, without plugins::
+
+  $ test run test_selftest -- --no-plugins
+
+See the testrepository documentation for more details.
+
+.. _testrepository: https://launchpad.net/testrepository
 
 Writing Tests
 =============