Skip to main content

A generic test automation framework

Project description

Introduction

Robot Framework is a generic test automation framework for acceptance testing and acceptance test-driven development (ATDD). It has easy-to-use tabular test data syntax and it utilizes the keyword-driven testing approach. Its testing capabilities can be extended by test libraries implemented either with Python or Java, and users can create new higher-level keywords from existing ones using the same syntax that is used for creating test cases.

Robot Framework is operating system and application independent. The core framework is implemented using Python and runs also on Jython (JVM) and IronPython (.NET). The framework has a rich ecosystem around it consisting of various generic test 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 at PyPI, except for the standalone jar distribution that is in Maven central.

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 or cloning the project 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.txt

*** 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

Robot Framework is executed from the command line using pybot, jybot or ipybot scripts, depending is it run on Python, Jython or IronPython. 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. Additionally there is rebot tool for combining results and otherwise post-processing outputs:

pybot tests.txt
jybot --variable HOST:example.com --outputdir results path/to/tests/
rebot --name Example output1.xml output2.xml

Run pybot --help and rebot --help for more information about the command line usage. For a complete reference manual see Robot Framework User Guide.

License

Robot Framework code is provided under Apache License 2.0. Documentation and other similar content use Creative Commons Attribution 3.0 Unported license. Most libraries and tools in the ecosystem are also open source, but they may use different licenses.

Project details


Release history Release notifications

History Node

3.0.4

History Node

3.0.4rc1

History Node

3.0.3

History Node

3.0.3rc1

History Node

3.0.2

History Node

3.0.2rc1

History Node

3.0.1

History Node

3.0.1rc2

History Node

3.0.1rc1

History Node

3.0

History Node

3.0b1

History Node

3.0a2

History Node

3.0a1

History Node

2.9.2

History Node

2.9.1

History Node

2.9

History Node

2.9rc1

History Node

2.9b2

History Node

2.9b1

History Node

2.9a3

History Node

2.9a2

History Node

2.9a1

History Node

2.8.7

History Node

2.8.6

History Node

2.8.6b1

This version
History Node

2.8.5

History Node

2.8.4

History Node

2.8.3

History Node

2.8.2

History Node

2.8.1

History Node

2.8

History Node

2.7.7

History Node

2.7.6

History Node

2.7.5

History Node

2.7.4

History Node

2.7.3

History Node

2.7.2

History Node

2.7.1

History Node

2.7

History Node

2.6.3

History Node

2.6.2

History Node

2.6.1

History Node

2.5.7

History Node

2.5.6

History Node

2.5.5

History Node

2.5.3

History Node

2.5.2

History Node

2.5.1

History Node

2.5

History Node

2.1.3

History Node

2.1.2

History Node

2.1.1

History Node

2.1

History Node

2.0.4

History Node

2.0.3

History Node

2.0.2

History Node

2.0.1

History Node

2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
robotframework-2.8.5.tar.gz (591.7 kB) Copy SHA256 hash SHA256 Source None Jun 17, 2014
robotframework-2.8.5.win32.exe (813.7 kB) Copy SHA256 hash SHA256 Windows Installer any Jun 17, 2014
robotframework-2.8.5.win-amd64.exe (841.3 kB) Copy SHA256 hash SHA256 Windows Installer any Jun 17, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page