Coverage-badge-creator NPM

About The Project

Coverage Badge Creator is a super easy to use tool for your project. It creates badges based on your test coverage and inserts them into the README. All without any third-party libraries or tools.

Installation

npm:

npm install --save-dev coverage-badge-creator

yarn:

yarn add --dev coverage-badge-creator

Usage

First you need to set up your test environment.
- jest
  In jest config you need to add 'json-summary' to coverageReporters. https://jestjs.io/docs/en/configuration
- mocha
```
{
  "test": "nyc --reporter=json-summary mocha"
}
```
Insert one of the following keys anywhere in your README. These will be replaced by the coverage-badge-creator with the appropriate badge.
The following keys are available:
- $coverage$
- $statements$
- $branches$
- $functions$
- $lines$
important are also the surrounding dollar signs
Now you can create the badges.
Add the command to your package.json scripts block:
```
"scripts": {
  "coverage:badge": "coverage-badge-creator",
}   
```
and run it from the CLI:
```
npm run coverage:badge
```

Config

There are various ways to configure the badges according to your wishes. To do this, you only need to create a new file called .badge-config. Then you have the following options:

For a simple example click here.

coverage file path

{
  coverage_file_path: './coverage/json-summary.json'
}

badges

 {
   badges: {
     coverage: {
      logo: 'foo'
      color: 'bar'
     }
   }
 }

Depending on your test tool, you will probably have the following badges available for configuration:

coverage
statements
branches
functions
lines
Options
style
logo
logoColor
color
link

For more information on all options, see ->

Extended

In addition, you have further options in the cli.

--config

This allows you to change the path and name of the configuration file.

"scripts": {
  "coverage:badge": "coverage-badge-creator --config './badge-coverage-config.json'",
}

Requirements

Node > v10.0.0

Built With

This section lists all programming languages and main frameworks.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.