Metadata-Version: 2.1
Name: coverage-rich
Version: 0.1.0
Summary: A rich terminal report for coveragepy.
Project-URL: Documentation, https://github.com/waylonwalker/coverage-rich#readme
Project-URL: Issues, https://github.com/waylonwalker/coverage-rich/issues
Project-URL: Source, https://github.com/waylonwalker/coverage-rich
Project-URL: Changelog, https://github.com/waylonwalker/coverage-rich
Author-email: "Waylon S. Walker" <waylon@waylonwalker.com>
License-Expression: MIT
License-File: LICENSE.txt
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.7
Requires-Dist: anyconfig
Requires-Dist: coverage
Requires-Dist: rich
Requires-Dist: textual
Requires-Dist: typer
Description-Content-Type: text/markdown

# coverage-rich

[![PyPI - Version](https://img.shields.io/pypi/v/coverage-rich.svg)](https://pypi.org/project/coverage-rich)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/coverage-rich.svg)](https://pypi.org/project/coverage-rich)

-----


## Installation

```console
pip install coverage-rich
```
## Usage

``` bash
coverage run -m pytest
coverage-rich report
```

## configuration

`coverage-rich` will send a failure code if there is insufficient total coverage, this is configurable by setting the `fail-under` value.

**pyproject.toml**

``` toml
[tool.coverage_rich]
fail-under=0 # default 80
```
**.coverage_rich**, **coverage_rich.ini**
``` ini
[coverage_rich]
fail-under = 1
```

**setup.cfg**
``` cfg
[tool.coverage_rich]
fail-under = 22
```


## Examples

`coverage-rich` (left) compared to `coverage report -m` (right)

<img src='https://user-images.githubusercontent.com/22648375/218324200-d6b8078b-8f24-4163-9c02-8f6d695d4d4a.png' align='left' width='45%'>
<img src='https://user-images.githubusercontent.com/22648375/218324226-ece0b3d6-e1a9-4644-b8d1-d3adf4568cf0.png' align='right' width='45%'>
<br clear="both"/>

<img src='https://user-images.githubusercontent.com/22648375/218325189-daf0381b-8ddc-482e-8bb4-7642cade9a52.png' align='left' width='45%'>
<img src='https://user-images.githubusercontent.com/22648375/218325218-3ba5c899-f2d8-4b2d-9cb5-93fabe7511cd.png' align='right' width='45%'>
<br clear="both"/>

## License

`coverage-rich` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.
