robotframework-imagehorizonlibrary 0.1

Cross-platform Robot Framework library for GUI automation based on image recognition

This Robot Framework library provides the facilities to automate GUIs based on image recognition similar to Sikuli. This library wraps pyautogui to achieve this.

Keyword documentation

Keyword Documentation

Travis CI

Travis CI

Prerequisites

• Python 2.7+ (unfortunately not 3.x)

• pip for easy installation

• pyautogui and it’s prerequisites

• Robot Framework

On OS X, Retina display might double all coordinates from what they are suppose to be. Unfortunately you need to work around this problem yourself.

On Ubuntu, you need to take special measures to make the screenshot functionality to work correctly. The keyboard functions might not work on Ubuntu when run in VirtualBox on Windows.

Development

• mock

Installation

If you have pip, installation is straightforward, although you need to explicitly install pillow first:

$ pip install pillow
$ pip install robotframework-imagehorizonlibrary

This will automatically install dependencies as well as their dependencies.

Windows

ImageHorizonLibrary should work on Windows “out-of-the-box”. Just run the commands above to install it.

OSX

You additionally need to install these for pyautogui:

$ pip install pyobjc-core pyobjc

For these, you need to install XCode

Linux

You additionally need to install these for pyautogui:

$ sudo apt-get install python-dev python-xlib
$ sudo pip install pillow

You might also need, depending on your Python distribution, to install:

$ sudo apt-get install python-tk

If you are using virtualenv, you must install python-xlib manually to the virtual environment for pyautogui:

• Fetch the source distribution

• Install with:

  $ pip install python-xlib-<latest version>.tar.gz

Running tests

$ python tests/utest/run_tests.py [verbosity=2]

and

$ python tests/atest/run_tests.py