jripault / gauge-example-java

A sample project illustrating Gauge features using webdriver

Gauge example in Java

This is an example project for doing web automation testing with Gauge. This project tests some of the functionalities of the active admin demo app. This app is hosted as a Java WAR (with embedded Jetty).

Running this example

The tests are run on Chrome by default.

Prerequisites

This example requires the following softwares to run.

• Java 1.7 or above
  • Note that Gauge works with Java 1.6 and above. But this particular example uses Java 1.7
• Gauge
• Gauge Java plugin
  • can be installed using gauge --install java
• Chrome

Setting up the System Under Test (SUT)

• Download activeadmin-demo.war
• Bring up the SUT by executing the below command

java -jar activeadmin-demo.war

• The SUT should now be available at http://localhost:8080/

Run specs

If you already have Gradle installed, you can execute specs as gradle specs. Otherwise, you can use the gradle wrapper and run specs as below:

On Linux / Mac

./gradlew gauge

On Windows

gradlew.bat gauge

This runs Gauge specs with Gradle.

This uses Chrome as default browser for specs execution. Make sure Chrome is installed in your machine and chromedriver is in PATH.

If you want to use Firefox/IE as browser, pass the corresponding argument to set browser environment as follows:

./gradlew gauge -Penv=firefox
or
./gradlew gauge -Penv=ie

Note:

• Gauge can also be used with other build tools like maven and ant.
• You can use Gauge even without a build script!

Topics covered in the example

• Specification, Scenario, Step, Concepts and Context Steps
• Table parameters
• Using External datasource (special param)
• Using tags
• Using Gauge with Selenium Webdriver
• Running Gauge specs with Gradle

Copyright

Copyright 2016, ThoughtWorks Inc.