Python unittest and discovery

Question

I have directories, which contain files named like: test_foo.py

Each file is a test case.

I would like to

1. Run all the tests in a direc

Answer 1

Given how you're trying to use unittest2 from the command line on Python < 2.7, I think you may have missed the note on the unittest2 PyPI page:

Note

Command line usage

In Python 2.7 you invoke the unittest command line features (including test discover) with python -m unittest <args>. As unittest is a package, and the ability to invoke packages with python -m ... is new in Python 2.7, we can't do this for unittest2.

Instead unittest2 comes with a script unit2. Command line usage:

unit2 discover unit2 -v test_module

There is also a copy of this script called unit2.py, useful for Windows which uses file-extensions rather than shebang lines to determine what program to execute files with. Both of these scripts are installed by distutils.

Try the unit2 script which this note recommends as the alternative for older Pythons to the "run package as main script" feature of Python 2.7. Maybe its sources could also be useful to find out exactly how to discover-and-run tests from your own code, if that's what you'd rather do.

Answer 2

Once you have discovered tests, you can run them with a test runner.

For Python 2:

import unittest2
loader = unittest2.TestLoader()
tests = loader.discover('.')
testRunner = unittest2.runner.TextTestRunner()
testRunner.run(tests)

For Python 3:

import unittest
loader = unittest.TestLoader()
tests = loader.discover('.')
testRunner = unittest.runner.TextTestRunner()
testRunner.run(tests)

Running the above code will print the test results to standard out.

Answer 3

I ran into the same issue when running python -m unittest discover. Here is a good checklist to verify your setup. Nose is more flexible with the allowed configurations, but not necessarily better.

1. Make sure all files/directories start with test. Do not use test-something.py, since that is not a valid Python module name. Use test_something.py.

2. If you are putting your tests in a sub-directory (e.g. test/), make sure you create a test/__init__.py file so python will treat the directory as a package.

3. All class test cases definitions must be extend unittest.TestCase. For example,

   class DataFormatTests(unittest.TestCase)