---
id: html-testrunner
version: "1.2.1"
license: MIT license
license_treatment: permissive
maintenance: dormant
---

# html-testRunner — A Test Runner in python, for Human Readable HTML Reports

License: permissive · Maintenance: dormant · Downloads: 339.5K/mo

## 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 above — 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

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

- License: MIT license (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 339.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

unittest html test report, python test runner html output, generate html test results, unittest html reporter, test results html visualization, test-reporting, unittest-extension

[View on SkillFed](https://skillfed.io/packages/html-testrunner) · [View on PyPI](https://pypi.org/project/html-testrunner/)