PHPackages                             umbrellio/coverspector - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Testing & Quality](/categories/testing)
4. /
5. umbrellio/coverspector

ActiveLibrary[Testing & Quality](/categories/testing)

umbrellio/coverspector
======================

This package helps to check that code coverage above minimum value. It can be useful in CI or git hooks.

1.4.0(5y ago)420.1k↑28.6%MITPHPPHP ^7.2|^7.3|^7.4|^8.0CI failing

Since Nov 19Pushed 5y ago2 watchersCompare

[ Source](https://github.com/umbrellio/coverspector)[ Packagist](https://packagist.org/packages/umbrellio/coverspector)[ RSS](/packages/umbrellio-coverspector/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (3)Versions (6)Used By (0)

Coverspector
============

[](#coverspector)

[![Github Status](https://github.com/umbrellio/coverspector/workflows/CI/badge.svg)](https://github.com/umbrellio/coverspector/actions)[![Coverage Status](https://camo.githubusercontent.com/d4db39e04020b1a9e549ecc7e411c9323e6417f158e23ec4725b4386e4641d92/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f756d6272656c6c696f2f636f76657273706563746f722f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/umbrellio/coverspector?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/261fd50ca91ebc30047096ac8fa23c81c4df3812ad3472e27f9bb4d39e74c60e/68747470733a2f2f706f7365722e707567782e6f72672f756d6272656c6c696f2f636f76657273706563746f722f762f737461626c652e706e67)](https://packagist.org/packages/umbrellio/coverspector)[![Total Downloads](https://camo.githubusercontent.com/54c4889c62dded0a2418edb0e8760ccc41f8bf0a941de063f37970031b5ba7d8/68747470733a2f2f706f7365722e707567782e6f72672f756d6272656c6c696f2f636f76657273706563746f722f646f776e6c6f6164732e706e67)](https://packagist.org/packages/umbrellio/coverspector)[![Code Intelligence Status](https://camo.githubusercontent.com/da157c2d8dd400a436c5799740cee3aa91ef2445551b344af93e12db8a4fbffb/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f756d6272656c6c696f2f636f76657273706563746f722f6261646765732f636f64652d696e74656c6c6967656e63652e7376673f623d6d6173746572)](https://scrutinizer-ci.com/code-intelligence)[![Build Status](https://camo.githubusercontent.com/15fc6bfb0f9e61596e7fe17abc2f7e1b537a7f1dcccf6e3f2500a9b6d0f81564/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f756d6272656c6c696f2f636f76657273706563746f722f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/umbrellio/coverspector/build-status/master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/eee1e9f735342f85cdabbd9463139de5174eeec26799ce428c83a073a7a2afab/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f756d6272656c6c696f2f636f76657273706563746f722f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/umbrellio/coverspector/?branch=master)

This package helps to check that code coverage above minimum value. It can be useful in CI or git hooks.

Features
--------

[](#features)

- Fail CI/hook when code coverage is less than minimal value.
- Print list of uncovered files

Installation
------------

[](#installation)

Run this command to install:

```
composer require umbrellio/coverspector
```

Usage
-----

[](#usage)

Allow coverage toll to print info about uncovered files. In case of phpunit, add to phpunit config:

```
addUncoveredFilesFromWhitelist="true"

```

In case of codeception:

```
show_uncovered: true
```

In your CI, dump coverage output into file

```
vendor/bin/codecept run --coverage | tee coverage.txt
```

Than, run coverspector with minimum code coverage value

```
vendor/bin/coverspector --file=coverage.txt --min=100
```

If coverage will be less, coverspector will fail the job and print list of all not totaly covered files

CI Coverage Artifacts
---------------------

[](#ci-coverage-artifacts)

If you still want to save coverage report as CI artifact - you should set

```
when: on_failure

```

in your CI config.

License
-------

[](#license)

Released under MIT License.

Authors
-------

[](#authors)

Created by Makin Vladislav.

Contributing
------------

[](#contributing)

- Fork it (  )
- Create your feature branch (`git checkout -b feature/my-new-feature`)
- Commit your changes (`git commit -am 'Add some feature'`)
- Push to the branch (`git push origin feature/my-new-feature`)
- Create new Pull Request

[![Supported by Umbrellio](https://camo.githubusercontent.com/cfae343fcdcb3e8680353f5f058271ed6a749151ae073ae4d9e083e5e1aeb045/68747470733a2f2f756d6272656c6c696f2e6769746875622e696f2f556d6272656c6c696f2f737570706f727465645f62795f756d6272656c6c696f2e737667)](https://github.com/umbrellio/)

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity29

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 57.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~99 days

Total

5

Last Release

1973d ago

PHP version history (2 changes)1.0.1PHP ^7.2

1.2.0PHP ^7.2|^7.3|^7.4|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/6340215fdb74dfd5111c4de41bc9a03cb41980ad8b783baa4a10081dce37c9fa?d=identicon)[Zlob](/maintainers/Zlob)

![](https://www.gravatar.com/avatar/023972c6d4f6faeb92150036503d5cbcf7b01217869ad8ea29a07b677c075807?d=identicon)[umbrellio](/maintainers/umbrellio)

![](https://avatars.githubusercontent.com/u/16900171?v=4)[Corben Dallas](/maintainers/pvsaintpe)[@pvsaintpe](https://github.com/pvsaintpe)

---

Top Contributors

[![pvsaintpe](https://avatars.githubusercontent.com/u/16900171?v=4)](https://github.com/pvsaintpe "pvsaintpe (4 commits)")[![Zlob](https://avatars.githubusercontent.com/u/3818931?v=4)](https://github.com/Zlob "Zlob (3 commits)")

---

Tags

phpphpunitcoveragecloverchecker

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/umbrellio-coverspector/health.svg)

```
[![Health](https://phpackages.com/badges/umbrellio-coverspector/health.svg)](https://phpackages.com/packages/umbrellio-coverspector)
```

###  Alternatives

[df/php-coverfish

lightweight static code analysis tool for class coverage check of PHPUnit's CodeCoverage

234.9k1](/packages/df-php-coverfish)[robiningelbrecht/phpunit-coverage-tools

PHPUnit coverage tools

1783.0k34](/packages/robiningelbrecht-phpunit-coverage-tools)[phrozenbyte/phpunit-array-asserts

Provides various array-related PHPUnit assertions, primarily used for API testing.

1055.0k1](/packages/phrozenbyte-phpunit-array-asserts)[cable8mm/water-melon

Water Melon is simple melon.com api sdk for php

182.7k](/packages/cable8mm-water-melon)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)