Gotsha — your local testing CI

Pushing untested commits? Gotsha!

gem install gotsha # or add `gem "gotsha"` to you Gemfile

gotsha init
gotsha configure # this will open the config file; it's short and very important, so please, read it :-)

If you got stuck somewhere, you can always use gotsha help.

Gotsha is a tiny tool that lets you “sign off” your commit locally: it runs your tests and then stores the test results with the commit SHA (hence the gem name: got-SHA). Your pull request can then be verified against that record, so reviewers know you actually ran the checks before asking for review.

Instead of pushing everything to CI, you can run the same checks locally (faster, cheaper, works offline) and prove you did it. Gotsha will make this proof visible in your pull request.

And the best part? It all happens automatically!

Then, you can see the tests results in a Github action:

(Screenshots from a real demo pull request; check it out!)

Based on your workflow and tests speed, you can configure them to auto-run on every commit, before every push, or just manually. Whenever pushing to remote repository, the Git note (which is what's used to store the test results) gets sent there as well.

Both Github and GitLab are supported out of the box!

I like coffee!