Getting started with nose2


The recommended way to install nose2 is with pip

pip install nose2

You can also install from source by downloading the source distribution from pypi, un-taring it, and running python install in the source directory. Note that if you install this way, and do not have distribute or setuptools installed, you must install nose2’s dependencies manually.


For Python 2.7, Python 3.2 and pypy, nose2 requires six version 1.1. For Python 2.6, nose2 also requires argparse version 1.2.1 and unittest2 version 0.5.1. When installing with pip, distribute or setuptools, these dependencies will be installed automatically.

Development version

You can install the development version of nose2 from github with pip:

pip install -e git+git://

You can also download a package from github, or clone the source and install from there with python install.

Running tests

To run tests in a project, use the nose2 script that is installed with nose2:


This will find and run tests in all packages in the current working directory, and any sub-directories of the current working directory whose names start with ‘test’.

To find tests, nose2 looks for modules whose names start with ‘test’. In those modules, nose2 will load tests from all unittest.TestCase subclasses, as well as functions whose names start with ‘test’.

The nose2 script supports a number of command-line options, as well as extensive configuration via config files. For more information see Using nose2 and Configuring nose2.