---
id: os-testr
version: "3.0.0"
license: unclear
license_treatment: permissive
maintenance: abandoned
---

# os-testr — A testr wrapper to provide functionality for OpenStack projects

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

## What it is and what it does

os-testr is a wrapper around the testr test runner that adds three command-line utilities for OpenStack projects: subunit-trace filters and annotates subunit test streams for readable output, subunit2html converts subunit results into an HTML report, and generate-subunit creates a subunit stream for a single test. It depends on pbr, python-subunit, and testtools.

The package is designed specifically for OpenStack's test infrastructure and has not been updated since April 2022. While it carries no known vulnerabilities and installs with low friction, its abandonment means it will not receive bug fixes, security patches, or compatibility updates for newer Python or dependency versions.

Use it for:

- Format and filter subunit test output for readable console display during OpenStack test runs.
- Generate HTML test reports from subunit streams for archival or CI/CD pipeline integration.
- Create subunit streams for individual tests in OpenStack projects for granular test execution and reporting.
- Integrate with legacy OpenStack CI systems that depend on testr and subunit-based test workflows.

## Worth the install?

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

os-testr wraps the testr test runner to provide OpenStack-specific test utilities: a subunit stream filter (subunit-trace), an HTML test results generator (subunit2html), and a subunit stream generator for individual tests.

No, unless you are maintaining legacy OpenStack infrastructure that already depends on os-testr. The package is abandoned and will not receive updates. If you are starting a new OpenStack project or modernizing an existing one, investigate current OpenStack testing practices and tools—stestr (mentioned in the description) or other maintained alternatives are likely better choices.

## Install

pip install os-testr
uv add os-testr
poetry add os-testr

## Installing os-testr

Before you install: Low install friction with only three runtime dependencies (pbr, python-subunit, testtools). However, the package is abandoned—last release was 2022-04-04, over 1593 days ago—so it receives no maintenance updates or security patches.

License in practice: Licensed under Apache (permissive), so you can use and modify it freely in most contexts, but the abandoned status means no one is maintaining it for license compliance changes.

Quickstart:

pip install os-testr

# Use subunit-trace to filter test output
subunit-trace < test_stream.subunit

# Generate HTML from subunit results
subunit2html < test_stream.subunit > results.html

Requires Python 3.8 or later; designed for OpenStack test workflows, so most useful in that context.

Verify before relying:

- Whether subunit-trace, subunit2html, and generate-subunit commands are still compatible with current OpenStack or testr versions.
- Whether the three runtime dependencies (pbr, python-subunit, testtools) have received security updates since the package's last release.
- Whether there is an actively maintained alternative or successor to os-testr for OpenStack testing.

## Package facts

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

## Tags

openstack test runner wrapper, subunit stream filter, test results html generator, testr output formatting, openstack testing tools, openstack, test-reporting, abandoned

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