Installation
If you already have Python with pip installed, you can simply run:
pip install robotframework
Alternatively you can get Robot Framework source code by downloading the source distribution from PyPI and extracting it, or by cloning the project repository from GitHub. After that you can install the framework with:
python setup.py install
For more detailed installation instructions, including installing Python, Jython and IronPython, see INSTALL.rst.
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.
*** 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 resource.robot *** Test Cases *** Valid Login Open Browser To Login Page Input Username demo Input Password mode Submit Credentials Welcome Page Should Be Open Close Browser
Usage
Starting from Robot Framework 3.0, tests are executed from the command line using the robot script or by executing therobot module directly like python -m robot or jython -m robot. Older Robot Framework versions have Python interpreter specific pybot, jybot and ipybot scripts that still work but will be deprecated and removed in the future.
The basic usage is giving a path to a test case file or directory as an argument with possible command line options before the path:
robot tests.robot
robot --variable HOST:example.com --outputdir results path/to/tests/
Additionally there is 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.