Popularity
4.1
Stable
Activity
0.0
Stable
98
3
26

Programming language: Go

overalls alternatives and similar packages

Based on the "Continuous Integration" category

Do you think we are missing an alternative of overalls or a related project?

Add another 'Continuous Integration' Package

README

Package overalls

Build Status GoDoc

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 and codecov.io.

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
or codecov.io
mv overalls.coverprofile coverage.txt
export CODECOV_TOKEN=###
bash <(curl -s https://codecov.io/bash)
note:
  1. goveralls and codecover currently do not calculate coverage the same way as go tool cover see here and here.

  2. overalls (and go test) by default will not calculate coverage "across" packages. E.g. if a test in package A covers code in package B overalls will not count it. You may or may not want this depending on whether you're more concerned about unit test coverage or integration test coverage. To enable add the coverpkg flag. overalls -project=github.com/go-playground/overalls -covermode=count -debug -- -coverpkg=./...

$ 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

Make a pull request.

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

License

Distributed under MIT License, please see license file in code for more details.


*Note that all licence references and agreements mentioned in the overalls README section above are relevant to that project's source code only.