Package overalls

Package overalls takes multi-package go projects, runs test coverage tests on all packages in each directory and finally concatenates into a single file for tools like goveralls.

Usage and documentation

Example

overalls -project=github.com/go-playground/overalls -covermode=count -debug

then with other tools such as goveralls

goveralls -coverprofile=overalls.coverprofile -service semaphore -repotoken $COVERALLS_TOKEN

$ overalls -help

usage: overalls -project=[path] -covermode[mode] OPTIONS -- TESTOPTIONS

overalls recursively traverses your projects directory structure running 'go test -covermode=count -coverprofile=profile.coverprofile' in each directory with go test files, concatenates them into one coverprofile in your root directory named 'overalls.coverprofile'

OPTIONS -project Your project path relative to the '$GOPATH/src' directory example: -project=github.com/go-playground/overalls

-covermode Mode to run when testing files. default:count

OPTIONAL

-ignore A comma separated list of directory names to ignore, relative to project path. example: -ignore=[.git,.hiddentdir...] default: '.git'

-debug A flag indicating whether to print debug messages. example: -debug default:false

-concurrency Limit the number of packages being processed at one time. The minimum value must be 2 or more when set. example: -concurrency=5 default: unlimited

TESTOPTIONS

Any flags after -- will be passed as-is to go test. For example:

overalls -project=$PROJECT -debug -- -race -v

Will call go test -race -v under the hood in addition to the -coverprofile commands.

How to Contribute

There will always be a development branch. In order to contribute, please make your pull requests against that branch.

If the changes being proposed or requested are breaking changes, please create an issue.

License