Skip to main content

Codacy coverage reporter for Python

Project description

Credits to Ryan for creating this! Python coverage reporter for Codacy

Codacy Badge Codacy Badge Build Status PyPI version


Codacy assumes that coverage is previously configured for your project.

To generate the required coverage XML file, calculate coverage for your project as normal, by running:

coverage xml

Install codacy-coverage

You can install the coverage reporter by running:

pip install codacy-coverage

Updating Codacy

To update Codacy, you will need your project API token. You can create the token in Project -> Settings -> Integrations -> Add Integration -> Project API

Then set it in your terminal, replacing %Project_Token% with your own token:

export CODACY_PROJECT_TOKEN=%Project_Token%

Enterprise only (Skip this step if you are using

To send coverage in the enterprise version you should:

export CODACY_API_BASE_URL=<Codacy_instance_URL>:16006

Upload Coverage

Next, simply run the Codacy reporter. It will find the current commit and send all details to your project dashboard:

python-codacy-coverage -r coverage.xml

Note: You should keep your API token well protected, as it grants owner permissions to your projects.


If you are using any CI that does not have .git information, you can specify the commit with -c and the clone directory with -d. For example if you are using AppVeyor you can:

python-codacy-coverage -c $APPVEYOR_REPO_COMMIT -d $APPVEYOR_BUILD_FOLDER -r coverage.xml

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

codacy-coverage-1.3.11.tar.gz (5.2 kB view hashes)

Uploaded Source

Built Distribution

codacy_coverage-1.3.11-py2.py3-none-any.whl (7.5 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page