pytest-json-ctrf

Pytest plugin to generate json report in CTRF (Common Test Report Format)

pytest-json-ctrf Permissive license Active ★ 20 v0.5.3 released 2026-07-19

Install

pytest-json-ctrf on PyPI

pip

pip install pytest-json-ctrf

uv

uv add pytest-json-ctrf

poetry

poetry add pytest-json-ctrf

Package facts

License	not declared (permissive)
Python support	supports the current Python release (>=3.8)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — pytest
Maintenance	actively maintained — 25 days since the last release
Last repo commit	2026-03-31
First released	2024-05-20
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: pytest_json_ctrf-0.5.3-py3-none-any.whl

Framework :: PytestLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3

About pytest-json-ctrf

from the package's own PyPI description — quoted content, verbatim

CTRF for pytest

Pytest implementation of Common Test Report Format (CTRF) for test results.
Test report will be generated in JSON format.
Test report can be used to prettify the report in GitHub Actions with github-actions-ctrf.
Do not worry if report in GitHub does not appear immediately. It takes some time to process the report.

Features

Generates JSON report
Tested to work correctly with and without pytest-xdist
Tested to get browser name from pytest-playwright
Parametrized tests are supported and reported as 1 test with multiple retries

Installation

pip install pytest-json-ctrf

Usage

generate report.json file in the root directory of the project. File path is mandatory

pytest --ctrf report.json

Environment Variables may be used to specify the required Environment Object fields when using the CTRF [slack-test-reporter][ctrf-slack-test-reporter-url].

CTRF_BUILD_NAME="Pytest JSON CTRF Report"
CTRF_BUILD_NUMBER="000"
CTRF_BUILD_URL="https://ctrf.io]"

JSON example

More...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

A pytest plugin that generates test reports in Common Test Report Format (CTRF) as JSON, compatible with pytest-xdist for parallel testing and pytest-playwright for browser detection.

Low install friction with a single runtime dependency on pytest. Actively maintained with a release 25 days ago; repository shows recent activity and is not archived.

Licensed under MIT (permissive), allowing free use, modification, and distribution with minimal restrictions.

Usage

pip install pytest-json-ctrf

pytest --ctrf report.json

# Environment variables for build metadata (optional):
# export CTRF_BUILD_NAME="Pytest JSON CTRF Report"
# export CTRF_BUILD_NUMBER="000"
# export CTRF_BUILD_URL="https://ctrf.io"

Requires Python 3.8 or later.

Verdict: A lightweight, actively maintained pytest plugin for standardized test reporting. No known vulnerabilities, permissive MIT license, and low install friction make it suitable for CI/CD pipelines seeking CTRF-compliant JSON reports.

Needs verification

Whether the plugin correctly handles all pytest marker types beyond @pytest.mark.parametrize
Performance characteristics with very large test suites
Actual compatibility with pytest-xdist and pytest-playwright in production environments

pytest json report generatorctrf test report formatpytest test results jsoncommon test report formatpytest xdist compatible reportingtest report standardization