---
id: xmlrunner
version: "1.7.7"
license: LGPL
license_treatment: copyleft
maintenance: dormant
---

# xmlrunner — PyUnit-based test runner with JUnit like XML reporting.

License: copyleft · Maintenance: dormant · Downloads: 287.9K/mo

## What it is and what it does

xmlrunner is a custom test runner for Python's unittest framework that captures test results and writes them to XML files in a format understood by continuous integration servers, build systems, and IDEs. Instead of printing test output to the console, it generates structured XML reports that downstream tools can parse and display.

The package provides XMLTestRunner as a drop-in replacement for unittest's standard TextTestRunner, plus a Django integration hook. It has no runtime dependencies and works by wrapping the unittest framework. However, the project has been dormant since 2014, with the last release over a decade ago—while the repository is not archived, active maintenance is minimal.

Use it for:

- Export unittest results to XML for Jenkins, GitLab CI, or other CI systems that consume JUnit-format reports.
- Generate test reports in a format that IDEs and test dashboards can parse and visualize.
- Integrate test reporting into Django projects by setting TEST_RUNNER in settings.py.
- Capture test metadata (pass/fail/skip status, timing, descriptions) in structured XML for post-processing.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A unittest test runner that exports test results to XML files compatible with CI systems, IDEs, and build tools.

Yes, with conditions. The package is stable and has no known vulnerabilities, making it suitable for existing projects already using it or for simple unittest-to-XML conversion needs. However, install friction is high (source-only distribution), and dormancy since 2014 means no support for modern Python or CI ecosystem changes. If you need active maintenance or compatibility with recent tooling, consider alternatives like pytest with junit-xml plugin or modern CI-native reporting.

## Install

pip install xmlrunner
uv add xmlrunner
poetry add xmlrunner

## Installing xmlrunner

Before you install: High install friction due to source distribution only. Package is dormant—last release was 2014-11-10, over a decade ago, with no commits since 2024-03-07. Maintenance is minimal; consider whether you need active support.

License in practice: Licensed under LGPL (copyleft). You must disclose source code modifications and make them available under the same license if you distribute the package or derivative works.

Quickstart:

pip install xmlrunner

import unittest
import xmlrunner

if __name__ == '__main__':
    unittest.main(testRunner=xmlrunner.XMLTestRunner(output='test-reports'))

Verify before relying:

- Whether the package works reliably with modern Python versions (3.10+) despite no recent releases.
- Whether XML output format remains compatible with current CI/IDE standards.
- Whether the Django integration (XMLTestRunner in settings.py) still functions with current Django versions.

## Package facts

- License: LGPL (copyleft)
- Python support: unspecified
- Install friction: high
- Maintenance: dormant
- Downloads: 287.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

unittest xml reporting, junit xml test runner, python test xml output, ci test report generation, xmltestrunner, test-reporting, junit-xml, ci-integration

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