Repolode
Submit
TheKevJames

TheKevJames/coveralls-python

Python package that uploads coverage.py results to coveralls.io to publish coverage stats online.

View on GitHubWebsite
Stars
573
Forks
186
Open issues
2
Last commit
4 hours ago

What is it?

Coveralls for Python is a client that sends test coverage data from a Python project to coveralls.io, a hosted service that publishes coverage statistics online. It integrates with coverage.py, so any test runner that coverage.py can wrap, such as pytest or nosetests, can feed its results into the service.

The typical workflow is to run your tests under coverage, then run the coveralls command to upload the report. The package is installed from PyPI and is also available through conda-forge and Docker images.

The project's documentation covers usage instructions, and the package states which Python versions and coverage.py versions are supported, with older environments pinned to the 1.x line.

Key features

  • 01Uploads coverage.py reports to coveralls.io with a single command.
  • 02Works with pytest, nosetests, and other runners wrapped by coverage.py.
  • 03Installable from PyPI, conda-forge, and Docker images.
  • 04Supports multiple Python versions and implementations.

Use cases

  • Publishing test coverage badges and reports for a Python project on coveralls.io.
  • Adding coverage upload as a step in CI pipelines after running tests.
  • Tracking coverage changes over time for a Python codebase.

Quick start

  1. 1

    Install the coveralls package from PyPI

    pip install coveralls
  2. 2

    Run your tests under coverage.py for your package

    coverage run --source=mypkg -m pytest tests/
  3. 3

    Upload the coverage results to coveralls.io

    coveralls

Things to know

  • Uploading requires a coveralls.io account and repository token, which the README points to documentation for.

In collections

Testing frameworks & test automation tools

Topics

#python#code-coverage#testing#ci#pytest#coverage-py#coverage#coveralls#nosetests

FAQ

What is coveralls-python?
Python package that uploads coverage.py results to coveralls.io to publish coverage stats online. Coveralls for Python is a client that sends test coverage data from a Python project to coveralls.io, a hosted service that publishes coverage statistics online. It integrates with coverage.py, so any test runner that coverage.py can wrap, such as pytest or nosetests, can feed its results into the service.
Is coveralls-python free to use? What license does it have?
coveralls-python is open source under the MIT license. Check the license terms before using it in commercial products.
Is coveralls-python still maintained?
Actively maintained. The last commit to coveralls-python was on Nov 7, 2026.
What can I use coveralls-python for?
Publishing test coverage badges and reports for a Python project on coveralls.io. Adding coverage upload as a step in CI pipelines after running tests. Tracking coverage changes over time for a Python codebase.
How do I install coveralls-python?
Install the coveralls package from PyPI: pip install coveralls Run your tests under coverage.py for your package: coverage run --source=mypkg -m pytest tests/ Upload the coverage results to coveralls.io: coveralls
Where can I get coveralls-python?
The source code and installation instructions are on GitHub: https://github.com/TheKevJames/coveralls-python

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects

mbj / mutant

Mutation testing for Ruby that modifies your code and reports which changes your test suite fails to catch.

Developer Tools#mutation-testing#ruby#testing
2.2K163RubyOtherWell maintainedUpdated yesterday