comparison docs/contributing.rst @ 4920:329dd2b2025d

docs/contributing: cleanup test section
author Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
date Sat, 14 Mar 2015 21:18:54 +0100
parents 95fe05b1e5f8
children ef63850d1144
comparison
equal deleted inserted replaced
4919:494b04a84a49 4920:329dd2b2025d
45 45
46 Running tests 46 Running tests
47 ------------- 47 -------------
48 48
49 After finishing your changes make sure all tests pass cleanly. You can run 49 After finishing your changes make sure all tests pass cleanly. You can run
50 the testsuite running ``nosetest`` from the project root, or if you use tox 50 the testsuite running ``nosetests`` from the project root, or if you use tox
51 run tox for python2.6-2.7 with multiple database test. When using `nosetests` 51 run ``tox`` for python2.6-2.7 with multiple database test.
52 test.ini file is used and by default it uses SQLite for tests, edit this file
53 to change your testing enviroment.
54 52
55 There's a special set of tests for push/pull operations, you can run them using:: 53 When using `nosetests`, the `test.ini` file is used with an SQLite database. Edit
54 this file to change your testing enviroment.
55
56 It is possible to avoid recreating the full test database on each invocation of
57 the tests, thus eliminating the initial delay. To achieve this, run the tests as::
56 58
57 paster serve test.ini --pid-file=test.pid --daemon 59 paster serve test.ini --pid-file=test.pid --daemon
58 KALLITHEA_WHOOSH_TEST_DISABLE=1 KALLITHEA_NO_TMP_PATH=1 nosetests -x kallithea/tests/other/test_vcs_operations.py 60 KALLITHEA_WHOOSH_TEST_DISABLE=1 KALLITHEA_NO_TMP_PATH=1 nosetests
59 kill -9 $(cat test.pid) 61 kill -9 $(cat test.pid)
60 62
63 You can run individual tests by specifying their path as argument to nosetests.
64 nosetests also has many more options, see `nosetests -h`.
65
66 There's a special set of tests for push/pull operations in
67 `kallithea/tests/other/test_vcs_operations.py`.
61 68
62 Coding/contribution guidelines 69 Coding/contribution guidelines
63 ------------------------------ 70 ------------------------------
64 71
65 Kallithea is GPLv3 and we assume all contributions are made by the 72 Kallithea is GPLv3 and we assume all contributions are made by the