---
id: allure-pytest-default-results
version: "0.1.4"
license: unclear
license_treatment: unclear
maintenance: active
---

# allure-pytest-default-results — Generate default "unknown" results to show in Allure Report if test case does not run

License: unclear · Maintenance: active · Downloads: 143.1K/mo

## What it is and what it does

This pytest plugin extends allure-pytest to handle test cases that never execute—cases skipped due to setup failures, timeouts, or CI interruptions. By default, allure-pytest only reports tests that actually ran, leaving gaps in the Allure Report. This plugin generates placeholder "unknown" status results for each expected test case before the test run, then merges them with actual results afterward, so unrun tests appear in the report instead of vanishing.

The plugin is a thin wrapper around pytest's --allure-default-dir flag and works by creating default result JSON files that can be moved into the final results directory. It targets a specific gap in test reporting visibility and is maintained by Canonical, though it remains very early in its lifecycle (first release January 2025).

Use it for:

- Ensure test cases show as "unknown" in Allure Report when a CI job times out mid-run.
- Track which tests never executed due to setup or fixture failures.
- Generate complete test inventory reports even when some test cases don't run.
- Diagnose gaps in test coverage by seeing which cases were skipped or never attempted.

## Worth the install?

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

Generates default "unknown" status results for test cases that don't run, so they appear in Allure Report instead of being omitted entirely.

Yes, if you use Allure Report and need visibility into unrun tests. Install friction is low and maintenance is active. However, verify the current license status before use, and confirm that the "unknown" status integration with allure-pytest has been implemented (the package notes it was not yet in use as of 2025-01-31). Also watch for potential upstream replacement via allure-python issue #821.

## Install

pip install allure-pytest-default-results
uv add allure-pytest-default-results
poetry add allure-pytest-default-results

## Installing allure-pytest-default-results

Before you install: Low friction install with only pytest and allure-pytest as runtime dependencies. Active maintenance as of 2026-04-06 with recent commits, though the package is very new (first release 2025-01-31).

License in practice: License status is unclear—no SPDX identifier or raw license text is available. Verify licensing before use in proprietary or restricted contexts.

Quickstart:

pip install allure-pytest-default-results
pytest --allure-default-dir=allure-default-results

Requires pytest and allure-pytest to be installed; the plugin generates results but does not itself run tests.

Verify before relying:

- Whether the "unknown" status integration with allure-pytest has been implemented since the 2025-01-31 note stating it was not yet used.
- Compatibility with allure-pytest versions and any specific Allure Report versions.
- Whether this plugin will be superseded by upstream allure-python feature (GitHub issue #821).

## Package facts

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

## Tags

allure report missing tests, pytest allure unknown status, test case coverage reporting, allure default results, pytest test result tracking, allure report gaps, unrun test visibility, test-reporting, allure-integration

[View on SkillFed](https://skillfed.io/packages/allure-pytest-default-results) · [View on PyPI](https://pypi.org/project/allure-pytest-default-results/)