JSON Report (–json-report)

The –json-report flag allows you to generate a JSON test report during test execution. This is particularly useful when running multiple test suites in a CI pipeline and needing to aggregate or analyze results programmatically.

Overview

• Default Output: final_report.json

• Type: File Name

• Usage Context: CI pipelines, custom dashboards, post-processing

Example

pytest --json-report=test_report.json

This will generate a JSON report at the specified location.

Use Cases

• CI Pipelines: When running multiple pytest commands in separate steps or jobs, each one can generate its own –json-report. These can be merged or parsed later for summarization.

• Dashboards: Feed the JSON into internal dashboards or analytics tools to visualize pass/fail rates, duration trends, or flaky tests.

• Custom Post-Processing: Build scripts or bots to analyze test results, auto-label flaky tests, or trigger alerts based on JSON content.

Integrations

• Combine with –generate-xml and –html-output to produce a full suite of structured outputs.

• The JSON report includes metadata such as:

  • Test name

  • Status (pass/fail/skipped)

  • Duration

  • File location and line number

Note

If you’re running multiple pytest commands (e.g., across parallel jobs in CI), ensure each job outputs to a unique file path to avoid overwriting reports.