General Support

Language Integrations

Coveralls API

Parallel Builds Webhook

When your CI is building in parallel, you’ll want your coverage results to be merged after all have completed.

Set this var in your CI’s build environment:

COVERALLS_PARALLEL=true

Then set up a post build webhook like so:

https://coveralls.io/webhook?repo_token=(your repo token)

TRAVIS SETUP

Add the following to your .travis.yml:

notifications:
  webhooks: https://coveralls.io/webhook?repo_token=COVERALLS_REPO_TOKEN

With public repos, you can omit the repo token

notifications:
  webhooks: https://coveralls.io/webhook

CIRCLECI SETUP

Add the following to your circle.yml:

notify:
  webhooks:
    - url: https://coveralls.io/webhook?repo_token=(your repo token)

THE PAYLOAD

The payload is automatically parsed for Tddium (Solano Labs), Travis, Semaphore, and CircleCI. Otherwise, it will need to conform to this JSON structure:

{
  "payload": {
       "build_num": 1234,
       "status": "done"
     }
}

This format can be used for an example shell script:

curl -k $COVERALLS_ENDPOINT/webhook?repo_token=$COVERALLS_REPO_TOKEN -d "payload[build_num]=$BUILD_NUMBER&payload[status]=done"