---
id: python-coveralls
version: "2.9.3"
license: Apache License 2.0
license_treatment: permissive
maintenance: abandoned
---

# python-coveralls — Python interface to coveralls.io API


License: permissive · Maintenance: abandoned · Downloads: 132.3K/mo

## 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 above — 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

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

- License: Apache License 2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 132.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

coveralls.io integration, code coverage reporting, coverage upload service, CI coverage tracking, test coverage metrics, coverage-reporting, ci-integration, abandoned

[View on SkillFed](https://skillfed.io/packages/python-coveralls) · [View on PyPI](https://pypi.org/project/python-coveralls/)