os-testr

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 on this page — 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

os-testr on PyPI

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

Evidence: os_testr-3.0.0-py3-none-any.whl

Tags

More Testing packages