I see a "successfully sent" message in my CI, but no results show in Code Climate's UI.

1. In order to coverage info in the Code Climate UI, you'll need to send a test report for your default branch. If you've only setup the test reporter on a feature branch, then reports won't be uploaded for the default branch. If you're successfully uploaded reports, but still not seeing coverage info in the UI, it's most likely because you haven't yet sent a test report for the default branch. Coverage info for non-default branches is visible in GitHub using the browser extension.

2. Possibly due to malformed payloads. Head to codeclimate.com/repos/repo#/settings/test_reporter to view a list of uploaded reports and potential errors. Add the --debug flag to view additional output.

3. Make sure that you're sending ENV (not Git) values. See this doc

4. Check to see if you're pinning to a specific test coverage reporter version.

Where should I put the --debug flag?

1. If you're running your tests in single builds, use after-build --debug.

2. For tests run in parallel, please use both format-coverage --debug and upload-coverage --debug.

What CI-specific environmental variables and calls should I use?

1. Although the same basic variables are needed, we've found that each CI's naming of variables and calls can be quite different.

2. Check our CI sample config files in our help docs here as well as in the test reporter project.

3. See this doc.

Coverage results from one repo are showing on a different repo.

1. You might be using the incorrect CC_TEST_REPORTER_ID.

2. Check the test reporter id used in your test coverage config file or CI configurations.

When Code Climate is down, it causes my builds to fail because I can't upload my coverage reports. How can I fix this?

1. We're looking to update our reporter to account for this. In the meantime, we recommend the following workaround:

   after-build || echo “Skipping CC coverage upload” or upload-coverage || echo “Skipping CC coverage upload”

My total-coverage or diff-coverage statuses are hanging in my PR, but my CI said the coverage info was "successfully sent".

1. See this doc.

Error: you must supply a CC_TEST_REPORTER_ID ENV variable or pass it via the --id/-r flag

The reporter is unable to find your repo's test reporter ID. This value either needs to configured within the environment or passed directly as a CLI argument.

export CC_TEST_REPORTER_ID=<your token> cc-test-reporter after-build --exit-code $?

OR

export CC_TEST_REPORTER_ID=<your token> cc-test-reporter after-build --id <your token> --exit-code $?

Error: file not found

The reporter is unable to find a file referenced with the test report. Does that file exist within your git repository? Was your test suite run within a different filesystem (such as in a docker container)?

You may need to specify a prefix value.

For example, if you're running the tests within a docker container and your app code is located at /usr/src/app, the reporter run outside of the docker container will not be able to find files at the same absolute path.

Pass --prefix /usr/src/app to instruct the test reporter to strip the unknown base path.

Invalid path part

Most often, this is related to:

1. The reporter not able to find your test coverage results to upload them to Code Climate.
2. The reporter encountering a file that it can't process

For #1, adding the -- prefix option to make the path mentioned relative to the project root.

For #2, try excluding the mentioned file from your test coverage payloads. If you need the coverage results of that file, contact us and we'll help.

Error: not find any viable formatter. available formatters: simplecov, lcov, coverage.py, clover, gocov, gcov, cobertura, jacoco

The reporter is unable to find a formatter.

This is often seen with Java projects, when the the path to source code can't be inferred.

Solution:

Instead of after-build, please use:

1. format-coverage, which includes:

• JACOCO_SOURCE_PATH: the path to Java source files (a new environment variable)

• coverage file: to path to JaCoCo coverage XML file (the first argument)
  upload-coverage

AND

2. upload-coverage

Invalid certificate

When using the --insecure flag, any batch request will be made using HTTP, but the the main endpoint will still use the URL specified CC_TEST_REPORTER_COVERAGE_ENDPOINT.

Change the endpoint from https:

export CC_TEST_REPORTER_COVERAGE_ENDPOINT=https://codeclimate.corporate.domain.com/api/v1/test_reports

To http:

export CC_TEST_REPORTER_COVERAGE_ENDPOINT=http://codeclimate.corporate.domain.com/api/v1/test_reports