Skip to main content

Introduction

Robot Framework ® 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 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. If you are using the framework and benefiting from it, consider joining the foundation to help maintaining the framework and developing it further.

Latest version License

Installation

If you already have Python with pip installed, you can simply run:

pip install robotframework

For more detailed installation instructions, including installing Python, see INSTALL.rst.

Robot Framework requires Python 3.8 or newer and runs also on PyPy. 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 or IronPython, you can use Robot Framework 4.1.3.

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

Support and Contact

Contributing

Interested to contribute to Robot Framework? Great! In that case it is a good start by looking at the 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 that you can contribute to!

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.

Download files

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

Source Distribution

robotframework-7.5.tar.gz (684.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

robotframework-7.5-py3-none-any.whl (842.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: robotframework-7.5.tar.gz
  • Upload date:
  • Size: 684.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.8.10

File hashes

Hashes for robotframework-7.5.tar.gz
Algorithm Hash digest
SHA256 ff6233ff752a200ece4d0a6c59f6f9f7d0e96dcff0a7a3458296b997b812482e
MD5 d5a94a7ba66baaa6b28a12a8b4a637d1
BLAKE2b-256 66775f60e5619082d387971d111c1354f1f529d2959ee742877982002d38d53d

See more details on using hashes here.

File details

Details for the file robotframework-7.5-py3-none-any.whl.

File metadata

  • Download URL: robotframework-7.5-py3-none-any.whl
  • Upload date:
  • Size: 842.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.8.10

File hashes

Hashes for robotframework-7.5-py3-none-any.whl
Algorithm Hash digest
SHA256 5a194db36524604fafa1da89adebc837db9a95adf15ffd746e09ce98251e6c68
MD5 06529b9771219e08d107b35de4d34172
BLAKE2b-256 c7f13075460f0a0d3ac52aa607a843860a61ac578b51d80a0980ebf5e30486bc

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

7.5 This release

2 files

7.4.2

2 files

7.4.1

2 files

7.4

2 files

7.3.2

2 files

7.3.1

2 files

7.3

2 files

7.2.2

2 files

7.2.1

2 files

7.2

2 files

7.1.1

2 files

7.1

2 files

7.0.1

2 files

7.0

2 files

6.1.1

2 files

6.1

2 files

6.0.2

2 files

6.0.1

2 files

6.0

2 files

5.0.1

2 files

5.0

2 files

4.1.3

2 files

4.1.2

2 files

4.1.1

2 files

4.1

2 files

4.0.3

2 files

4.0.2

2 files

4.0.1

2 files

4.0

2 files

3.2.2

2 files

3.2.1

2 files

3.2

2 files

3.1.2

2 files

3.1.1

2 files

3.1

2 files

3.0.4

1 file

3.0.3

1 file

3.0.2

1 file

3.0.1

1 file

3.0

1 file

2.9.2

3 files

2.9.1

3 files

2.9

3 files

2.8.7

3 files

2.8.6

3 files

2.8.5

3 files

2.8.4

3 files

2.8.3

3 files

2.8.2

3 files

2.8.1

2.8

2.7.7

2.7.6

2.7.5

2.7.4

2.7.3

2.7.2

2.7.1

2.7

2.6.3

2.6.2

2.6.1

2.5.7

2.5.6

2.5.5

2.5.3

2.5.2

2.5.1

2.5

2.1.3

2.1.2

2.1.1

2.1

2.0.4

2.0.3

2.0.2

2.0.1

2.0

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page