coveralls

What it is and what it does

Coveralls is a Python client that publishes test coverage reports to the coveralls.io service. It wraps coverage.py output and sends it to coveralls.io's servers, allowing teams to track coverage metrics over time and across builds. The package integrates into typical test workflows: you run coverage.py to generate metrics, then invoke coveralls to upload them. It depends on coverage, requests, and typer.

The package is designed for CI/CD pipelines where coverage reports need to be centralized and visualized. It requires Python 3.10 or later and is actively maintained with no known security vulnerabilities. Installation is straightforward and install friction is low.

Use it for:

• Publish coverage reports from CI/CD pipelines to track test coverage trends over time.
• Integrate coverage metrics into pull request checks to enforce minimum coverage thresholds.
• Centralize coverage data from multiple test runs or branches in a single dashboard.
• Generate coverage badges for README files to display test coverage status.
• Monitor coverage regressions across different Python versions or implementations.

Worth the install?

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

Uploads Python test coverage reports to coveralls.io, integrating with coverage.py to publish coverage metrics online.

Yes. Coveralls is actively maintained, has no known vulnerabilities, low install friction, and a permissive MIT license. It is the standard tool for publishing coverage to coveralls.io and integrates cleanly into existing coverage.py workflows. Install it if you use coveralls.io for coverage tracking.

Install

coveralls on PyPI

pip install coveralls

uv add coveralls

poetry add coveralls

Installing coveralls

Before you install

Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release and no known vulnerabilities.

License in practice

MIT license permits unrestricted use, modification, and distribution in both open and closed projects with minimal attribution requirements.

Quickstart

pip install coveralls
coverage run --source=mypkg -m pytest tests/
coveralls

Requires Python 3.10 or later; requires coverage.py to be installed and a coverage data file to exist.

Verify before relying

• Whether the package works with all CI/CD platforms or has platform-specific limitations.
• Whether authentication tokens or environment variables are required for coveralls.io integration.

Package facts

Evidence: coveralls-4.1.0-py3-none-any.whl

Tags

More Testing packages