Beta

Get Started

Choose your OS & download

Gauge is in beta and collects usage statistics.

macOS

Install Gauge

Install Gauge using Homebrew.

$ brew update $ brew install gauge

For signed binaries download the zip installer and the run following command

$ unzip -o gauge-0.9.7-darwin.x86_64.zip -d /usr/local/bin

Other installers

See Gauge working

Initialize a new Gauge project in the language of your choice. You can read more about initialization here. This creates a template with a sample test specification and installs the required language runner. The example below shows how to execute test specifications in Java, but the same applies to all supported languages.

$ gauge init java

Now run the sample specification. This will install any missing plugins mentioned in project manifest and run the tests.

$ gauge run specs
Specifications:	1 executed	1 passed	0 failed	0 skipped
Scenarios:    	2 executed	2 passed	0 failed	0 skipped

Total time taken: 80ms

You're all set. Start testing!

Windows

Install Gauge

Install Gauge using Chocolatey

> choco install gauge

or download the zip installer and the run following command in powershell

PS> Expand-Archive -Path gauge-0.9.7-windows.x86_64.zip -DestinationPath custom_path

Other installers

See Gauge working

Initialize a new Gauge project in the language of your choice. This will also install the required language runner. You can read more about initialization here. This creates a template with a sample test specification. The example below shows how to execute test specifications in C#, but the same applies to all supported languages.

> gauge init csharp

Now run the sample specification. This will install any missing plugins mentioned in project manifest and run the tests.

> gauge run specs
Specifications:	1 executed	1 passed	0 failed	0 skipped
Scenarios:    	2 executed	2 passed	0 failed	0 skipped

Total time taken: 80ms

You're all set. Start testing!

Linux

Gauge can be installed on any flavour of Linux using the shell script. The following steps will guide you to a quick install on a linux box.

Install Gauge

Install Gauge using apt-get

$ sudo apt-key adv --keyserver hkp://pool.sks-keyservers.net --recv-keys 023EDB0B
$ echo deb https://dl.bintray.com/gauge/gauge-deb stable main | sudo tee -a /etc/apt/sources.list
$ sudo apt-get update
$ sudo apt-get install gauge

Install Gauge using dnf

$ echo -e "[gauge-stable]\nname=gauge-stable\nbaseurl=http://dl.bintray.com/gauge/gauge-rpm/gauge-stable\ngpgcheck=0\nenabled=1" | sudo tee /etc/yum.repos.d/gauge-stable.repo
$ sudo dnf install gauge

or download the zip installer and the run following command

$ unzip -o gauge-0.9.7-linux.x86_64.zip -d /usr/local/bin

Other installers

See Gauge working

Initialize a new Gauge project in the language of your choice. You can read more about initialization here. This creates a template with a sample test specification. The example below shows how to execute test specifications in Java, but the same applies to all supported languages.
$ gauge init java

Now run the sample specification. This will install any missing plugins mentioned in project manifest and run the tests.

$ gauge run specs
Specifications:	1 executed	1 passed	0 failed	0 skipped
Scenarios:    	2 executed	2 passed	0 failed	0 skipped

Total time taken: 80ms

You're all set. Start testing!

Curl

Install Gauge

Install Gauge to /usr/local/bin by running

$ curl -SsL https://downloads.gauge.org/stable | sh

or a [custom path]

$ curl -SsL https://downloads.gauge.org/stable | sh -s -- --location=[custom path]

See Gauge working

Initialize a new Gauge project in the language of your choice. You can read more about initialization here. This creates a template with a sample test specification. The example below shows how to execute test specifications in Java, but the same applies to all supported languages.
$ gauge init java

Now run the sample specification to see how Gauge works.

$ gauge run specs
Specifications:	1 executed	1 passed	0 failed	0 skipped
Scenarios:    	2 executed	2 passed	0 failed	0 skipped

Total time taken: 80ms

You're all set. Start testing!