Skip to main content

A generic test automation framework

Project description

Introduction

Robot Framework is a generic open source 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. See CONTRIBUTING.rst if you are interested to contribute. Downloads are hosted on PyPI, except for the standalone JAR distribution that is on Maven central.

Latest version Number of downloads License Slack channel

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.robot

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

Documentation

Support and contact

License

Robot Framework is open source software provided under under Apache License 2.0. Robot Framework 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 | RSS feed

This version

2.9.2

Download files

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

Source Distribution

robotframework-2.9.2.tar.gz (424.2 kB view details)

Uploaded Source

Built Distributions

robotframework-2.9.2.win-amd64.exe (775.3 kB view details)

Uploaded Source

robotframework-2.9.2.win32.exe (868.7 kB view details)

Uploaded Source

File details

Details for the file robotframework-2.9.2.tar.gz.

File metadata

File hashes

Hashes for robotframework-2.9.2.tar.gz
Algorithm Hash digest
SHA256 f98b4b3612f7758c0034ebce1baf6e52114ba4342c7da448c1a110d34484317c
MD5 5b7ed3cd22130044fe80f3165f5e0f52
BLAKE2b-256 9edb4d92084d487c0f26864383988a747fbbbcac02513e69a7b621e9efa7c75f

See more details on using hashes here.

File details

Details for the file robotframework-2.9.2.win-amd64.exe.

File metadata

File hashes

Hashes for robotframework-2.9.2.win-amd64.exe
Algorithm Hash digest
SHA256 8f522883683dc418dee8291abc3fa0561cc35c026e2a0dcb01b3351014ed8d66
MD5 09f2476b593a9b6db80ee1d36147a9d6
BLAKE2b-256 0490101e28afc98cac0948e8a94e97d535d2eba3465868fe3d7aff5146f888e9

See more details on using hashes here.

File details

Details for the file robotframework-2.9.2.win32.exe.

File metadata

File hashes

Hashes for robotframework-2.9.2.win32.exe
Algorithm Hash digest
SHA256 393bc64107a9894a13e8bb87899ab39f881a51cdaecc7eb449780d28ce5d7cd1
MD5 1106f16b64f61436f706541ae2510b1c
BLAKE2b-256 543972b92eb9233081004c3c4b39dc0e6eef336609d38eaa82a4e81c1373cba0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page