[PATCH] docs/contributing: cleanup test section
Thomas De Schampheleire
patrickdepinguin at gmail.com
Sat Mar 14 16:19:44 EDT 2015
# HG changeset patch
# User Thomas De Schampheleire <thomas.de.schampheleire at gmail.com>
# Date 1426364334 -3600
# Sat Mar 14 21:18:54 2015 +0100
# Node ID 97af92113da02ebcd00de22d99348374a6182667
# Parent 6892b0515af98fd2e4e6db9c535a854e1ba2e0b1
docs/contributing: cleanup test section
diff --git a/docs/contributing.rst b/docs/contributing.rst
--- a/docs/contributing.rst
+++ b/docs/contributing.rst
@@ -47,17 +47,24 @@
-------------
After finishing your changes make sure all tests pass cleanly. You can run
-the testsuite running ``nosetest`` from the project root, or if you use tox
-run tox for python2.6-2.7 with multiple database test. When using `nosetests`
-test.ini file is used and by default it uses SQLite for tests, edit this file
-to change your testing enviroment.
+the testsuite running ``nosetests`` from the project root, or if you use tox
+run ``tox`` for python2.6-2.7 with multiple database test.
-There's a special set of tests for push/pull operations, you can run them using::
+When using `nosetests`, the `test.ini` file is used with an SQLite database. Edit
+this file to change your testing enviroment.
+
+It is possible to avoid recreating the full test database on each invocation of
+the tests, thus eliminating the initial delay. To achieve this, run the tests as::
paster serve test.ini --pid-file=test.pid --daemon
- KALLITHEA_WHOOSH_TEST_DISABLE=1 KALLITHEA_NO_TMP_PATH=1 nosetests -x kallithea/tests/other/test_vcs_operations.py
+ KALLITHEA_WHOOSH_TEST_DISABLE=1 KALLITHEA_NO_TMP_PATH=1 nosetests
kill -9 $(cat test.pid)
+You can run individual tests by specifying their path as argument to nosetests.
+nosetests also has many more options, see `nosetests -h`.
+
+There's a special set of tests for push/pull operations in
+`kallithea/tests/other/test_vcs_operations.py`
Coding/contribution guidelines
------------------------------
More information about the kallithea-general
mailing list