---
id: pytest-reportportal
version: "5.6.10"
license: Apache 2.0
license_treatment: permissive
maintenance: active
---

# pytest-reportportal — Agent for Reporting results of tests to the Report Portal

License: permissive · Maintenance: active · Downloads: 1.0M/mo

## What it is and what it does

pytest-reportportal is a pytest plugin that bridges test execution with ReportPortal, a centralized test reporting platform. When you run pytest with the --reportportal flag, the plugin captures test results, logs, and optional attachments and sends them to a configured ReportPortal server. It depends on reportportal-client to handle the communication and authentication (via API key or OAuth 2.0).

The plugin integrates with pytest's logging system through an RPLogger fixture, allowing you to emit structured logs and file attachments directly into ReportPortal during test execution. Configuration is done via pytest.ini or environment variables, specifying the ReportPortal endpoint, project name, and credentials. It has been actively maintained since 2017 and supports Python 3.9 through 3.14.

Use it for:

- Centralize test results from CI/CD pipelines into a single ReportPortal dashboard for visibility across teams.
- Attach diagnostic artifacts (logs, screenshots, memory dumps) to individual test cases for faster failure analysis.
- Track test execution trends and quality metrics over time using ReportPortal's analytics and reporting features.
- Integrate pytest test runs with existing ReportPortal workflows for defect tracking and test planning.

## Worth the install?

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

A pytest plugin that integrates test execution with ReportPortal, sending test results, logs, and attachments to a ReportPortal server for centralized test reporting and analysis.

Yes, if you already use or plan to adopt ReportPortal for test reporting. The plugin is actively maintained, has no known vulnerabilities, installs with minimal friction, and is permissively licensed. Install only if you have a ReportPortal instance running and want to centralize pytest results there; it adds no value as a standalone tool.

## Install

pip install pytest-reportportal
uv add pytest-reportportal
poetry add pytest-reportportal

## Installing pytest-reportportal

Before you install: Low friction install with a single runtime dependency (reportportal-client). Active maintenance with a release 14 days ago and consistent commit activity; last commit on 2026-08-05.

License in practice: Licensed under Apache 2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install pytest-reportportal

# In pytest.ini:
[pytest]
rp_api_key = your-api-key
rp_endpoint = http://reportportal-server:8080
rp_project = project-name

# Run tests:
py.test ./tests --reportportal

Requires a running ReportPortal server instance and valid API credentials (API key or OAuth 2.0 configuration) to be set in pytest.ini or environment variables.

Verify before relying:

- Whether the plugin supports all modern Python versions listed (3.9–3.14) equally or if some have known issues.
- Performance impact when sending large test suites or attachments to a remote ReportPortal instance.
- Whether Google Analytics data collection can be disabled or opted out of.

## Package facts

- License: Apache 2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 1.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pytest reportportal integration, test results reporting portal, pytest test reporting server, centralized test reporting, pytest logging to reportportal, test execution tracking, pytest agent reportportal, pytest-plugin, test-reporting, ci-cd-integration

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