unittest

Free plan LinuxMacWindows

What unittest is

unittest is Python’s unit testing framework for arranging and running automated tests. It includes fixtures for shared setup and cleanup, TestCase classes, TestSuite collections, and test runners. Assertions such as assertEqual, assertTrue, assertFalse, and assertRaises record test outcomes. Tests can be run from the command line by module, class, method, or file path; with no arguments, unittest starts test discovery. Discovery can be configured with a start directory, filename pattern, and project top-level directory. The framework also supports tests and classes that are skipped conditionally or unconditionally, as well as tests marked as expected failures. Its subTest context manager separates iterations within a test method and reports parameters when an iteration fails. The documentation points to unittest.mock for replacing parts of a system with mock objects and checking their use, and recommends continuous integration systems for production test runs. unittest is part of Python’s standard library and is free to use and distribute, including commercially, under an OSI-approved open source license. It supports Python on Linux, macOS, and Windows. Test discovery requires test files to be importable from the project top-level directory.

Who it suits

unittest suits Python developers who need to organize automated tests, share setup and cleanup, and run test discovery. It also fits teams using continuous integration to drive production test runs.

What it does well

Includes fixtures, TestCase, TestSuite, and test runners.
Supports configurable test discovery.
Allows skipped tests and expected failures.
Subtests report parameters when an iteration fails.
Free to use and distribute commercially.

What to know first

Discovery requires importable test files.
The framework supports Python only.

Limits

The free plan is listed as free and is free to use and distribute, including commercially. Test discovery requires test files to be importable modules or packages from the project top-level directory.

Plans

Plan	Billed and limits	Price
Free	Free to use and distribute, including for commercial use · Python standard library unit testing framework · no separate unittest price stated	Free

As docs.python.org lists them, read 9 Oct 2026. The maker's own page has the final word.

Getting started

Open the Python unittest documentation.
Use Python on Linux, macOS, or Windows.
Organize tests with fixtures, TestCase classes, and TestSuite collections.
Run a module, class, method, or file path from the command line, or start without arguments for discovery.
Connect production test runs to a continuous integration system if needed.

Verdict

unittest provides test organization, command-line execution, discovery, and mock support as part of Python’s standard library. Its discovery requirement for importable files is worth considering when structuring a project.

Questions

How much does unittest cost?

It is listed as free, with no separate unittest price stated.

Which language and platforms does it support?

unittest supports Python on Linux, macOS, and Windows.

Is unittest open source?

Python is developed under an OSI-approved open-source license and is freely usable and distributable, including commercially.

How can I run tests?

The command line can run tests by module, class, method, or file path. Running without arguments starts test discovery.

Does unittest support mocks and parameterized cases?

Yes. The documentation points to unittest.mock for mock objects, and subTest can distinguish iterations and report parameters when one fails.

Which continuous integration systems are recommended?

The documentation recommends production test runs with Buildbot, Jenkins, GitHub Actions, or AppVeyor.

Facts from unittest's own pages

Assertions: TestCase includes assertion methods such as assertEqual, assertTrue, assertFalse, and assertRaises to record test outcomes. · docs.python.org, 9 Oct 2026
Command line: Tests can be run from the command line by module, class, method, or file path, and running without arguments starts test discovery. · docs.python.org, 9 Oct 2026
Compatibility limitation: Test discovery requires test files to be importable modules or packages from the project top-level directory. · docs.python.org, 9 Oct 2026
Integrations: The documentation recommends driving production tests with continuous integration systems such as Buildbot, Jenkins, GitHub Actions, or AppVeyor. · docs.python.org, 9 Oct 2026
Maintainer organization: The Python Software Foundation says it supports and maintains Python documentation, python.org, PyPI, and other services used by the Python community. · python.org, 9 Oct 2026
Mock support: The documentation points to unittest.mock as a library for replacing parts of a system under test with mock objects and making assertions about their use. · docs.python.org, 9 Oct 2026
Platforms: Python.org lists downloads or platform pages for Windows, macOS, Android, iOS, and other platforms. · python.org, 9 Oct 2026
Purpose: unittest is a unit testing framework that supports test automation, setup and cleanup sharing, test collection, and independence from the reporting framework. · docs.python.org, 9 Oct 2026
Security and license: Python is developed under an OSI-approved open source license and is freely usable and distributable, including commercially. · python.org, 9 Oct 2026
Skipping and expected failures: Tests and classes can be skipped conditionally or unconditionally, and tests can be marked as expected failures. · docs.python.org, 9 Oct 2026
Subtests: The subTest context manager distinguishes iterations within a test method and reports parameters when a subtest fails. · docs.python.org, 9 Oct 2026
Test building blocks: It provides fixtures, TestCase, TestSuite, and test runners for organizing and executing tests. · docs.python.org, 9 Oct 2026
Test discovery: The framework supports discovery from a project directory and provides options to set the start directory, filename pattern, and project top-level directory. · docs.python.org, 9 Oct 2026