codecov

Python report uploader for Codecov

Showing:

Popularity

Downloads/wk

0

GitHub Stars

172

Maintenance

Last Commit

20d ago

Contributors

61

Package

Dependencies

2

License

Apache 2.0

Categories

Readme

🚨🚨 Deprecation Notice 🚨🚨

This uploader is being deprecated by the Codecov team. We recommend migrating to our new uploader as soon as possible to prevent any lapses in coverage. The new uploader is open source, and we highly encourage submitting Issues and Pull Requests.

You can visit our blog post to learn more about our deprecation plan

On February 1, 2022 this uploader will be completely deprecated and will no longer be able to upload coverage to Codecov.

Codecov Global Python Uploader

codecov.io PyPI Code style: black

FOSSA Status

SupportDocumentationCommunity BoardsTwitter

Find coverage reports for all the languages below, gather them and submit them to Codecov.

Codecov Features

  • Reports are automatically combined with no extra setup. Each build is stored separately and combined.
  • Multiple languages are supported in a single upload and repository.
  • Optionally stores environment variables per build.

Usage

pip install --user codecov && codecov -t <the-repository-upload-token>

or

conda install -c conda-forge codecov && codecov -t <the-repository-upload-token>

--user argument not needed for Python projects. See example here.

Languages

Python, C#/.net, Java, Node/Javascript/Coffee, C/C++, D, Go, Groovy, Kotlin, PHP, R, Scala, Xtern, Xcode, Lua and more...

Using tox?

Codecov can be set up in your tox.ini.

Just please make sure to pass all the necessary environment variables through:

[testenv]
passenv = TOXENV CI TRAVIS TRAVIS_* CODECOV_*
deps = codecov>=1.4.0
commands = codecov -e TOXENV

See all the environment variables for other CI providers here

Configuration

Below are the most commonly used settings.

ArgumentEnvironmentDescription
-tCODECOV_TOKENPrivate repo token for uploading
-eCODECOV_ENVList of config vars to store for the build
-FFlag this upload to group coverage reports. Ex. unittests or integration
# public repository on Travis CI
install:
  - pip install --user codecov
# or
  - conda install -c conda-forge codecov
after_success:
  - codecov
# private repository on Travis CI
install:
  - pip install codecov
# or
  - conda install -c conda-forge codecov
after_success:
  - codecov -t the-repository-upload-token

CI Providers

CompanySupportedToken Required
AppVeyorYes Build statusPrivate only
Bamboocoming soon
Buildbotcoming soon buildbot/buildbot#1671
CircleCIYesPrivate only
CodeshipYesPublic & Private
Drone.ioYesPublic & Private
GitHub ActionsYes Build statusPublic & Private
Gitlab CIYesPublic & Private
JenkinsYesPublic & Private
Magnum CIYesPublic & Private
SemaphoreYesPublic & Private
ShippableYesPublic & Private
Solano Labscoming soon
Travis CIYes Build StatusPrivate only
WerckerYesPublic & Private
Cirrus CIYesPrivate only
Git / MercurialYes (as a fallback)Public & Private

Troubleshooting

If you're seeing an HTTP 400 error when uploading reports to S3, make sure you've updated to at least version 2.1.3.

Copyright 2014-2020 codecov

License

FOSSA Status

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100