nose
is nicer testing for python
nose extends unittest to make testing easier.
Note to Users¶
Nose has been in maintenance mode for the past several years and will likely cease without a new person/team to take over maintainership. New projects should consider using Nose2, py.test, or just plain unittest/unittest2.
Installation and quick start¶
On most UNIX-like systems, you’ll probably need to run these commands as root or using sudo.
Install nose using setuptools/distribute:
easy_install nose
Or pip:
pip install nose
Or, if you don’t have setuptools/distribute installed, use the download link at right to download the source package, and install it in the normal fashion: Ungzip and untar the source package, cd to the new directory, and:
python setup.py install
However, please note that without setuptools/distribute installed, you will not be able to use third-party nose plugins.
This will install the nose libraries, as well as the nosetests script, which you can use to automatically discover and run tests.
Now you can run tests for your project:
cd path/to/project
nosetests
You should see output something like this:
..................................
----------------------------------------------------------------------
Ran 34 tests in 1.440s
OK
Indicating that nose found and ran your tests.
For help with nosetests’ many command-line options, try:
nosetests -h
or visit the usage documentation.
Python3¶
nose supports python3. Building from source on python3 requires
distribute. If you don’t
have distribute installed, python3 setup.py install
will install
it via distribute’s bootstrap script.
Additionally, if your project is using 2to3, python3 setup.py nosetests
command will automatically convert your sources with 2to3 and then run the
tests with python 3.
Warning
nose itself supports python 3, but many 3rd-party plugins do not!
Documentation
Testing with nose
Find out how to write, find and run tests using nose. |
Developing with nose
Find out how to write your own plugins, and about nose
internals. |
News
What's new in this release? |
Further reading
Plugin recipes and usage examples, trivia and other
uncategorizable items. |
Indices and tables |