Python Testing automation bdd CSS Shell testautomation JavaScript HTML Java attd robotframework rpa
Need help with robotframework?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.
robotframework

Description

Generic automation framework for acceptance testing and RPA

5.3K Stars 1.5K Forks Other 12.6K Commits 195 Opened issues

Services available

Need anything else?

Robot Framework

.. contents:: :local:

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 libraries implemented using Python or Java.

Robot Framework is operating system and application independent. The core framework is implemented using

Python 
, supports both Python 2.7 and Python 3.5+, and runs also on
Jython 
(JVM),
IronPython 
_ (.NET) and
PyPy 
_. 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. See

__
if you are interested to contribute. Downloads are hosted on PyPI, except
for the standalone JAR distribution that is on 
Maven central
.

Robot Framework development is sponsored by

Robot Framework Foundation
_.

.. _GitHub: https://github.com/robotframework/robotframework .. _PyPI: https://pypi.python.org/pypi/robotframework .. _Maven central: http://search.maven.org/#search%7Cga%7C1%7Ca%3Arobotframework

.. 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 
_ 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, IronPython and PyPy or installing from git, see

__.

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

Tests (or tasks) are executed from the command line using the

robot
command or by executing the
robot
module directly like
python -m robot
or
jython -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
    
    _
  • Standard libraries
    
    _
  • Built-in tools
    
    _
  • API documentation
    
    _
  • General documentation and demos
    
    _

Support and contact

  • robotframework-users
    
    _ mailing list
  • Slack 
    _ community
  • #robotframework 
    _ IRC channel on freenode
  • @robotframework 
    _ on Twitter
  • Other forums 
    _

Contributing

Interested to contribute to Robot Framework? Great! In that case it is a good start by looking at the

Contribution guidelines 
. 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!

__ 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

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.

__ http://apache.org/licenses/LICENSE-2.0 __ http://creativecommons.org/licenses/by/3.0

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.