Code Climate

Test Coverage Troubleshooting Tips

Suggest Edits

Test Reporter: Troubleshooting and Getting Help

Having trouble setting up test coverage for your repo?

In addition to the the Configuring Test Coverage help doc, these topics provide additional troubleshooting context:

Basic requirements
Client-side considerations
Self help from technical documentation
Contact Support
Command Line Interface (CLI)
Common Questions
Specific error messages from the reporter

Common GitHub scenarios

Diff-coverage and total-coverage statuses are hanging
Generating test coverage for branches, but not seeing coverage results in GitHub

Need more help?

Open an issue or contact Support! Include the information listed here. ⬅️

Basic requirements:

  1. Do you have coverage reporting configured for one of our supported languages?
  2. Are you using the correct CC_TEST_REPORTER_ID?
  3. Are you using single or multiple test coverage setups? Setup varies for each.
  4. Are you running your tests outside of your root directory? You may need to use the --prefix option.
  5. Are you working with a Docker container? Check out this doc.

Client-side considerations:

  1. Coverage data is based on the data that you send us via your coverage payloads, which is created client-side.
  2. Try removing Code Climate from the equation:
    (1) Look at coverage results locally. Are they what you expect?
    (2) Are your results what you expect, regardless of Code Climate?
    (3) How are they different while looking at Code Climate?

Self help from technical documentation

  1. Output debug messages to your CI using the --debug flag with your cc-test-reporter.
  2. View uploaded reports (with potential errors) in the Code Climate UI. These can be found under the Recent Reports section at the following URL: codeclimate.com/repos/repo#/settings/test_reporter
  3. Search the test reporter GitHub project for specific error messages.
  4. Read the test reporter's README for detailed instructions and low level usage commands.
  5. Check out the sample/working test config files on the test reporter GitHub project here.
  6. Ask a question and open an issue on the test reporter repo itself.

Contact Support

Opening an Issue or contacting Support?

Please include:

  1. Repo name
  2. CI name
  3. If you use single, parallel or multi-suite builds
  4. A copy of your CI configuration file
  5. Output from your CI when using the --debug flag in your CI configuration
  6. Any relevant screenshots of your setup

open Issue | contact Support

Common Questions - FAQs

Common Problems and FAQs
Reason and Action

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

  1. You will only see default branch coverage in Code Climate's UI. 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.

Specific error messages from the reporter

Error Message
Description
Resolution

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

Test Coverage Troubleshooting Tips

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.