jbadeau / gauge-java

Java runner for Gauge

Gauge-Java

This project adds java language plugin for gauge.

Getting started

Pre-requisite

• Install Gauge
• Java

Installation

gauge install java

Create a gauge-java project

gauge init java

Run tests

gauge run specs

Alternate Installation options

Install specific version

• Installing specific version

gauge install java --version 0.6.5

Offline installation

• Download the plugin from Releases

gauge install java --file gauge-java-0.6.5-windows.x86_64.zip

Build from source

The plugin is authored in Java. Gauge is authored in golang. These are independent processes talking to each other over TCP on port GAUGE_INTERNAL_PORT (env variable) using Protobuf. This project contains a launcher component (gauge-java.go) written in golang which is used to start the plugin from gauge.

Additional Requirements

Apart from Gauge and Java you will need

• Golang
• Maven

Compiling

go run make.go

For cross platform compilation (launcher)

go run make.go --all-platforms

Installing

After compilation

go run make.go --install

Installing to a CUSTOM_LOCATION

go run make.go --install --plugin-prefix CUSTOM_LOCATION

Creating distributable

Note: Run after compiling

go run make.go --distro

For distributable across platforms os, windows and linux for bith x86 and x86_64

go run make.go --distro --all-platforms

New distribution details need to be updated in the java-install.json file in gauge plugin repository for a new verison update.

License

This program is dual-licensed under:

1. the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version; or
2. the Eclipse Public License v1.0. You can redistribute it and/or modify it under the terms of either license.

Copyright

Copyright 2016 ThoughtWorks, Inc.

Acknowledgements

This project is supported by YourKit Java Profiler. YourKit supports open source projects with its full-featured Java Profiler, which is used by Gauge Team.