Test Alligator

Getting Started

Download the gotest client
(and put it in your PATH)

Register as a new user

Edit your initial project or create a new project

Copy the gotest -init command for your project

Inside the project directory where you would usually run go test ./... , setup the .gotest configuration with:

or edit .gotest to have

Run gotest as you would go test, e.g.:

That's it. It runs the tests and uploads the results. Result history viewable on your project page at testaligator.com.

Backtest Mode

Backtest mode has the gotest client run git checkout on previous commits on the current branch, run the tests, and upload test results backdated to the time of the commit

Backtest mode should return the checkout repo to its previous state when done.

-backtest-n N
-backtest-since yyyy-mm-dd
-backtest-acommit commithash
-backtest-one commithash

Examples

gotest -backtest-n 200 ./...

Runs git log to find the last 200 commits, checks out each one, runs go test ./... and records the result on the Test Alligator server (backdated to the time of the commit)

gotest -backtest-since 2025-01-01 ./...

Runs git log for commit history, checks out each commit after the target date, runs go test ./... and records the result on the Test Alligator server (backdated to the time of the commit)

gotest -backtest-acommit f7ec249076fd54409232eb81795dcdb12bad58e4 ./...

Runs git log for commit history, checks out commit after f7ec249076fd54409232eb81795dcdb12bad58e4, runs go test ./... and records the result on the Test Alligator server (backdated to the time of the commit)

gotest -backtest-one f7ec249076fd54409232eb81795dcdb12bad58e4 200 ./...

Runs git checkout f7ec249076fd54409232eb81795dcdb12bad58e4, runs go test ./... and records the result on the Test Alligator server (backdated to the time of the commit)