nose2

0.16.0 · active · verified Sun Apr 12

nose2 is the successor to Nose, developed to extend Python's standard `unittest` module with a rich plugin ecosystem to ease the testing process. It acts as a popular test runner that automatically discovers and executes unit tests within a project. The current version is 0.16.0. It follows a 0.MAJOR.MINOR versioning scheme, where major releases introduce new functionality or breaking changes, and minor releases focus on bug fixes or small features.

Warnings

breaking nose2 is a distinct project from the original `nose` and is not fully backward compatible. `nose` plugins will not work with `nose2` without significant rewriting. Features like package-level fixtures supported by `nose` are not supported in `nose2`.
Fix: Review `nose2`'s plugin API and `differences` documentation for migration guidance from `nose`.
breaking Python 2 is no longer supported; the last line supporting Python 2 was 0.12.x. As of version 0.16.0, support for Python 3.8 has also been removed. nose2 now requires Python >=3.9.
Fix: Ensure your project runs on Python 3.9 or newer. Upgrade your Python environment if necessary.
deprecated The built-in `coverage` plugin is deprecated as of version 0.16.0 and is no longer tested on newer Python versions. It will be removed in a future release.
Fix: Consider using alternative coverage tools or integrating `coverage.py` directly into your test workflow outside of `nose2`'s plugin system.
gotcha `nose2` relies heavily on its plugin system; if no plugins are loaded (e.g., using `--no-plugins`), `nose2` effectively does nothing.
Fix: Ensure that necessary plugins are enabled, either through configuration files (`unittest.cfg`, `nose2.cfg`, `pyproject.toml`) or command-line arguments.
gotcha When using `test_suite='nose2.collector.collector'` with `python setup.py test`, `nose2` 'hijacks' the test running process, bypassing the standard `unittest` test result and runner. This might cause incompatibilities with certain packages or custom setups.
Fix: Prefer running `nose2` directly from the command line (`nose2`) or use a dedicated test runner for your project if `setup.py test` causes issues.

Install

pip install nose2 Install stable version

Imports

nose2
```
import nose2
```
Primarily used as a command-line tool, but can be imported for programmatic control or plugin development.
main
```
import nose2.main
nose2.main()
```

Quickstart

Create a Python file (e.g., `test_math.py`) with test functions prefixed with `test_` or `unittest.TestCase` subclasses with `test_` methods. Then, simply navigate to your project directory in the terminal and run `nose2` to discover and execute tests.

import unittest

class MyTests(unittest.TestCase):
    def test_addition(self):
        self.assertEqual(1 + 1, 2)

def test_subtraction():
    assert 5 - 2 == 3

# Save this as `test_math.py`
# To run from the command line: `nose2`

view raw JSON →