---
id: xunitparser
version: "1.3.4"
license: unclear
license_treatment: permissive
maintenance: abandoned
---

# xunitparser — Read JUnit/XUnit XML files and map them to Python objects

License: permissive · Maintenance: abandoned · Downloads: 113.3K/mo

## What it is and what it does

xunitparser is a minimal XML parser that reads JUnit/XUnit test result files and converts them into Python objects mirroring the standard unittest module's structure. It returns a TestSuite object containing TestCase objects and a TestResult object, letting you programmatically inspect test outcomes, class names, method names, and pass/fail/skip status.

The package has no runtime dependencies and installs cleanly, but it is no longer maintained. It was last released in February 2022 and has not been updated since. If you need to parse JUnit XML in a legacy codebase or as a one-time integration task, it will likely work; if you need active support or compatibility with the latest Python versions, you should evaluate alternatives or plan to maintain a fork.

Use it for:

- Parse JUnit XML output from CI/CD pipelines to programmatically analyze test results in Python.
- Extract test metadata (class name, method name, pass/fail status) from XML reports for custom reporting or filtering.
- Integrate legacy test result files into a Python-based test analysis or aggregation tool.
- Inspect test suite structure and outcomes without writing custom XML parsing logic.

## Worth the install?

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

Parses JUnit/XUnit XML test result files and maps them to Python objects compatible with the standard unittest module.

Yes, if you need to parse JUnit XML in a stable, legacy codebase and can accept that the package is no longer maintained. The low install friction and lack of dependencies make it a lightweight choice. No, if you require active maintenance, support for the latest Python versions, or expect to need bug fixes or feature updates. Consider alternatives if you are starting a new project.

## Install

pip install xunitparser
uv add xunitparser
poetry add xunitparser

## Installing xunitparser

Before you install: Low install friction with no runtime dependencies. However, the package is abandoned—last release was 1633 days ago—so expect no maintenance, bug fixes, or support for newer Python versions beyond those already declared.

License in practice: Licensed under MIT (permissive), so you can use, modify, and distribute it freely with minimal restrictions.

Quickstart:

import xunitparser
ts, tr = xunitparser.parse(open('/path/to/unit.xml'))
for tc in ts:
    print(tc.classname, tc.methodname, 'passed' if tc.good else 'failed')

Verify before relying:

- Whether the package works reliably with Python versions beyond 3.10 or with modern test frameworks.
- Whether the XML parsing handles all JUnit/XUnit dialect variations in real-world use.

## Package facts

- License: not declared (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 113.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

junit xml parser, xunit test results, parse junit xml, test result xml parsing, unittest xml integration, junit-xml, test-parsing, unmaintained

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