html-testRunner

What it is and what it does

HtmlTestRunner is a unittest test runner that replaces the default text output with HTML reports saved to disk. It captures test outcomes—passes, failures, errors, and skipped tests—and presents them in a structured HTML format suitable for sharing or archiving test results. The package depends only on Jinja2 for template rendering.

You use it by passing an instance of HTMLTestRunner to unittest.main() with an output directory parameter. The runner then generates an HTML file in that directory showing a summary and detailed breakdown of all test results. It's designed as a drop-in replacement for the standard unittest runner, requiring minimal code changes to adopt.

Use it for:

• Generate shareable HTML test reports for CI/CD pipelines or team review
• Archive test results in human-readable format for compliance or historical tracking
• Display test outcomes in a web browser instead of terminal output for better readability
• Integrate with build systems that expect HTML test artifacts

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A unittest test runner that generates human-readable HTML reports of test results, including pass/fail/error/skip status for each test.

Yes, if you need HTML test reports and accept dormant maintenance. The package is stable with no known vulnerabilities, but it has not been updated since 2019-09-09. Install only if the feature set meets your needs and you're comfortable with no active development or support.

Install

html-testrunner on PyPI

pip install html-testrunner

uv add html-testrunner

poetry add html-testrunner

Installing html-testRunner

Before you install

Low install friction with a single runtime dependency. However, the package is dormant—last release was 2019-09-09, with no updates since then despite an active repository.

License in practice

MIT license permits commercial and private use with minimal restrictions; you must include a copy of the license and copyright notice.

Quickstart

import HtmlTestRunner
import unittest

class TestExample(unittest.TestCase):
    def test_sample(self):
        self.assertEqual(1, 1)

if __name__ == '__main__':
    unittest.main(testRunner=HtmlTestRunner.HTMLTestRunner(output='reports'))

Verify before relying

• Whether the package works reliably with Python versions beyond 3.5 (classifier lists only 3.5, but requires_python is unspecified)
• Whether HTML output format is customizable or fixed
• Whether the package handles parallel test execution

Package facts

Evidence: html_testRunner-1.2.1-py2.py3-none-any.whl

Keywords: HtmlTestRunner, TestRunner, Html, Reports

Tags

More Testing packages