ReportPortal integration for pytest framework

Pytest plugin for reporting test results of the Pytest to the ReportPortal.

DISCLAIMER: We use Google Analytics for sending anonymous usage information such as agent's and client's names, and their versions after a successful launch start. This information might help us to improve both ReportPortal backend and client sides. It is used by the ReportPortal team only and is not supposed for sharing with 3rd parties.

Installation

To install pytest plugin execute next command in a terminal:

pip install pytest-reportportal

Look through the CONTRIBUTING.rst for contribution guidelines.

Configuration

Prepare the config file pytest.ini in root directory of tests or specify any one using pytest command line option:

py.test -c config.cfg

The pytest.ini file should have next mandatory fields:

rp_project - name of project in ReportPortal
rp_endpoint - address of ReportPortal Server

And one type of authorization: API Key or OAuth 2.0 Password grant. You can do this by setting:

rp_api_key or RP_API_KEY environment variable. You can get it in the User Profile section on the UI.

Or:

rp_oauth_uri - OAuth 2.0 token endpoint URL for password grant authentication. Required if API key is not used.
rp_oauth_username - OAuth 2.0 username for password grant authentication. Required if OAuth 2.0 is used.
rp_oauth_password - OAuth 2.0 password for password grant authentication. Required if OAuth 2.0 is used.
rp_oauth_client_id - OAuth 2.0 client identifier. Required if OAuth 2.0 is used.
rp_oauth_client_secret - OAuth 2.0 client secret. Optional for OAuth 2.0 authentication.
rp_oauth_scope - OAuth 2.0 access token scope. Optional for OAuth 2.0 authentication.

Example of pytest.ini:

[pytest]
rp_api_key = fb586627-32be-47dd-93c1-678873458a5f
rp_endpoint = http://192.168.1.10:8080
rp_project = user_personal
rp_launch = AnyLaunchName
rp_launch_attributes = 'PyTest' 'Smoke'
rp_launch_description = 'Smoke test'
rp_ignore_attributes = 'xfail' 'usefixture'

There are also optional parameters: https://reportportal.io/docs/log-data-in-reportportal/test-framework-integration/Python/pytest/

Examples

For logging of the test item flow to ReportPortal, please, use the python logging handler provided by plugin like below:

in conftest.py:

import logging

import pytest

from reportportal_client import RPLogger


@pytest.fixture(scope="session")
def rp_logger():
    logger = logging.getLogger(__name__)
    logger.setLevel(logging.DEBUG)
    logging.setLoggerClass(RPLogger)
    return logger

in tests:

# In this case only INFO messages will be sent to the ReportPortal.
def test_one(rp_logger):
    rp_logger.info("Case1. Step1")
    x = "this"
    rp_logger.info("x is: %s", x)
    assert 'h' in x

    # Message with an attachment.
    import subprocess
    free_memory = subprocess.check_output("free -h".split())
    rp_logger.info(
        "Case1. Memory consumption",
        attachment={
            "name": "free_memory.txt",
            "data": free_memory,
            "mime": "application/octet-stream",
        },
    )

    # This debug message will not be sent to the ReportPortal.
    rp_logger.debug("Case1. Debug message")

Launching

To run test with ReportPortal you must provide --reportportal flag:

py.test ./tests --reportportal

Check the documentation to find more detailed information about how to integrate pytest with ReportPortal using the agent: https://reportportal.io/docs/log-data-in-reportportal/test-framework-integration/Python/pytest/

Copyright Notice

Licensed under the Apache 2.0 license (see the LICENSE file).

Release files for pytest-reportportal 5.6.11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pytest-reportportal 5.6.11
File	Size	Uploaded
pytest_reportportal-5.6.11.tar.gz	33.2 kB	Aug 19, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pytest-reportportal 5.6.11
File	Interpreter	ABI	Platform	Reset
pytest_reportportal-5.6.11-py2.py3-none-any.whl 32.5 kB Aug 19, 2026	Python 2, Python 3	none	any	Details

Total release size: 65.8 kB

Release files / pytest_reportportal-5.6.11.tar.gz

Download URL	pytest_reportportal-5.6.11.tar.gz
Size	33.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`efe0284ec55bd371f2ba4173a4bd0e72ffe517d9876e1265eac2e6bc31a9b302`
BLAKE2b-256 checksum How to use checksums	`979b6b75bf06db39918a31b633e166f4383114b0f258d3812b9a97ed746cb22e`
Upload date	Aug 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / pytest_reportportal-5.6.11-py2.py3-none-any.whl

Download URL	pytest_reportportal-5.6.11-py2.py3-none-any.whl
Size	32.5 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`ff5c50fa149d4d1eda459d81b414b34a633298d110d42854dd78ff77d6021b17`
BLAKE2b-256 checksum How to use checksums	`58754e42f7c63977c4fa21537d149f355cd4b5620558b05a016586703dbdfc45`
Upload date	Aug 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`