Launching tests (nose)¶
Tests are launched by nose, and you have to tell it to use the funq plugin.
Manual launching¶
Basically:
nosetests --with-funq
The command must be started from the folder containing tests files and the funq.conf configuration file.
Note
There are many options for nose, and some specifics to the funq
plugin. See nosetests --help
for an exhaustive list.
Example:
# launch tests with all stdout/stderr output and stop on the first error
nosetests --with-funq -s -x
Defining default options¶
Every nose option may be specified by default in a file named setup.cfg. You can look at the nose documentation for more informations.
Example:
[nosetests]
verbosity=2
with-funq=1
Note
This configuration is very useful, and allow to type only nosetests
on the command line instead of nosetests --with-funq -vv
. I highly
recommend this configuration and I will use it in the following
documentation.
Selecting tests to launch¶
It s possible to select tests to launch using nose.
Example:
# every tests in a given file
nosetests test_export.py
# every tests of a given class in a test file
nosetests test_export.py:TestExportElectre
# just one test (one method)
nosetests test_export.py:TestExportElectre.test_export_b6
Note
See the nose documeation fo more information.
If the verbosity option is equal to 2, the tests execution will show test names with the same format. This means that you can then copy/paste a test name to restart it.
Going further¶
nose got plenty of usefuls plugins !
Some are integrated in nose, others are third-party plugins and need a proper installation.
Som of the interesting nose plugins are listed here:
- xunit: format tests output using xunit
- attributeselector: select tests given their attributes
- collect-only: allow to only list tests without really execute them
See the nose documentation, and google to find others usefuls plugins !
Note
It is also easy to write your own nose plugins.