summaryrefslogtreecommitdiff
path: root/HACKING.txt
diff options
context:
space:
mode:
authorSteve Piercy <web@stevepiercy.com>2016-10-03 02:03:39 -0700
committerSteve Piercy <web@stevepiercy.com>2016-10-03 02:03:39 -0700
commit8edd76825a37708c74e6e7d6055b6cca73fd8f47 (patch)
tree1732b27d67b3bed87f254da1a3510a65c979c460 /HACKING.txt
parente39cc85a8573148889a82318fb7c727361835790 (diff)
downloadpyramid-8edd76825a37708c74e6e7d6055b6cca73fd8f47.tar.gz
pyramid-8edd76825a37708c74e6e7d6055b6cca73fd8f47.tar.bz2
pyramid-8edd76825a37708c74e6e7d6055b6cca73fd8f47.zip
Update HACKING.txt for running individual tests
- nose-selecttests is optional, not pre-installed - Closes #2781
Diffstat (limited to 'HACKING.txt')
-rw-r--r--HACKING.txt22
1 files changed, 16 insertions, 6 deletions
diff --git a/HACKING.txt b/HACKING.txt
index cdfe5cf9c..953c386f9 100644
--- a/HACKING.txt
+++ b/HACKING.txt
@@ -148,7 +148,7 @@ Coding Style
Running Tests
---------------
+-------------
- To run all tests for Pyramid on a single Python version from your development
virtual environment (See *Using a Development Checkout* above), run
@@ -156,11 +156,21 @@ Running Tests
$ $VENV/bin/nosetests
-- To run individual tests (i.e., during development) you can use a regular
- expression with the ``-t`` parameter courtesy of the `nose-selecttests
- <https://pypi.python.org/pypi/nose-selecttests/>`_ plugin that was installed
- (along with nose itself) via ``pip install -e .``. The easiest usage is to
- simply provide the verbatim name of the test you're working on.
+- To run individual tests (i.e., during development), you can use ``nosetests``
+ syntax as follows:
+
+ # run a single test
+ $ $VENV/bin/nosetests pyramid.tests.test_module:ClassName.test_mytestname
+
+ # run all tests in a class
+ $ $VENV/bin/nosetests pyramid.tests.test_module:ClassName
+
+ Optionally you can install a nose plugin, `nose-selecttests
+ <https://pypi.python.org/pypi/nose-selecttests/>`_, and use a regular
+ expression with the ``-t`` parameter to run tests.
+
+ # run a single test
+ $ $VENV/bin/nosetests -t test_mytestname
- The ``tox.ini`` uses ``nose`` and ``coverage``. As such ``tox`` may be used
to run groups of tests or only a specific version of Python. For example, the