coveradge

Generate coverage badges during local nyc/istanbul execution

Usage no npm install needed!

<script type="module">
  import coveradge from 'https://cdn.skypack.dev/coveradge';
</script>

README

npm Dependencies devDependencies

testing badge coverage badge

Known Vulnerabilities Total Alerts Code Quality: Javascript

Licenses badge

(see also licenses for dev. deps.)

issuehunt-to-marktext

coveradge

Installation

If you need png export, run:

npm i -D coveradge convert-svg-to-png

Otherwise, just this:

npm i -D coveradge

Usage

  1. Ensure you have at least the following reporter in your package.json:
{
  "nyc": {
    "reporter": [
      "json-summary"
    ]
  }
}

You may optionally set coverage thresholds and/or watermarks:

{
  "nyc": {
    "reporter": [
      "json-summary"
    ],
    "branches": 80,
    "lines": 80,
    "functions": 80,
    "statements": 80,
    "watermarks": {
      "lines": [80, 95],
      "functions": [80, 95],
      "branches": [80, 95],
      "statements": [80, 95]
    }
  }
}

The watermarks, if present, will be given precedence over the regular thresholds for determining color (though not as high of a precedence as command-line thresholds).

  1. Add --reporter coveradge at the beginning of the nyc call. Alternatively, e.g., if you need to build a coveradge badge after testing has already finished for a merged coverage file, add a call to coveradge in your package.json scripts at some point after running nyc.

  2. Add any desired options. If using as an nyc --reporter, then add the options to package.json instead of a coveradgeOptions property. Otherwise, pass as CLI or programmatic options. (See below for the choices.)

  3. Add the badge to your README (e.g., [![coverage badge](coverage-badge.svg)](coverage-badge.svg)) or for a link that will also work on npmjs.com: [![coverage badge](https://raw.githubusercontent.com/brettz9/coveradge/master/coverage-badge.svg?sanitize=true)](coverage-badge.svg)

That's it!

Options

CLI instructions

See also

  • eslint-formatter-badger - Locally created badges indicating linting results (as run against your project and/or your dependencies)
  • filesize-badger - Locally created badges indicating file size (also buildable as part of Rollup routine)
  • mocha-badge-generator - Locally created badges for Mocha test results
  • license-badger - Locally-created badges indicating license types (by degree of permissiveness) used within or required by the project.