Local test proof

Prove your local test run in every pull request.

Gotsha runs tests and linters on your machine, stores the result in Git notes, and lets reviewers verify it in GitHub or GitLab.

View project on GitHub Open demo pull request

Tests run locally
Results attached with Git notes
CI verifies the Git note

$ git commit -m "Refactor parser"
Running `rubocop`...
Running `rspec --order rand`...

✓ Gotsha: commit verified
Stored result for SHA b24100c

$ git push
✓ Gotsha: tests passed

Install

Gotsha is distributed as a Ruby gem, so you need to have Ruby working on your system. Apart from that, the only other dependency is Git.

Gotsha will guide you through setup. It should take less than 3 minutes. If you get stuck, run gotsha help.

$ gem install gotsha
# or add gem "gotsha" to your Gemfile

$ gotsha init
$ gotsha configure
# opens the short project config

How it works

Run tests locally

Run the project test suite automatically on commit or push, or manually right before you ask for review.

Attach results to the SHA

The full result is stored as a Git note for the current commit SHA.

Show status in review

Push as usual. A small CI script verifies the note and exposes the result in your PR or MR.

Terminal output showing Gotsha verifying a commit — Commit hook verifies the local run

Terminal output showing Gotsha test results being pushed — Push includes the test result note

GitHub Action output verifying Gotsha results — GitHub Action checks the note

GitHub commit checks showing Gotsha status — Reviewers see the status on the commit