Fetching contributors…
Cannot retrieve contributors at this time
89 lines (56 sloc) 2.33 KB

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 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 :doc:`nosetests <usage>` script, which you can use to automatically discover and run tests.

Now you can run tests for your project:

cd path/to/project

You should see output something like this:

Ran 34 tests in 1.440s


Indicating that nose found and ran your tests.

For help with nosetests' many command-line options, try:

nosetests -h

or visit the :doc:`usage documentation <usage>`.


nose supports python3. Building from source on python3 requires distribute. If you don't have distribute installed, python3 install will install it via distribute's bootstrap script.

Additionally, if your project is using 2to3, python3 nosetests command will automatically convert your sources with 2to3 and then run the tests with python 3.


nose itself supports python 3, but many 3rd-party plugins do not!

.. toctree::