# ReportPortal RobotFramework agent
[![PyPI](https://img.shields.io/pypi/v/robotframework-reportportal.svg?maxAge=259200)](https://pypi.python.org/pypi/robotframework-reportportal)
[![Python versions](https://img.shields.io/pypi/pyversions/robotframework-reportportal.svg)](https://pypi.org/project/robotframework-reportportal)
[![Build Status](https://github.com/reportportal/agent-Python-RobotFramework/actions/workflows/tests.yml/badge.svg)](https://github.com/reportportal/agent-Python-RobotFramework/actions/workflows/tests.yml)
[![codecov.io](https://codecov.io/gh/reportportal/agent-Python-RobotFramework/branch/develop/graph/badge.svg)](https://codecov.io/gh/reportportal/agent-Python-RobotFramework)
[![Join Slack chat!](https://img.shields.io/badge/slack-join-brightgreen.svg)](https://slack.epmrpp.reportportal.io/)
[![stackoverflow](https://img.shields.io/badge/reportportal-stackoverflow-orange.svg?style=flat)](http://stackoverflow.com/questions/tagged/reportportal)
[![Build with Love](https://img.shields.io/badge/build%20with-❤%EF%B8%8F%E2%80%8D-lightgrey.svg)](http://reportportal.io?style=flat)
Listener for RobotFramework to report results to ReportPortal
* [Installation](https://github.com/reportportal/agent-Python-RobotFramework#installation)
* [Usage](https://github.com/reportportal/agent-Python-RobotFramework#usage)
* [Send attachement (screenshots)](https://github.com/reportportal/agent-Python-RobotFramework#send-attachement-screenshots)
* [Integration with GA](https://github.com/reportportal/agent-Python-RobotFramework#integration-with-ga)
* [Copyright Notice](https://github.com/reportportal/agent-Python-RobotFramework#copyright-notice)
## Installation
First you need to install RobotFramework:
pip install robotframework
The latest stable version of library is available on PyPI:
pip install robotframework-reportportal
## Usage
### Properties
For reporting results to ReportPortal you need to pass some variables
to `robot` run:
REQUIRED:
```
--listener robotframework_reportportal.listener
--variable RP_API_KEY:"your_user_api_key"
--variable RP_ENDPOINT:"your_reportportal_url"
--variable RP_LAUNCH:"launch_name"
--variable RP_PROJECT:"reportportal_project_name"
```
NOT REQUIRED:
```
--variable RP_CLIENT_TYPE:"SYNC"
- Type of the under-the-hood ReportPortal client implementation. Possible values: [SYNC, ASYNC_THREAD, ASYNC_BATCHED].
--variable RP_LAUNCH_UUID:"id_of_existing_rp_launch"
- ID of existing ReportPortal launch
--variable RP_LAUNCH_DOC:"some_documentation_for_launch"
- Description for the launch
--variable RP_LAUNCH_ATTRIBUTES:"RF tag_name:tag_value"
- Space-separated list of tags/attributes for the launch
--variable RP_LAUNCH_UUID_PRINT:"True"
- Default value is "False", enables printing Launch UUID on test run start.
--variable RP_LAUNCH_UUID_PRINT_OUTPUT:"stderr"
- Default value is "stdout", Launch UUID print output. Possible values: [stderr, stdout].
--variable RP_TEST_ATTRIBUTES:"key1:value1 key1:value2 tag key2:value3"
- Space-separated list of tags/attributes for the tests
--variable RP_CONNECT_TIMEOUT:"20"
- Default value is "10.0", connection timeout to ReportPortal server.
--variable RP_READ_TIMEOUT:"20"
- Default value is "10.0", response read timeout for ReportPortal connection.
--variable RP_LOG_BATCH_SIZE:"10"
- Default value is "20", affects size of async batch log requests
--variable RP_LOG_BATCH_PAYLOAD_SIZE:"10240000"
- Default value is "65000000", maximum payload size of async batch log
requests
--variable RP_RERUN:"True"
- Default is "False". Enables rerun mode for the last launch.
--variable RP_RERUN_OF:"xxxxx-xxxx-xxxx-lauch-uuid"
- Default is "None". Enables rerun mode for the launch with the specified
UUID. Should be used in combination with the RP_RERUN option.
--variable RP_SKIPPED_ISSUE:"True"
- Default value is "True", marks skipped test items with 'To Investigate'
--variable RP_ATTACH_LOG:"True"
- Default value is "False", attaches Robot Framework HTML log file to
the launch.
--variable RP_ATTACH_REPORT:"True"
- Default value is "False", attaches Robot Framework HTML report file to
the launch.
--variable RP_ATTACH_XUNIT:"True"
- Default value is "False", attaches Robot Framework XUnit result file to
the launch.
--variable RP_VERIFY_SSL:"True"
- Default value is "True", disables SSL verification for HTTP requests.
Also, you can specify a full path to your certificate as the value.
```
### Logging
Custom logger which supports attachments can be used in Python keywords.
Usage of this logger is similar to the standard robot.api.logger with addition
of an extra kwarg "attachment":
```python
import subprocess
from robotframework_reportportal import logger
def log_free_memory():
logger.debug("Collecting free memory statistics!")
logger.debug(
"Memory consumption report",
attachment={
"name": "free_memory.txt",
"data": subprocess.check_output("free -h".split()),
"mime": "text/plain",
},
)
```
## Test case ID
It's possible to tag tests the following way `test_case_id:12345` using default
Robot Framework tagging functionality. ID specified after `:` will be sent to
ReportPortal.
## Send attachment (screenshots)
https://github.com/reportportal/client-Python#send-attachement-screenshots
## Integration with GA
ReportPortal is now supporting integrations with more than 15 test frameworks
simultaneously. In order to define the most popular agents and plan the team
workload accordingly, we are using Google analytics.
ReportPortal collects information about agent name and its version only. This
information is sent to Google analytics on the launch start. Please help us to
make our work effective.
If you still want to switch Off Google analytics, please change env variable
the way below.
```bash
export AGENT_NO_ANALYTICS=1
```
## Copyright Notice
Licensed under the [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)
license (see the LICENSE.txt file).
Raw data
{
"_id": null,
"home_page": "https://github.com/reportportal/agent-Python-RobotFramework",
"name": "robotframework-reportportal",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "testing, reporting, robot framework, reportportal, agent",
"author": "ReportPortal Team",
"author_email": "support@reportportal.io",
"download_url": "https://files.pythonhosted.org/packages/3a/f0/a5380bb6edc389e2c069f02cdc611e3812362ff32bdfb1129e80a7d98933/robotframework-reportportal-5.5.3.tar.gz",
"platform": null,
"description": "# ReportPortal RobotFramework agent\n\n[![PyPI](https://img.shields.io/pypi/v/robotframework-reportportal.svg?maxAge=259200)](https://pypi.python.org/pypi/robotframework-reportportal)\n[![Python versions](https://img.shields.io/pypi/pyversions/robotframework-reportportal.svg)](https://pypi.org/project/robotframework-reportportal)\n[![Build Status](https://github.com/reportportal/agent-Python-RobotFramework/actions/workflows/tests.yml/badge.svg)](https://github.com/reportportal/agent-Python-RobotFramework/actions/workflows/tests.yml)\n[![codecov.io](https://codecov.io/gh/reportportal/agent-Python-RobotFramework/branch/develop/graph/badge.svg)](https://codecov.io/gh/reportportal/agent-Python-RobotFramework)\n[![Join Slack chat!](https://img.shields.io/badge/slack-join-brightgreen.svg)](https://slack.epmrpp.reportportal.io/)\n[![stackoverflow](https://img.shields.io/badge/reportportal-stackoverflow-orange.svg?style=flat)](http://stackoverflow.com/questions/tagged/reportportal)\n[![Build with Love](https://img.shields.io/badge/build%20with-\u2764%EF%B8%8F%E2%80%8D-lightgrey.svg)](http://reportportal.io?style=flat)\n\nListener for RobotFramework to report results to ReportPortal\n\n* [Installation](https://github.com/reportportal/agent-Python-RobotFramework#installation)\n* [Usage](https://github.com/reportportal/agent-Python-RobotFramework#usage)\n* [Send attachement (screenshots)](https://github.com/reportportal/agent-Python-RobotFramework#send-attachement-screenshots)\n* [Integration with GA](https://github.com/reportportal/agent-Python-RobotFramework#integration-with-ga)\n* [Copyright Notice](https://github.com/reportportal/agent-Python-RobotFramework#copyright-notice)\n\n## Installation\n\nFirst you need to install RobotFramework:\n\n pip install robotframework\n\nThe latest stable version of library is available on PyPI:\n\n pip install robotframework-reportportal\n\n## Usage\n\n### Properties\n\nFor reporting results to ReportPortal you need to pass some variables\nto `robot` run:\n\nREQUIRED:\n\n```\n--listener robotframework_reportportal.listener\n--variable RP_API_KEY:\"your_user_api_key\"\n--variable RP_ENDPOINT:\"your_reportportal_url\"\n--variable RP_LAUNCH:\"launch_name\"\n--variable RP_PROJECT:\"reportportal_project_name\"\n```\n\nNOT REQUIRED:\n\n```\n--variable RP_CLIENT_TYPE:\"SYNC\"\n - Type of the under-the-hood ReportPortal client implementation. Possible values: [SYNC, ASYNC_THREAD, ASYNC_BATCHED].\n--variable RP_LAUNCH_UUID:\"id_of_existing_rp_launch\"\n - ID of existing ReportPortal launch\n--variable RP_LAUNCH_DOC:\"some_documentation_for_launch\"\n - Description for the launch\n--variable RP_LAUNCH_ATTRIBUTES:\"RF tag_name:tag_value\"\n - Space-separated list of tags/attributes for the launch\n--variable RP_LAUNCH_UUID_PRINT:\"True\"\n - Default value is \"False\", enables printing Launch UUID on test run start.\n--variable RP_LAUNCH_UUID_PRINT_OUTPUT:\"stderr\"\n - Default value is \"stdout\", Launch UUID print output. Possible values: [stderr, stdout].\n--variable RP_TEST_ATTRIBUTES:\"key1:value1 key1:value2 tag key2:value3\"\n - Space-separated list of tags/attributes for the tests\n--variable RP_CONNECT_TIMEOUT:\"20\"\n - Default value is \"10.0\", connection timeout to ReportPortal server.\n--variable RP_READ_TIMEOUT:\"20\"\n - Default value is \"10.0\", response read timeout for ReportPortal connection.\n--variable RP_LOG_BATCH_SIZE:\"10\"\n - Default value is \"20\", affects size of async batch log requests\n--variable RP_LOG_BATCH_PAYLOAD_SIZE:\"10240000\"\n - Default value is \"65000000\", maximum payload size of async batch log\n requests\n--variable RP_RERUN:\"True\"\n - Default is \"False\". Enables rerun mode for the last launch.\n--variable RP_RERUN_OF:\"xxxxx-xxxx-xxxx-lauch-uuid\"\n - Default is \"None\". Enables rerun mode for the launch with the specified\n UUID. Should be used in combination with the RP_RERUN option.\n--variable RP_SKIPPED_ISSUE:\"True\"\n - Default value is \"True\", marks skipped test items with 'To Investigate'\n--variable RP_ATTACH_LOG:\"True\"\n - Default value is \"False\", attaches Robot Framework HTML log file to\n the launch.\n--variable RP_ATTACH_REPORT:\"True\"\n - Default value is \"False\", attaches Robot Framework HTML report file to\n the launch.\n--variable RP_ATTACH_XUNIT:\"True\"\n - Default value is \"False\", attaches Robot Framework XUnit result file to\n the launch.\n--variable RP_VERIFY_SSL:\"True\"\n - Default value is \"True\", disables SSL verification for HTTP requests.\n Also, you can specify a full path to your certificate as the value.\n```\n\n### Logging\n\nCustom logger which supports attachments can be used in Python keywords.\nUsage of this logger is similar to the standard robot.api.logger with addition\nof an extra kwarg \"attachment\":\n\n```python\nimport subprocess\nfrom robotframework_reportportal import logger\n\n\ndef log_free_memory():\n logger.debug(\"Collecting free memory statistics!\")\n logger.debug(\n \"Memory consumption report\",\n attachment={\n \"name\": \"free_memory.txt\",\n \"data\": subprocess.check_output(\"free -h\".split()),\n \"mime\": \"text/plain\",\n },\n )\n```\n\n## Test case ID\n\nIt's possible to tag tests the following way `test_case_id:12345` using default\nRobot Framework tagging functionality. ID specified after `:` will be sent to\nReportPortal.\n\n## Send attachment (screenshots)\n\nhttps://github.com/reportportal/client-Python#send-attachement-screenshots\n\n## Integration with GA\n\nReportPortal is now supporting integrations with more than 15 test frameworks\nsimultaneously. In order to define the most popular agents and plan the team\nworkload accordingly, we are using Google analytics.\n\nReportPortal collects information about agent name and its version only. This\ninformation is sent to Google analytics on the launch start. Please help us to\nmake our work effective.\nIf you still want to switch Off Google analytics, please change env variable\nthe way below.\n\n```bash\nexport AGENT_NO_ANALYTICS=1\n```\n\n## Copyright Notice\n\nLicensed under the [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)\nlicense (see the LICENSE.txt file).\n",
"bugtrack_url": null,
"license": null,
"summary": "Agent for reporting RobotFramework test results to ReportPortal",
"version": "5.5.3",
"project_urls": {
"Download": "https://github.com/reportportal/agent-Python-RobotFramework/tarball/5.5.3",
"Homepage": "https://github.com/reportportal/agent-Python-RobotFramework"
},
"split_keywords": [
"testing",
" reporting",
" robot framework",
" reportportal",
" agent"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8a4afea5d294c1a8cb2ed8b2c849258247a679e522e4e4caa8885d14f1a1ff92",
"md5": "2c5915a9f9e5f1ad9325fcec3dd94228",
"sha256": "f999f5b5769eec45cdff79ccf5230a2e9a41abc377f4b93fe2b5bc0907face28"
},
"downloads": -1,
"filename": "robotframework_reportportal-5.5.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2c5915a9f9e5f1ad9325fcec3dd94228",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 28066,
"upload_time": "2024-03-20T13:50:53",
"upload_time_iso_8601": "2024-03-20T13:50:53.828424Z",
"url": "https://files.pythonhosted.org/packages/8a/4a/fea5d294c1a8cb2ed8b2c849258247a679e522e4e4caa8885d14f1a1ff92/robotframework_reportportal-5.5.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3af0a5380bb6edc389e2c069f02cdc611e3812362ff32bdfb1129e80a7d98933",
"md5": "02819802afec80016ee4686bb7e083f6",
"sha256": "2dc073110e88f91ae1706a410d6761d51275aa6b03c76b2453e1d802eb735968"
},
"downloads": -1,
"filename": "robotframework-reportportal-5.5.3.tar.gz",
"has_sig": false,
"md5_digest": "02819802afec80016ee4686bb7e083f6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 24860,
"upload_time": "2024-03-20T13:50:55",
"upload_time_iso_8601": "2024-03-20T13:50:55.285661Z",
"url": "https://files.pythonhosted.org/packages/3a/f0/a5380bb6edc389e2c069f02cdc611e3812362ff32bdfb1129e80a7d98933/robotframework-reportportal-5.5.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-20 13:50:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "reportportal",
"github_project": "agent-Python-RobotFramework",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "robotframework-reportportal"
}