Robot Framework
===============
.. contents::
:local:
Introduction
------------
`Robot Framework <http://robotframework.org>`_ |r| is a generic open source
automation framework for acceptance testing, acceptance test driven
development (ATDD), and robotic process automation (RPA). It has simple plain
text syntax and it can be extended easily with generic and custom libraries.
Robot Framework is operating system and application independent. It is
implemented using `Python <http://python.org>`_ which is also the primary
language to extend it. The framework has a rich ecosystem around it consisting
of various generic libraries and tools that are developed as separate projects.
For more information about Robot Framework and the ecosystem, see
http://robotframework.org.
Robot Framework project is hosted on GitHub_ where you can find source code,
an issue tracker, and some further documentation. Downloads are hosted on PyPI_.
Robot Framework development is sponsored by non-profit `Robot Framework Foundation
<http://robotframework.org/foundation>`_. If you are using the framework
and benefiting from it, consider joining the foundation to help maintaining
the framework and developing it further.
.. _GitHub: https://github.com/robotframework/robotframework
.. _PyPI: https://pypi.python.org/pypi/robotframework
.. image:: https://img.shields.io/pypi/v/robotframework.svg?label=version
:target: https://pypi.python.org/pypi/robotframework
:alt: Latest version
.. image:: https://img.shields.io/pypi/l/robotframework.svg
:target: http://www.apache.org/licenses/LICENSE-2.0.html
:alt: License
Installation
------------
If you already have Python_ with `pip <https://pip.pypa.io>`_ installed,
you can simply run::
pip install robotframework
For more detailed installation instructions, including installing Python, see
`INSTALL.rst <https://github.com/robotframework/robotframework/blob/master/INSTALL.rst>`__.
Robot Framework requires Python 3.8 or newer and runs also on `PyPy <http://pypy.org>`_.
The latest version that supports Python 3.6 and 3.7 is `Robot Framework 6.1.1`__.
If you need to use Python 2, `Jython <http://jython.org>`_ or
`IronPython <http://ironpython.net>`_, you can use `Robot Framework 4.1.3`__.
__ https://github.com/robotframework/robotframework/tree/v6.1.1#readme
__ https://github.com/robotframework/robotframework/tree/v4.1.3#readme
Example
-------
Below is a simple example test case for testing login to some system.
You can find more examples with links to related demo projects from
http://robotframework.org.
.. code:: robotframework
*** Settings ***
Documentation A test suite with a single test for valid login.
...
... This test has a workflow that is created using keywords in
... the imported resource file.
Resource login.resource
*** Test Cases ***
Valid Login
Open Browser To Login Page
Input Username demo
Input Password mode
Submit Credentials
Welcome Page Should Be Open
[Teardown] Close Browser
Usage
-----
Tests (or tasks) are executed from the command line using the ``robot``
command or by executing the ``robot`` module directly like ``python -m robot`` .
The basic usage is giving a path to a test (or task) file or directory as an
argument with possible command line options before the path::
robot tests.robot
robot --variable BROWSER:Firefox --outputdir results path/to/tests/
Additionally, there is the ``rebot`` tool for combining results and otherwise
post-processing outputs::
rebot --name Example output1.xml output2.xml
Run ``robot --help`` and ``rebot --help`` for more information about the command
line usage. For a complete reference manual see `Robot Framework User Guide`_.
Documentation
-------------
- `Robot Framework User Guide
<http://robotframework.org/robotframework/#user-guide>`_
- `Standard libraries
<http://robotframework.org/robotframework/#standard-libraries>`_
- `API documentation <http://robot-framework.readthedocs.org>`_
- `General documentation <http://robotframework.org/>`_
Support and Contact
-------------------
- `Slack <http://slack.robotframework.org/>`_
- `Forum <https://forum.robotframework.org/>`_
- `robotframework-users
<https://groups.google.com/group/robotframework-users/>`_ mailing list
Contributing
------------
Interested to contribute to Robot Framework? Great! In that case it is a good
start by looking at the `CONTRIBUTING.rst <https://github.com/robotframework/robotframework/blob/master/CONTRIBUTING.rst>`__. If you
do not already have an issue you would like to work on, you can check
issues with `good new issue`__ and `help wanted`__ labels.
Remember also that there are many other tools and libraries in the wider
`Robot Framework ecosystem <http://robotframework.org>`_ that you can
contribute to!
__ https://github.com/robotframework/robotframework/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22
__ https://github.com/robotframework/robotframework/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22
License and Trademark
---------------------
Robot Framework is open source software provided under the `Apache License 2.0`__.
Robot Framework documentation and other similar content use the
`Creative Commons Attribution 3.0 Unported`__ license. Most libraries and tools
in the ecosystem are also open source, but they may use different licenses.
Robot Framework trademark is owned by `Robot Framework Foundation`_.
__ http://apache.org/licenses/LICENSE-2.0
__ http://creativecommons.org/licenses/by/3.0
.. |r| unicode:: U+00AE
Raw data
{
"_id": null,
"home_page": "https://robotframework.org",
"name": "robotframework",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "robotframework automation testautomation rpa testing acceptancetesting atdd bdd",
"author": "Pekka Kl\u00e4rck",
"author_email": "peke@eliga.fi",
"download_url": "https://files.pythonhosted.org/packages/d2/85/824b95cd3fcaf0eb6c353481b415871da4186e6414ba06a99772a48b960e/robotframework-7.1.1.zip",
"platform": "any",
"description": "Robot Framework\n===============\n\n.. contents::\n :local:\n\nIntroduction\n------------\n\n`Robot Framework <http://robotframework.org>`_ |r| is a generic open source\nautomation framework for acceptance testing, acceptance test driven\ndevelopment (ATDD), and robotic process automation (RPA). It has simple plain\ntext syntax and it can be extended easily with generic and custom libraries.\n\nRobot Framework is operating system and application independent. It is\nimplemented using `Python <http://python.org>`_ which is also the primary\nlanguage to extend it. The framework has a rich ecosystem around it consisting\nof various generic libraries and tools that are developed as separate projects.\nFor more information about Robot Framework and the ecosystem, see\nhttp://robotframework.org.\n\nRobot Framework project is hosted on GitHub_ where you can find source code,\nan issue tracker, and some further documentation. Downloads are hosted on PyPI_.\n\nRobot Framework development is sponsored by non-profit `Robot Framework Foundation\n<http://robotframework.org/foundation>`_. If you are using the framework\nand benefiting from it, consider joining the foundation to help maintaining\nthe framework and developing it further.\n\n.. _GitHub: https://github.com/robotframework/robotframework\n.. _PyPI: https://pypi.python.org/pypi/robotframework\n\n.. image:: https://img.shields.io/pypi/v/robotframework.svg?label=version\n :target: https://pypi.python.org/pypi/robotframework\n :alt: Latest version\n\n.. image:: https://img.shields.io/pypi/l/robotframework.svg\n :target: http://www.apache.org/licenses/LICENSE-2.0.html\n :alt: License\n\nInstallation\n------------\n\nIf you already have Python_ with `pip <https://pip.pypa.io>`_ installed,\nyou can simply run::\n\n pip install robotframework\n\nFor more detailed installation instructions, including installing Python, see\n`INSTALL.rst <https://github.com/robotframework/robotframework/blob/master/INSTALL.rst>`__.\n\nRobot Framework requires Python 3.8 or newer and runs also on `PyPy <http://pypy.org>`_.\nThe latest version that supports Python 3.6 and 3.7 is `Robot Framework 6.1.1`__.\nIf you need to use Python 2, `Jython <http://jython.org>`_ or\n`IronPython <http://ironpython.net>`_, you can use `Robot Framework 4.1.3`__.\n\n__ https://github.com/robotframework/robotframework/tree/v6.1.1#readme\n__ https://github.com/robotframework/robotframework/tree/v4.1.3#readme\n\nExample\n-------\n\nBelow is a simple example test case for testing login to some system.\nYou can find more examples with links to related demo projects from\nhttp://robotframework.org.\n\n.. code:: robotframework\n\n *** Settings ***\n Documentation A test suite with a single test for valid login.\n ...\n ... This test has a workflow that is created using keywords in\n ... the imported resource file.\n Resource login.resource\n\n *** Test Cases ***\n Valid Login\n Open Browser To Login Page\n Input Username demo\n Input Password mode\n Submit Credentials\n Welcome Page Should Be Open\n [Teardown] Close Browser\n\nUsage\n-----\n\nTests (or tasks) are executed from the command line using the ``robot``\ncommand or by executing the ``robot`` module directly like ``python -m robot`` .\n\nThe basic usage is giving a path to a test (or task) file or directory as an\nargument with possible command line options before the path::\n\n robot tests.robot\n robot --variable BROWSER:Firefox --outputdir results path/to/tests/\n\nAdditionally, there is the ``rebot`` tool for combining results and otherwise\npost-processing outputs::\n\n rebot --name Example output1.xml output2.xml\n\nRun ``robot --help`` and ``rebot --help`` for more information about the command\nline usage. For a complete reference manual see `Robot Framework User Guide`_.\n\nDocumentation\n-------------\n\n- `Robot Framework User Guide\n <http://robotframework.org/robotframework/#user-guide>`_\n- `Standard libraries\n <http://robotframework.org/robotframework/#standard-libraries>`_\n- `API documentation <http://robot-framework.readthedocs.org>`_\n- `General documentation <http://robotframework.org/>`_\n\nSupport and Contact\n-------------------\n\n- `Slack <http://slack.robotframework.org/>`_\n- `Forum <https://forum.robotframework.org/>`_\n- `robotframework-users\n <https://groups.google.com/group/robotframework-users/>`_ mailing list\n\nContributing\n------------\n\nInterested to contribute to Robot Framework? Great! In that case it is a good\nstart by looking at the `CONTRIBUTING.rst <https://github.com/robotframework/robotframework/blob/master/CONTRIBUTING.rst>`__. If you\ndo not already have an issue you would like to work on, you can check\nissues with `good new issue`__ and `help wanted`__ labels.\n\nRemember also that there are many other tools and libraries in the wider\n`Robot Framework ecosystem <http://robotframework.org>`_ that you can\ncontribute to!\n\n__ https://github.com/robotframework/robotframework/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22\n__ https://github.com/robotframework/robotframework/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22\n\nLicense and Trademark\n---------------------\n\nRobot Framework is open source software provided under the `Apache License 2.0`__.\nRobot Framework documentation and other similar content use the\n`Creative Commons Attribution 3.0 Unported`__ license. Most libraries and tools\nin the ecosystem are also open source, but they may use different licenses.\n\nRobot Framework trademark is owned by `Robot Framework Foundation`_.\n\n__ http://apache.org/licenses/LICENSE-2.0\n__ http://creativecommons.org/licenses/by/3.0\n\n.. |r| unicode:: U+00AE\n\n\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Generic automation framework for acceptance testing and robotic process automation (RPA)",
"version": "7.1.1",
"project_urls": {
"Documentation": "https://robotframework.org/robotframework",
"Download": "https://pypi.org/project/robotframework",
"Homepage": "https://robotframework.org",
"Issue Tracker": "https://github.com/robotframework/robotframework/issues",
"Release Notes": "https://github.com/robotframework/robotframework/blob/master/doc/releasenotes/rf-7.1.1.rst",
"Slack": "http://slack.robotframework.org",
"Source": "https://github.com/robotframework/robotframework"
},
"split_keywords": [
"robotframework",
"automation",
"testautomation",
"rpa",
"testing",
"acceptancetesting",
"atdd",
"bdd"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bb3ca1f0971f4405c5accea879e84be91fb98956d778ff1cfc232410fc8558ae",
"md5": "6984458421ef8f7a0e40455222361ed2",
"sha256": "0461360be00dfb8ce1ab3f42370fa6eea3779e41c0b8d79a1f8ddcd2ec8e3679"
},
"downloads": -1,
"filename": "robotframework-7.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6984458421ef8f7a0e40455222361ed2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 730648,
"upload_time": "2024-10-19T12:34:19",
"upload_time_iso_8601": "2024-10-19T12:34:19.116680Z",
"url": "https://files.pythonhosted.org/packages/bb/3c/a1f0971f4405c5accea879e84be91fb98956d778ff1cfc232410fc8558ae/robotframework-7.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d285824b95cd3fcaf0eb6c353481b415871da4186e6414ba06a99772a48b960e",
"md5": "274381b7fb4dadee55b066ebfc443075",
"sha256": "f85919c68c4d0837006e5f09dde1ef689f082eba2e7e64d5758753f9ee8bfea9"
},
"downloads": -1,
"filename": "robotframework-7.1.1.zip",
"has_sig": false,
"md5_digest": "274381b7fb4dadee55b066ebfc443075",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 761336,
"upload_time": "2024-10-19T12:34:23",
"upload_time_iso_8601": "2024-10-19T12:34:23.091333Z",
"url": "https://files.pythonhosted.org/packages/d2/85/824b95cd3fcaf0eb6c353481b415871da4186e6414ba06a99772a48b960e/robotframework-7.1.1.zip",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-19 12:34:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "robotframework",
"github_project": "robotframework",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "robotframework"
}
JSON
