Skip to content

eclipse/reddeer

Repository files navigation

Eclipse RedDeer Testing Framework

Eclipse RedDeer project is an extensible framework used for development of automated SWT/Eclipse tests which interacts with application’s user interface. RedDeer provides the PageObjects API for comfortable testing of standard SWT (Buttons, Trees..), JFace (UIForms), Workbench (Views, Editors, ..) and Eclipse (Wizards, Preferences,...) components and also allows creating and extending your own components. RedDeer also provides capabilities to work with graphical editors based on GEF or Graphiti.

Eclipse RedDeer is extensively tested on Linux/CentOS platform. Examination of test results in CI environment is easier thanks to capturing screenshots on test failures and collecting Eclipse Platform log.

At this time RedDeer is not actively maintained

We are not currently actively developing and maintaining the framework, in case that you are interested in the maintaining the project, please contact the project leads.

Get the code

The easiest way to get started with the code is to create your own fork, then clone your fork and finally add upstream:

$ git clone [email protected]:<you>/reddeer.git
$ cd reddeer
$ git remote add upstream https://github.com/eclipse/reddeer.git

Build RedDeer locally

In case that you have the git repo cloned locally, you can build it using maven:

$ mvn clean install

If you just want to build the base and not to run tests, use this:

$ mvn clean install -DskipTests=true

Installation

Using RedDeer eclipse update site

Copy-Paste this URL to Eclipse Help -> Install New Software...:

https://download.eclipse.org/reddeer/releases/latest

Or latest nightly build:

https://download.eclipse.org/reddeer/snapshots

Finish the installation & restart IDE.

Using locally built artifacts

Search your repo for path-to-your-git/reddeer/site/repository and paste this path to Eclipse Help -> Install New Software...

Getting Started

Go through Getting Started guide.

Documentation

See RedDeer Documentation.

Contributing

See how to contribute to the project.

Contact us