pytest-reportportal

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

pytest-reportportal on PyPI

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

Evidence: pytest_reportportal-5.6.10-py2.py3-none-any.whl

Keywords: testing, reporting, reportportal, pytest, agent

Tags

More Testing packages