python-coveralls

What it is and what it does

python-coveralls is a command-line tool that sends code coverage reports from your local test runs to coveralls.io, a web service for tracking and visualizing test coverage trends. It reads coverage data from a .coverage file (generated by coverage, pytest-cov, or similar tools) and uploads it to Coveralls, where it integrates with CI/CD pipelines—particularly Travis CI—to comment on pull requests and track coverage over time.

The package is configured via a .coveralls.yml file at your repository root (specifying repo_token and service_name) or environment variables, and is typically invoked as a post-test step in CI. It has no runtime dependencies and installs cleanly, but development stopped in 2019 and the last commit was in early 2020, so it receives no updates or maintenance.

Use it for:

• Integrate code coverage reports into Travis CI or other CI systems by running coveralls after test suite completion.
• Track coverage trends over time on coveralls.io for pull request reviews and project health monitoring.
• Merge coverage data from parallel CI builds using the merge_file option to combine JavaScript and Python coverage.
• Configure coverage reporting for projects not using Travis by setting repo_token and service_name in .coveralls.yml.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Uploads Python code coverage reports to coveralls.io, integrating coverage data with the Coveralls service for tracking test coverage over time.

Yes, if you are actively using coveralls.io and need to upload coverage from a Python project—it remains functional for that narrow purpose. However, be aware the package is unmaintained since 2019 and will not receive updates for API changes or Python version support. If you are starting a new project, verify that coveralls.io has not released native tooling or that a maintained alternative does not better suit your CI platform.

Install

python-coveralls on PyPI

pip install python-coveralls

uv add python-coveralls

poetry add python-coveralls

Installing python-coveralls

Before you install

Low install friction with no runtime dependencies. However, the package is abandoned—last commit was 2020-02-04 and no releases since 2019-08-01. It remains functional for its narrow purpose but will not receive bug fixes or updates.

License in practice

Licensed under Apache License 2.0 (permissive). You may use, modify, and distribute the package freely, including in commercial projects, provided you retain the license notice.

Quickstart

pip install python-coveralls

After generating a .coverage file with coverage or pytest-cov:

coveralls

Or with a token:

COVERALLS_REPO_TOKEN=your_token coveralls

Requires a .coverage file generated by a coverage tool (coverage, pytest-cov, or nosexcover) and a repo_token from coveralls.io, either in .coveralls.yml or via environment variable.

Verify before relying

• Whether the package still works reliably with modern Python versions (classifiers list 2.7, 3.5, 3.6 but no newer).
• Whether coveralls.io API changes since 2020 have broken compatibility.
• Active alternatives or whether coveralls.io has native tooling that supersedes this package.

Package facts

Evidence: python_coveralls-2.9.3-py2.py3-none-any.whl

Keywords: coveralls.io

Tags

More Libraries packages