.. image:: https://github.com/melexis/robot2rst/actions/workflows/python-package.yml/badge.svg?branch=master
:target: https://github.com/melexis/robot2rst/actions/workflows/python-package.yml
:alt: Build status
.. image:: https://img.shields.io/badge/Documentation-published-brightgreen.svg
:target: https://melexis.github.io/robot2rst/
:alt: Documentation
.. image:: https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat
:target: https://github.com/melexis/robot2rst/issues
:alt: Contributions welcome
=======================
Documentation robot2rst
=======================
This script can convert your .robot files from Robot Framework to reStructuredText (.rst) files with traceable items.
.. contents:: `Contents`
:depth: 2
:local:
----
Goal
----
This script allows you to connect your requirements to test cases via the `mlx.traceability`_ Sphinx extension.
Test cases get converted to traceable items. The documentation of each test gets used to generate the body of the item.
Test case names get converted to item IDs with a configurable prefix. Tags can be used to link to other traceable items.
-----
Usage
-----
.. code-block:: console
robot2rst -i example.robot -o test_plan.rst --prefix ITEST_MY_LIB- \
--tags SWRQT- SYSRQT- --relationships validates ext_toolname --coverage 100 66.66
$ robot2rst --help
usage: robot2rst [-h] -i ROBOT_FILE -o RST_FILE [--only EXPRESSION] [-p PREFIX]
[-r [RELATIONSHIPS ...]] [-t [TAGS ...]] [--include [INCLUDE ...]]
[-c [COVERAGE ...]] [--type TYPE] [--trim-suffix]
Convert robot test cases to reStructuredText with traceable items.
options:
-h, --help show this help message and exit
-i ROBOT_FILE, --robot ROBOT_FILE
Input robot file
-o RST_FILE, --rst RST_FILE
Output RST file, e.g. my_component_qtp.rst
--only EXPRESSION Expression of tags for Sphinx' `only` directive that surrounds all
RST content. By default, no `only` directive is generated.
-p PREFIX, --prefix PREFIX
Overrides the default 'QTEST-' prefix.
-r [RELATIONSHIPS ...], --relationships [RELATIONSHIPS ...]
Name(s) of the relationship(s) used to link to items in Tags section.
The default value is 'validates'.
-t [TAGS ...], --tags [TAGS ...]
Zero or more Python regexes for matching tags to treat them as
traceable targets via a relationship. All tags get matched by
default.
--include [INCLUDE ...]
Zero or more Python regexes for matching tags to filter test cases.
If every regex matches at least one of a test case's tags, the test
case is included.
-c [COVERAGE ...], --coverage [COVERAGE ...]
Minimum coverage percentages for the item-matrix(es); 1 value per tag
in -t, --tags.
--type TYPE Give value that starts with 'q' or 'i' (case-insensitive) to
explicitly define the type of test: qualification/integration test.
The default is 'qualification'.
--trim-suffix If the suffix of any prefix or --tags argument ends with '_-' it gets
trimmed to '-'.
-------------
Configuration
-------------
To include the script's output in your documentation you want to add the aforementioned extension to your
``extensions`` list in your *conf.py* like so:
.. code-block:: python
extensions = [
'mlx.traceability',
]
Please read the `documentation of mlx.traceability`_ for additional configuration steps.
If you use the ``--only`` input argument, you should also add |sphinx_selective_exclude.eager_only|_ to the
``extensions`` list to prevent mlx.traceability from parsing the content and ignoring the effect of the
``only`` directive.
.. _`mlx.traceability`: https://pypi.org/project/mlx.traceability/
.. _`documentation of mlx.traceability`: https://melexis.github.io/sphinx-traceability-extension/readme.html
.. |sphinx_selective_exclude.eager_only| replace:: ``'sphinx_selective_exclude.eager_only'``
.. _sphinx_selective_exclude.eager_only: https://pypi.org/project/sphinx-selective-exclude/
Raw data
{
"_id": null,
"home_page": "https://github.com/melexis/robot2rst",
"name": "mlx.robot2rst",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "robot,robotframework,sphinx,traceability",
"author": "Jasper Craeghs",
"author_email": "jce@melexis.com",
"download_url": "https://files.pythonhosted.org/packages/e4/05/e7314d67d06e23a025af976640466c233a865cdca3a323f99aa7a325086b/mlx.robot2rst-3.4.0.tar.gz",
"platform": "any",
"description": ".. image:: https://github.com/melexis/robot2rst/actions/workflows/python-package.yml/badge.svg?branch=master\n :target: https://github.com/melexis/robot2rst/actions/workflows/python-package.yml\n :alt: Build status\n\n.. image:: https://img.shields.io/badge/Documentation-published-brightgreen.svg\n :target: https://melexis.github.io/robot2rst/\n :alt: Documentation\n\n.. image:: https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat\n :target: https://github.com/melexis/robot2rst/issues\n :alt: Contributions welcome\n\n=======================\nDocumentation robot2rst\n=======================\n\nThis script can convert your .robot files from Robot Framework to reStructuredText (.rst) files with traceable items.\n\n.. contents:: `Contents`\n :depth: 2\n :local:\n\n----\nGoal\n----\n\nThis script allows you to connect your requirements to test cases via the `mlx.traceability`_ Sphinx extension.\nTest cases get converted to traceable items. The documentation of each test gets used to generate the body of the item.\nTest case names get converted to item IDs with a configurable prefix. Tags can be used to link to other traceable items.\n\n-----\nUsage\n-----\n\n.. code-block:: console\n\n robot2rst -i example.robot -o test_plan.rst --prefix ITEST_MY_LIB- \\\n --tags SWRQT- SYSRQT- --relationships validates ext_toolname --coverage 100 66.66\n\n $ robot2rst --help\n\n usage: robot2rst [-h] -i ROBOT_FILE -o RST_FILE [--only EXPRESSION] [-p PREFIX]\n [-r [RELATIONSHIPS ...]] [-t [TAGS ...]] [--include [INCLUDE ...]]\n [-c [COVERAGE ...]] [--type TYPE] [--trim-suffix]\n\n Convert robot test cases to reStructuredText with traceable items.\n\n options:\n -h, --help show this help message and exit\n -i ROBOT_FILE, --robot ROBOT_FILE\n Input robot file\n -o RST_FILE, --rst RST_FILE\n Output RST file, e.g. my_component_qtp.rst\n --only EXPRESSION Expression of tags for Sphinx' `only` directive that surrounds all\n RST content. By default, no `only` directive is generated.\n -p PREFIX, --prefix PREFIX\n Overrides the default 'QTEST-' prefix.\n -r [RELATIONSHIPS ...], --relationships [RELATIONSHIPS ...]\n Name(s) of the relationship(s) used to link to items in Tags section.\n The default value is 'validates'.\n -t [TAGS ...], --tags [TAGS ...]\n Zero or more Python regexes for matching tags to treat them as\n traceable targets via a relationship. All tags get matched by\n default.\n --include [INCLUDE ...]\n Zero or more Python regexes for matching tags to filter test cases.\n If every regex matches at least one of a test case's tags, the test\n case is included.\n -c [COVERAGE ...], --coverage [COVERAGE ...]\n Minimum coverage percentages for the item-matrix(es); 1 value per tag\n in -t, --tags.\n --type TYPE Give value that starts with 'q' or 'i' (case-insensitive) to\n explicitly define the type of test: qualification/integration test.\n The default is 'qualification'.\n --trim-suffix If the suffix of any prefix or --tags argument ends with '_-' it gets\n trimmed to '-'.\n\n\n-------------\nConfiguration\n-------------\n\nTo include the script's output in your documentation you want to add the aforementioned extension to your\n``extensions`` list in your *conf.py* like so:\n\n.. code-block:: python\n\n extensions = [\n 'mlx.traceability',\n ]\n\nPlease read the `documentation of mlx.traceability`_ for additional configuration steps.\n\nIf you use the ``--only`` input argument, you should also add |sphinx_selective_exclude.eager_only|_ to the\n``extensions`` list to prevent mlx.traceability from parsing the content and ignoring the effect of the\n``only`` directive.\n\n.. _`mlx.traceability`: https://pypi.org/project/mlx.traceability/\n.. _`documentation of mlx.traceability`: https://melexis.github.io/sphinx-traceability-extension/readme.html\n.. |sphinx_selective_exclude.eager_only| replace:: ``'sphinx_selective_exclude.eager_only'``\n.. _sphinx_selective_exclude.eager_only: https://pypi.org/project/sphinx-selective-exclude/\n\n\n",
"bugtrack_url": null,
"license": "Apache License Version 2.0",
"summary": "Python script for converting a Robot Framework file to a reStructuredText (.rst) file",
"version": "3.4.0",
"project_urls": {
"Homepage": "https://github.com/melexis/robot2rst"
},
"split_keywords": [
"robot",
"robotframework",
"sphinx",
"traceability"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "75147ac63fbc578c24003d0342503a092f66b737a2972df22ea6317589875edc",
"md5": "19ccccf00c17e3f8f07e2c06b5829c23",
"sha256": "753d784103dc553260a835a652715e1125e826a5bb17f00a13ff168e16bbffba"
},
"downloads": -1,
"filename": "mlx.robot2rst-3.4.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "19ccccf00c17e3f8f07e2c06b5829c23",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.7",
"size": 13699,
"upload_time": "2023-08-31T14:19:49",
"upload_time_iso_8601": "2023-08-31T14:19:49.931983Z",
"url": "https://files.pythonhosted.org/packages/75/14/7ac63fbc578c24003d0342503a092f66b737a2972df22ea6317589875edc/mlx.robot2rst-3.4.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e405e7314d67d06e23a025af976640466c233a865cdca3a323f99aa7a325086b",
"md5": "828de29c4d4a762eaba17228f975f4b0",
"sha256": "cdc52b8fab85792bc1ecf38c9e7a0ecf51e952e899da2b5b1325c51406fb5f00"
},
"downloads": -1,
"filename": "mlx.robot2rst-3.4.0.tar.gz",
"has_sig": false,
"md5_digest": "828de29c4d4a762eaba17228f975f4b0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 18673,
"upload_time": "2023-08-31T14:19:51",
"upload_time_iso_8601": "2023-08-31T14:19:51.074444Z",
"url": "https://files.pythonhosted.org/packages/e4/05/e7314d67d06e23a025af976640466c233a865cdca3a323f99aa7a325086b/mlx.robot2rst-3.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-31 14:19:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "melexis",
"github_project": "robot2rst",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "mlx.robot2rst"
}
JSON
