buckets

README

go-test-buckets

Split your go tests into buckets, or exclude some packages/directories.

Buckets

package main_test

import (
	"testing"

	// import to get bucket and exclude feature
	_ "github.com/Eun/go-test-buckets"
)

// run with BUCKET=0 TOTAL_BUCKETS=2 go test -count=1 -v ./...
// will run TestA and TestB

// run with BUCKET=1 TOTAL_BUCKETS=2 go test -count=1 -v ./...
// will run TestC

func TestA(t *testing.T) {
}

func TestB(t *testing.T) {
}

func TestC(t *testing.T) {
}

Excluding Packages/Directories

1. Add to your imports _ "github.com/Eun/go-test-buckets"
2. Run EXCLUDE_PACKAGES=package/path/to/exclude,package/path/to/exclude-2 go test -count=1 -v ./...
3. Or EXCLUDE_DIRECTORIES=/full/path/to/exclude go test -count=1 -v ./...

Because of go test package separation, you have to import github.com/Eun/go-test-buckets in each package you want to ignore.

Note that uses some nasty memory patching to make this possible. So use with care.

Why?

Speed up ci pipelines by parallelizing go tests without thinking about t.Parallel. And getting rid of weird piping go test $(go list ./... | grep -v /ignore/)

Documentation

Overview

Package buckets provides a way to separate go tests into buckets.